OTLPエクスポーター設定

エンドポイントの設定

以下の環境変数により、トレース、メトリクス、およびログのためのOTLP/gRPCまたはOTLP/HTTPエンドポイントを構成できます。

OTEL_EXPORTER_OTLP_ENDPOINT

任意のシグナルタイプ用の基本エンドポイントURLで、オプションでポート番号を指定します。 同じエンドポイントに複数のシグナルを送信し、1つの環境変数でエンドポイントを制御したい場合に便利です。

デフォルト値:

• gRPC: "http://localhost:4317"
• HTTP: "http://localhost:4318"

例:

• gRPC: export OTEL_EXPORTER_OTLP_ENDPOINT="https://my-api-endpoint:443"
• HTTP: export OTEL_EXPORTER_OTLP_ENDPOINT="http://my-api-endpoint/"

OTLP/HTTPの場合、この環境変数が設定されると、SDKのエクスポーターはシグナル固有のURLを構築します。 つまり、トレース、メトリクス、ログを送信する場合、上記の例から以下のURLが構築されます。

• トレース: "http://my-api-endpoint/v1/traces"
• メトリクス: "http://my-api-endpoint/v1/metrics"
• ログ: "http://my-api-endpoint/v1/logs"

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

トレースデータ専用のエンドポイントURL。 オプションでポート番号を指定できます。 OTLP/HTTP を使用している場合は、通常 v1/traces で終わります。

デフォルト値:

• gRPC: "http://localhost:4317"
• HTTP: "http://localhost:4318/v1/traces"

例:

• gRPC: export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://my-api-endpoint:443"
• HTTP: export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="http://my-api-endpoint/v1/traces"

OTEL_EXPORTER_OTLP_METRICS_ENDPOINT

オプションでポート番号を指定することができます。 OTLP/HTTP を使用する場合は、通常 v1/metrics で終わります。

デフォルト値:

• gRPC: "http://localhost:4317"
• HTTP: "http://localhost:4318/v1/metrics"

例:

• gRPC: export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://my-api-endpoint:443"
• HTTP: export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="http://my-api-endpoint/v1/metrics"

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT

ログデータ専用のエンドポイントURL。 オプションでポート番号を指定できます。 OTLP/HTTP を使う場合は、通常 v1/logs で終わります。

デフォルト値:

• gRPC: "http://localhost:4317"
• HTTP: "http://localhost:4318/v1/logs"

例:

• gRPC: export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://my-api-endpoint:443"
• HTTP: export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="http://my-api-endpoint/v1/logs"

ヘッダーの設定

以下の環境変数を使用すると、gRPC または HTTP リクエストの発信時に追加するヘッダーを、キーと値のペアのリストとして設定できます。

OTEL_EXPORTER_OTLP_HEADERS

すべての送信データ（トレース、メトリクス、ログ）に適用するヘッダーのリスト。

デフォルト値: なし

例: export OTEL_EXPORTER_OTLP_HEADERS="api-key=key,other-config-value=value"

OTEL_EXPORTER_OTLP_TRACES_HEADERS

すべての送信トレースに適用するヘッダーのリスト。

デフォルト値: なし

例: export OTEL_EXPORTER_OTLP_TRACES_HEADERS="api-key=key,other-config-value=value"

OTEL_EXPORTER_OTLP_METRICS_HEADERS

すべての送信メトリクスに適用するヘッダーのリスト。

デフォルト値: なし

例: export OTEL_EXPORTER_OTLP_METRICS_HEADERS="api-key=key,other-config-value=value"

OTEL_EXPORTER_OTLP_LOGS_HEADERS

すべての送信ログに適用するヘッダーのリスト。

デフォルト値: なし

例: export OTEL_EXPORTER_OTLP_LOGS_HEADERS="api-key=key,other-config-value=value"

タイムアウトの設定

以下の環境変数は、OTLPエクスポーターがデータのネットバッチを送信する前に待つ最大時間（ミリ秒単位）を設定します。

OTEL_EXPORTER_OTLP_TIMEOUT

すべての送信データ（トレース、メトリクス、ログ）のタイムアウト値をミリ秒単位で指定します。

デフォルト値: 10000 (10秒)

例: export OTEL_EXPORTER_OTLP_TIMEOUT=500

OTEL_EXPORTER_OTLP_TRACES_TIMEOUT

すべての送信トレースのタイムアウト値（ミリ秒）。

デフォルト値: 10000 (10秒)

例: export OTEL_EXPORTER_OTLP_TRACES_TIMEOUT=500

OTEL_EXPORTER_OTLP_METRICS_TIMEOUT

すべての送信メトリクスのタイムアウト値をミリ秒単位で指定します。

デフォルト値: 10000 (10秒)

例: export OTEL_EXPORTER_OTLP_METRICS_TIMEOUT=500

OTEL_EXPORTER_OTLP_LOGS_TIMEOUT

すべての送信ログのタイムアウト値（ミリ秒）。

デフォルト値: 10000 (10s)

例: export OTEL_EXPORTER_OTLP_LOGS_TIMEOUT=500

プロトコルの設定

以下の環境変数は、OTLPエクスポーターが使用するOTLPトランスポートプロトコルを設定します。

OTEL_EXPORTER_OTLP_PROTOCOL

すべてのテレメトリーデータに使用するOTLPトランスポートプロトコルを指定します。

デフォルト値: SDK依存ですが、通常は http/protobuf か grpc のいずれかです。

例: export OTEL_EXPORTER_OTLP_PROTOCOL=grpc

指定できる値は以下です。

• OTLP/gRPCを使う場合は grpc
• OTLP/HTTP + protobuf を使う場合は http/protobuf
• OTLP/HTTP + JSON を使う場合は http/json

OTEL_EXPORTER_OTLP_TRACES_PROTOCOL

トレースデータに使用するOTLPトランスポートプロトコルを指定します。

デフォルト値: SDK依存ですが、通常は http/protobuf か grpc のいずれかです。

例: export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=grpc

指定できる値は以下です。

• OTLP/gRPCを使う場合は grpc
• OTLP/HTTP + protobuf を使う場合は http/protobuf
• OTLP/HTTP + JSON を使う場合は http/json

OTEL_EXPORTER_OTLP_METRICS_PROTOCOL

メトリクスデータに使用するOTLPトランスポートプロトコルを指定します。

デフォルト値: SDK依存ですが、通常は http/protobuf か grpc のいずれかです。

例: export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=grpc

指定できる値は以下です。

• OTLP/gRPCを使う場合は grpc
• OTLP/HTTP + protobuf を使う場合は http/protobuf
• OTLP/HTTP + JSON を使う場合は http/json

OTEL_EXPORTER_OTLP_LOGS_PROTOCOL

ログデータに使用するOTLPトランスポートプロトコルを指定します。

デフォルト値: SDK依存ですが、通常は http/protobuf か grpc のいずれかです。

例: export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc

指定できる値は以下です。

• OTLP/gRPCを使う場合は grpc
• OTLP/HTTP + protobuf を使う場合は http/protobuf
• OTLP/HTTP + JSON を使う場合は http/json