OTLP/HTTP エクスポーター 🔗
OTLP/HTTP エクスポーターは、OTLP フォーマットを使用して、メトリクス、トレース、およびログを HTTP 経由で送信します。サポートされているパイプラインタイプは、traces
、metrics
、および logs
です。詳細については、パイプラインでデータを処理する を参照してください。
また、OTLP 形式を使用してデータを送信するための高度なオプションの OTLP エクスポーターを使用することもできます。詳細については、OTLPエクスポーター を参照してください。
Collector をバイパスして OTLP 形式のデータを直接 Splunk Observability Cloud に送信する必要がある場合:
メトリクスを送信するには、otlp エンドポイントを使用します。詳細については、開発者ポータルの データポイントの送信 を参照してください。このオプションは、protobuf ペイロードしか受け付けないことに注意してください。
トレースを送信するには、gRPC エンドポイントを使用します。詳細については、gRPC エンドポイントを使用して Splunk Observability Cloud にトレースを送信する を参照してください。
OTLPフォーマットについての詳細は、OTel repo OpenTelemetry Protocol Specification を参照してください。
はじめに 🔗
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください:
Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします:
次のセクションで説明するようにエクスポーターを設定します。
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_endpoint
と traces_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をご利用のお客様
Submit a case in the Splunk Support Portal .
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。