Docs » その他のデータ取り込み方法 » Splunk Observability Cloud REST API を使用してメトリクス、トレース、イベントを送信する

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

リターンコード

説明

トレース、メトリクス、イベントの送信

200

データの取り込みに成功しました。

トレース、メトリクス、イベントの送信

400

不正なリクエストです。
これは、JSONが整形式でない場合、メトリクスタイプ配列の1つ以外でデータポイントを指定した場合、またはデータポイントのメトリクス名を指定し忘れた場合に発生する可能性があります。

トレース、メトリクス、イベントの送信

401

認証されていません。
リクエストのX-SF-TOKENヘッダーで指定されたインジェストトークンは、組織にデータポイントを送信する権限を持っていません。

This page was last updated on 2023年07月24日.