ヘルプ データレイク監視 カスタムソース監視

データレイク カスタムソース監視

データレイク監視のカスタムソース機能で、APIやSDKを使用してアプリケーションからデータをプッシュできます。これにより様々な環境に合わせたメトリック収集を実現できます。

目次

設定方法

カスタムソースを使用してデータをプッシュする方法は次の通りです。

  1. カスタムソース項目にある［今すぐ連携］をクリックします。
  2. データレイク監視の追加ページで、次の情報を入力します。
    • データレイク名：監視の表示名を入力します。
    • 監視グループと関連付け：ドロップダウンから監視グループを選択し、その監視グループに作成する監視を関連付けます。
      監視グループの作成方法の詳細はこちらのページをご確認ください。
    • 含めるタグ：SDK/API経由でプッシュするデータをフィルターします。
      • すべてのタグ：すべてのデータをプッシュします。
      • で始まる：指定した文字で始まるデータをプッシュします。
      • 含む：指定したキーワードを含むデータをプッシュします。
      • で終わる：指定した文字で終わるデータをプッシュします。
  3. ［保存］をクリックします。
Add data lake monitor screen

作成した監視にデータをインポート

SDKまたはAPI経由でデータをプッシュできます。

SDK経由でデータプッシュ

このオプションを使用して生データ（未集約データ）を送信し、Site24x7で集約を行います。

手順1：アプリケーションへのSDKの追加と設定

ロギングのため、アプリケーション内に「SLF4J」jarファイルが必要です。追加されていない場合は、追加してください。

  1. Maven Central Repositoryに移動します。
  2. ビルドフレームワークに基づいてアプリケーションにコンパイル依存関係（Compile Dependencies）追加します。
    SDK jarファイルをダウンロードし、アプリケーションに追加します。

手順2：SDK MetricProviderのオブジェクト作成

「MetricProviderBuilder」クラスを使用してSite24x7エクスポーターをもつ「MetricProvider」を作成します。このオブジェクトを使用してメトリックデータをプッシュします。

シングルアプリケーションの場合、単一のライセンスキーが適用されます。同一アプリケーション内で新規オブジェクトが作成されても、最初のライセンスキーが使用され続けます。

// Create Metric provider using the following code snippet
MetricProvider provider = new MetricProvider("");
DataLakeProvider dataLake = provider.createDataLake(""); // The app key associated with the Data-lake monitor.
DataLakeResource resource = dataLake.createResource(new HashMap(){{
put("host", "192.168.10.254");
}});// Set of tags to associate with a list of metrics created using the appkey resource

// Push data using different methods like Count, Rate, Gauge, Histogram.
resource.gauge(
"ResponseTime", // The metric name (field name)
180, // The numerical value of the metric
"ms",// Unit of the metric (Default unit will be Count)
new HashMap(){{
	put("host", "192.168.10.254");
}}); // Set of tags to be associated with the metric


手順3：生データをSDKに送信

メソッドを指定し、設定した項目の値を集約します。

Count

metricProvider.count(
    "<app key>", // The app key associated with the Data-lake monitor
    "db_write", // The metric name (field name)
    2.0, // Numerical value of the metric
    Collections.singletonMap("host", "192.168.10.254") // Set of tags to associate with the metric
);

Rate

metricProvider.rate(
 "<app key>", 
 "disk_free",
  16868264.0,
  Collections.singletonMap("host", "192.168.10.254")
);

Gauge

metricProvider.gauge(
 "<app key>", 
 "disk_free",
  16868264.0,
  Collections.singletonMap("host", "192.168.10.254")
);

Histogram

metricProvider.histogram(
 "<app key>", 
 "disk_free",
  16868264.0,
  Collections.singletonMap("host", "192.168.10.254")
);

補足事項は次の通りです。

  • <app_key> はPost URL表示オプションから取得できます。
  • disk_free は数値項目です。
  • Collections.singletonMap ("host", "192.168.10.254") は文字列の任意項目です。
  • デフォルトの値の単位は次の通りです。
    • Time：ミリ秒
    • Size：バイト
    • Count：数

APIを経由したデータプッシュ

このオプションを使用して、集約データをプッシュします。

  1. データレイク監視に移動します。
  2. 表示名横のハンバーガーアイコンにマウスポインタを合わせます。
  3. ［Post URL表示］を選択します。
    Push data via API
  4. その後の画面で次の手順を実施します。
    サンプルペイロード：
    [
   {
      "metrics":[
         {
            "unit":"ms",
            "datavalues":[
               {
                  "p0":0,
                  "p99":16,
                  "p100":17,
                  "time_stamp":"1739341985265",
                  "count":10,
                  "p50":12,
                  "value":100,
                  "p95":15,
                  "tags":{
                     "metric_tag_2":"metricTag2Data",
                     "metric_tag_1":"metricTag1Data"
                  }
               }
            ],
            "name":"MetricName",
            "type":"rate",
            "description ":"Sample Description"
         }
      ],
      "tags":{
         "group_tag_1":"groupTag1data",
         "group_tag_2":"groupTag2data"
      }
   }
]

    補足事項は次の通りです。

    • 値：処理するメトリック値です。
    • 数：値の計算に使用された間隔ごとのメトリック数です。指定されていない場合、デフォルトの1が指定されます。

サポートしている単位

タイプ サポートしている単位 基本単位
サイズ バイト、KB、MB、GB、TB バイト
時間 マイクロ秒、ミリ秒、秒、分、時間、日 ミリ秒
数 一、千、十万、百万、十億、兆 一
  • 異なる単位（例：GB、分、兆）で値を送信しても、それらは自動的に基本単位に変換されます。
  • 上記以外の対応していない単位を送信した場合、それらは自動的に数として認識され表示されます。

関連ガイド

データレイク監視の追加

REST APIメトリック監視の追加

データレイクのパフォーマンスメトリック

データレイクダッシュボード

カスタム属性監視の追加