DataBuilder - スコープ対象、グローバル

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

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

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

DataBuilder - DataBuilder(オブジェクト glideRecord, 文字列 subject, 文字列 metric)

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

表 : 1. パラメーター

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

次の例では、現在の時刻または特定の時間範囲を表す 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 オブジェクトに追加します。各データポイントはタイムスタンプと値です。

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

表 : 2. パラメーター

名前	タイプ	説明
左寄せ	GlideDateTime	最初のデータポイントのタイムスタンプ。それ以降のタイムスタンプは、保持ポリシーの収集期間を使用して計算されます。
値	アレイ	数値の配列。

表 : 3. 戻り値

タイプ	説明
データビルダー	同じ DataBuilder オブジェクト。

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

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

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, 数値)

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

表 : 4. パラメーター

名前	タイプ	説明
左寄せ	GlideDateTime	データポイントのタイムスタンプ。
値	番号	データポイントの値。

表 : 5. 戻り値

タイプ	説明
データビルダー	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);