Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector コンポーネント » Collectorコンポーネント: エクスポーター » OTLP/HTTP エクスポーター

OTLP/HTTP エクスポーター 🔗

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

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

Collector をバイパスして OTLP 形式のデータを直接 Splunk Observability Cloud に送信する必要がある場合:

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

はじめに 🔗

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

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

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

  2. Collector を再起動します。

Splunk Distribution of the OpenTelemetry Collector のデフォルト設定には、OTLP/HTTP エクスポーターは含まれていません。追加したい場合は、以下の設定が必要です:

  • endpoint。データを送信する対象のベースURL、例えば https://example.com:4318 。デフォルト値はありません。

    • シグナルの各タイプは、このベースURLに追加されます。例えば、トレースの場合、https://example.com:4318/v1/traces です。

以下の設定はオプションです:

  • logs_endpoint。ログデータの送信先URL。

    • 例えば、https://example.com:4318/v1/logs

    • この設定がある場合、エンドポイント設定はログに対して無視されます。

  • metrics_endpoint。メトリクスデータの送信先URL。

    • 例えば、https://example.com:4318/v1/metrics

    • この設定がある場合、メトリクスのエンドポイント設定は無視されます。

  • traces_endpoint。トレースデータの送信先URL。

    • 例えば、https://example.com:4318/v1/traces

    • この設定がある場合、トレースではエンドポイントの設定は無視されます。

  • 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_endpointtraces_endpoint の設定を行います。例:

exporters:
  otlphttp:
     metrics_endpoint: "https://ingest.${SPLUNK_REALM}.signalfx.com/v2/datapoint/otlp"
     traces_endpoint: "https://ingest.${SPLUNK_REALM}.signalfx.com/v2/trace/otlp"
     compression: gzip
     headers:
       "X-SF-Token": "${SPLUNK_ACCESS_TOKEN}"

コンフィギュレーションを完了するには、コンフィギュレーションファイルの service セクションの必須パイプラインにレシーバーを含めます。例:

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

設定例 🔗

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

endpoint: "https://1.2.3.4:1234"
tls:
  ca_file: /var/lib/mycert.pem
  cert_file: certfile
  key_file: keyfile
  insecure: true
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
headers:
  "can you have a . here?": "F0000000-0000-0000-0000-000000000000"
  header1: 234
  another: "somevalue"
compression: gzip

gzip圧縮を設定する 🔗

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

exporters:
  otlphttp:
    ...
    compression: none

設定 🔗

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

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

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

Splunk Observability Cloudをご利用のお客様

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

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。

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