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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • 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. パラメーター
    名前 タイプ 説明
    start GlideDateTime 最初のデータポイントのタイムスタンプ。それ以降のタイムスタンプは、保持ポリシーの収集期間を使用して計算されます。
    value アレイ 数値の配列。
    表 : 3. 返される内容
    タイプ 説明
    データビルダー 同じ 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, 数値)

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

    表 : 4. パラメーター
    名前 タイプ 説明
    start GlideDateTime データポイントのタイムスタンプ。
    value 数値 データポイントの値。
    表 : 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);