Get histogram data into Splunk Observability Cloud 🔗
Prometheus レシーバーを含むさまざまなレシーバーを使用してヒストグラムデータを収集し、OpenTelemetry Collector を使用して Splunk Observability Cloud に送信することができます。Prometheus レシーバー を参照してください。
OpenTelemetry Collector の Splunk ディストリビューションは、明示的バケットのヒストグラムメトリクスをサポートしています。ヒストグラムメトリクスを送信するには、OTLP エクスポーターを使用するか、バージョン0.98以降では SignalFx エクスポーター を使用します。
ヒストグラムデータをSplunk Observability Cloudに送信するには、send_otlp_histograms オプションを true に設定します。例：
exporters:
signalfx:
access_token: "${SPLUNK_ACCESS_TOKEN}"
api_url: "${SPLUNK_API_URL}"
ingest_url: "${SPLUNK_INGEST_URL}"
sync_host_metadata: true
correlation:
send_otlp_histograms: true
Prometheus レシーバー などのさまざまなレシーバーを使用してヒストグラムデータを収集できます。
バケットヒストグラムデータを送信する際のベストプラクティス 🔗
Splunk Observability Cloud にバケットヒストグラムデータを送信する場合は、以下のベストプラクティスに従ってください：
累積データを送信する場合を除き、最小値と最大値を送信します。最小値は最大値より小さくなければならず、そうでない場合は、データポイントは削除されます。
カスタムヒストグラムを送信するときは、31個未満のバケットを使用してください。31個以上のバケットを持つヒストグラムはドロップされます。
バケットの境界線が重複したり、繰り返したりしないようにします。バケットの境界線を送信するときは、順番に並べます。
値を符号付き整数、浮動小数点数、10進数または固定小数点数表記の数値文字列として送信します。Splunk Observability Cloud はそれらを64ビット整数として保存します。
すべてのヒストグラムのバケットの合計が
countフィールドに等しいこと、およびバケットの境界のサイズがバケットカウントから1を引いたものに等しいことを確認します。これらの基準に従わないヒストグラムはドロップされます。Prometheus などから累積データを送信する場合は、デルタ集計の一時性を使用します。デルタ集計の設定方法については、デルタ集計の一時性に関する考慮事項 を参照してください。
デルタ集計の一時性に関する考慮事項 🔗
デルタ集計の一時性は、Splunk Observability Cloud のヒストグラムデータの正確性を保証します。たとえば、デルタ集約が有効でない場合、累積ヒストグラムには最小値と最大値がありません。これにより、P90パーセンタイルが観測された最大値より上になる可能性があります。
デルタ集計の一時性をインストルメンテーションで有効にするには、 環境変数 OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE を delta に設定します。お使いの言語のSDKサポートを確認するには、OpenTelemetry Specification リポジトリの コンプライアンスマトリックス を参照してください。
APIを使用してヒストグラムデータを送信する 🔗
OpenTelemetry Collector をバイパスする必要がある場合は、インジェスト API の /v2/datapoint/otlp エンドポイントを使用して、ヒストグラムデータを Splunk Observability Cloud に直接送信します。このエンドポイントは、Protobuf としてシリアライズされた OTLP 形式のデータを受け入れます。
To learn how to send histogram metric data using the API, see /datapoint/otlp in the Splunk Developer Portal.
ダッシュボード、関数、チャート、ディテクターの移行 🔗
既存のダッシュボード、関数、チャート、ディテクターをヒストグラムに移行するには、以下の手順に従います：
Splunk Distribution of OpenTelemetry Collector バージョン 0.98 以上を使用してヒストグラムデータを送信していることを確認してください。それ以下のバージョンでは、SignalFx エクスポーターを使用して OTLP 形式のヒストグラムデータを送信できません。
OTLP エクスポーターまたは SignalFx エクスポーターでヒストグラムメトリクスの送信を開始します。Collector でこの機能を有効にする方法の詳細は、Send histogram metrics in OTLP format を参照してください。
新しい
histogram()関数を使用するようにチャートを編集します。SignalFlow リファレンスドキュメントの histogram() を参照してください。
Troubleshooting 🔗
Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloud内のデータを確認できない場合は、以下の方法でサポートを受けることができます。
Available to Splunk Observability Cloud customers
Splunk サポートポータル でケースを送信する
Splunkサポート に連絡する
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループのSlackチャンネルに参加して、世界中の顧客、パートナー、Splunk社員とのコミュニケーションを図ります。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。