DataBuilder - スコープ付き、グローバル

DataBuilder API は、メトリクスの一連のデータポイントを作成するためのメソッドを提供します。sn_clotho.Client.put() メソッドを使用して値を保存してください。

このクラスは、スコープ付きサーバースクリプトおよびグローバルサーバースクリプトで呼び出すことができます。DataBuilder クラスを使用する場合は、sn_clotho名前空間識別子を使用します。

このクラスは、メトリックベース アプリケーションの一部です。

DataBuilder - DataBuilder(オブジェクト glideRecord, 文字列件名, 文字列メトリクス)

DataBuilder クラスのインスタンスを作成します。

表 : 1. パラメーター

名前	タイプ	説明
glideRecord	オブジェクト	ドメインを取得する GlideRecord
件名	文字列	この系列に関連付けられた GlideRecordのsys_id
metric	文字列	メトリックのフィールド名

次の例では、現在の時刻または特定の時間範囲を表す now_GR パラメータと、追跡対象のメトリクスの名前である文字列パラメータ「cpu_percentage」を使用して、sn_clotho 名前空間から DataBuilder の新しいインスタンスを初期化します。

// Where cpu_percentage is the name of the metric
        var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');

DataBuilder - add(GlideDateTime start, Array value)

一連のデータポイントを DataBuilder オブジェクトに追加します。各データポイントはタイムスタンプと値です。

start パラメーターと保持ポリシーの収集期間を使用して、アレイ内の各値のタイムスタンプを計算します。最初の値には、タイムスタンプとしての開始パラメーターがあります。このメソッドは、MetricBase データベースにデータを保存しません。sn_clotho.Client.put() メソッドを使用して値を保存してください。

表 : 2. パラメーター

名前	タイプ	説明
start	GlideDateTime	最初のデータポイントのタイムスタンプ。後続のタイムスタンプは、保持ポリシー収集期間を使用して計算されます。
value	アレイ	数値のアレイ

表 : 3. 返される内容

タイプ	説明
DataBuilder	同じ DataBuilder オブジェクトです。

次の例では、最初に、特定のタイムスタンプでの CPU 使用率に関連するさまざまなデータ ポイントを表す 7、0.5、273 の 3 つの数値を含む配列 (ポイント) を初期化します。次に、コードは新しいsn_clothoを初期化します 。now_GR を使用する DataBuilder オブジェクト (GlideRecord オブジェクト) は、このデータが格納されているターゲットデータベースレコードを表します。 「cpu_percentage」 は、CPU 使用率を追跡するために使用されるメトリクス名です。

オブジェクトを現在の日付と時刻に設定する GlideDateTime を使用して、新しい時間変数が作成されます。最後に、コードは dataBuilder.add(time, points) を使用して、データビルダーオブジェクトに複数のデータポイントを格納します。

var points = [7,0.5,273];
var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
// this creates a GlideDateTime object set to the current date and time
var time = new GlideDateTime();
dataBuilder.add(time, points);

DataBuilder - add(GlideDateTime start, Number value)

DataBuilder オブジェクトにデータポイントを追加します。各データポイントはタイムスタンプと値です。このメソッドは、メトリックにデータポイントを保存しません。sn_clotho.Client.put() メソッドを使用して値を保存してください。

表 : 4. パラメーター

名前	タイプ	説明
start	GlideDateTime	データポイントのタイムスタンプ
value	番号	データポイントの値

表 : 5. 返される内容

タイプ	説明
DataBuilder	DataBuilder オブジェクト

次の例では、まず、パラメーター now_GR (ターゲットレコード) と 'cpu_percentage' (追跡するメトリクス) を使用して、sn_clotho名前空間から DataBuilder の新しいインスタンスを初期化します。GlideDateTime は、時間を現在の日時に初期化します。最後に、 dataBuilder.add() は、現在のタイムスタンプで値 0.6 (CPU 使用率が 60% の値を表す) を格納します。

var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
// this creates a GlideDateTime object set to the current date and time
var time = new GlideDateTime();
dataBuilder.add(time, 0.6);