Splunk Observability Cloud REST API を使用してメトリクス、トレース、イベントを送信する 🔗
REST API を使用して、テレメトリを Splunk Observability Cloud に直接送信できます。開発者向けドキュメントの データポイントの送信 および トレース、メトリクス、イベントの送信 を参照してください。
APIを使用してデータ送信を開始する 🔗
以下の`curl` コマンドを使ってデータを送信して実験を開始します:
curl --request POST \
--header "Content-Type: application/json" \
--header "X-SF-TOKEN: <ORG_TOKEN>" \
--data \
'{
"gauge": [
{
"metric": "memory.free",
"dimensions": { "host": "server1" },
"value": 42
}
]
}' \
https://ingest.<REALM>.signalfx.com/v2/datapoint
APIを使用してカスタムメトリクスを送信する 🔗
カスタムメトリクスを送信するには、例として提供されているコード・ブロックで、<ORG_TOKEN>
を組織の org トークンに置き換えてください。
Splunk Observability Cloud UI では、org トークンはアクセストークンと呼ばれます。org トークンの取得方法については、Splunk Observability Cloudを使用した組織のアクセストークンの作成および管理 を参照してください。
リクエストを送るときは、レルム固有のエンドポイントを使用してください。<REALM>
をレルムの名前に置き換えてください。レルムの名前はユーザーインターフェイスのプロフィールページで見つけることができます。詳しくは、エンドポイントのレルム を参照してください。
コードを返す 🔗
REST APIは以下のコードを返します:
API |
リターンコード |
説明 |
---|---|---|
|
データの取り込みに成功しました。 |
|
|
不正なリクエストです。
これは、JSONが整形式でない場合、メトリクスタイプ配列の1つ以外でデータポイントを指定した場合、またはデータポイントのメトリクス名を指定し忘れた場合に発生する可能性があります。
|
|
|
認証されていません。
リクエストのX-SF-TOKENヘッダーで指定されたインジェストトークンは、組織にデータポイントを送信する権限を持っていません。
|