OTLP/HTTP エクスポーター 🔗

注釈

Splunk Observability Cloudにトレースを送信するデフォルトの方法として、OTLP/HTTP エクスポーターを使用します。

OTLP/HTTP エクスポーターは、OTLP フォーマットを使用して、メトリクス、トレース、およびログを HTTP 経由で送信します。サポートされているパイプラインタイプは、traces、metrics、および logs です。詳細については、パイプラインでデータを処理するを参照してください。

また、gRPCプロトコルを使用してデータを送信する高度なオプションにOTLPエクスポーターを使用することもできます。詳細は OTLPエクスポーターを参照してください。

OTLPフォーマットについての詳細は、OTel repo OpenTelemetry Protocol Specification を参照してください。

はじめに 🔗

注釈

このコンポーネントは、Splunk Distribution of the OpenTelemetry Collectorのデフォルト構成に含まれており、ホスト監視（エージェント）モードでのデプロイの場合にSplunk Observability Cloud にトレースを送信します。詳細は Collector のデプロイモードを参照してください。

デフォルト設定の詳細については、Helmで Collector for Kubernetes を設定する、Collector for Linux のデフォルト設定、または Collector for Windows のデフォルト設定を参照してください。この文書で説明されているように、いつでも設定をカスタマイズすることができます。

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

インストーラ・スクリプトを使用して Collector for Windows をインストールします。

Helmを使用してCollector for Kubernetesをインストールする

次のセクションで説明するようにエクスポーターを設定します。
Collector を再起動します。

設定オプション 🔗

以下の設定が必要です：

traces_endpoint。トレースデータの送信先URL。Splunk Observability Cloudの場合は、https://ingest.<realm>.signalfx.com/v2/trace/otlp です。

以下の設定は任意であり、より高度なユースケースの場合に構成に追加することができます：

logs_endpoint。ログデータの送信先URL。例： https://example.com:4318/v1/logs。
metrics_endpoint。メトリクスデータの送信先URL。たとえば、Splunk Observability Cloud にメトリクスを送信する場合は、"https://ingest.us0.signalfx.com/v2/trace/otlp" です。
tls。利用可能なオプションの全セットについては、当ドキュメントの TLS構成設定を参照してください。カスタムエンドポイントにデータを送信する場合にのみ適用できます。
timeout。デフォルトでは 30s です。HTTPリクエストの時間制限。詳細は https://golang.org/pkg/net/http/#Client を参照してください。
read_buffer_size。デフォルトでは 0 です。HTTPクライアントのReadBufferSize。
write_buffer_size。デフォルトでは 512 * 1024 です。HTTPクライアントのWriteBufferSize。

サンプル構成 🔗

OTLP over HTTP を使用してトレースとメトリクスを Splunk Observability Cloud に送信するには、REST API インジェスト・エンドポイントに metrics_endpoint と traces_endpoint の設定を行います。例：

exporters:
  otlphttp:
    # The target URL to send trace data to. By default it's set to ``https://ingest.${SPLUNK_REALM}.signalfx.com/v2/trace/otlp``.
    traces_endpoint: https://ingest.<realm>.signalfx.com/v2/trace/otlp
    # Set of HTTP headers added to every request.
    headers:
      # X-SF-Token is the authentication token provided by Splunk Observability Cloud.
      X-SF-Token: <access_token>

構成を完了するには、構成ファイルの service セクションの必要なパイプラインにエクスポーターを含めます。例：

service:
  pipelines:
    metrics:
      exporters: [otlphttp]
    traces:
      exporters: [otlphttp]

設定例 🔗

これは詳細な設定例です：

endpoint: "https://1.2.3.4:1234"
traces_endpoint: https://ingest.us0.signalfx.com/v2/trace/otlp
metrics_endpoint: https://ingest.us0.signalfx.com/v2/datapoint/otlp
headers:
  X-SF-Token: <access_token>
timeout: 10s
read_buffer_size: 123
write_buffer_size: 345
sending_queue:
  enabled: true
  num_consumers: 2
  queue_size: 10
retry_on_failure:
  enabled: true
  initial_interval: 10s
  randomization_factor: 0.7
  multiplier: 1.3
  max_interval: 60s
  max_elapsed_time: 10m
compression: gzip

gzip圧縮を設定する 🔗

デフォルトでは、gzip圧縮はオンになっています。オフにするには、以下の設定を使用します：

exporters:
  otlphttp:
    ...
    compression: none

Associate passthroughs to an access token 🔗

The setting access_token_passthrough from the Splunk APM (SAPM)エクスポーター（非推奨） in no longer available.

To associate datapoints with an organization access token, make sure of the following:

include_metadata is set to true in your otlp configuration
metadata_keys is set to the org token in the バッチプロセッサー

例：

extensions:
  headers_setter:
    headers:
      - action: upsert
        key: X-SF-TOKEN
        from_context: X-SF-TOKEN

receivers:
  otlp:
    protocols:
      http:
        include_metadata: true

processors:
  batch:
    metadata_keys:
    - X-SF-Token

exporters:
  otlphttp:
    metrics_endpoint: https://ingest.lab0.signalfx.com/v2/datapoint/otlp
    traces_endpoint: https://ingest.lab0.signalfx.com/v2/trace/otlp
    headers:
        "X-SF-Token": "mytoken"
    auth:
      authenticator: headers_setter

設定 🔗

次の表に、OTLP/HTTPエクスポーターの設定オプションを示します：

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Splunkサポートに連絡する

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年04月01日に最終更新されました。

Related Topics