Splunk Observability Cloud REST API を使用してメトリクス、トレース、イベントを送信する

REST API を使用して、データポイントを Splunk Observability Cloud に送信します。

REST API を使用して、テレメトリを Splunk Observability Cloud に直接送信できます。デベロッパー向けドキュメントの「Send data points」および「Send traces, metrics, and events」を参照してください。

APIを使用してデータ送信を開始する

コマンドに適用されます。

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 トークンの取得方法については、「Create and manage organization access tokens using Splunk Observability Cloud」を参照してください。

リクエストを送信するときは、レルムに固有のエンドポイントを使用します。<REALM> を、ユーザーインターフェイスのプロファイルページにあるレルム名に置き換えます。詳細については、「Realms in endpoints」を参照してください。

コードを返す

REST APIは以下のコードを返します：


API	リターンコード	説明
トレース、メトリクス、イベントの送信	`200`	データの取り込みに成功しました。
トレース、メトリクス、イベントの送信	`400`	不正なリクエストです。これは、JSONが整形式でない場合、メトリクスタイプ配列の1つ以外でデータポイントを指定した場合、またはデータポイントのメトリクス名を指定し忘れた場合に発生する可能性があります。
トレース、メトリクス、イベントの送信	`401`	認証されていません。リクエストの X-SF-TOKEN ヘッダーで指定されたインジェストトークンは、組織にデータポイントを送信する権限を持っていません。