環境変数

OTEL_EXPORTER_OTLP_ENDPOINT

型string

すべてのシグナルに共通の OTLP エクスポーターエンドポイント (例: http://localhost:4317)。

使い方・用途

  • /login でサインインしたセッションのテレメトリを、ゲートウェイのリレー経由ではなく、収集先の OpenTelemetry Collector へ直接送りたいときに、managed policy の env ブロックにこのエンドポイントを設定する
  • v2.1.265 以降のクライアントで、セッションのメトリクス・ログ・トレースを自社運用の Collector に OTLP/HTTP で送り、ゲートウェイのリレーを経由させたくない課題を解決する
  • SDK 経由で動かす際にテレメトリを手元で確認したい場合、console エクスポーターを使わず、ローカルの OpenTelemetry Collector にこの変数で向け直すことができる
英語原文(公式ドキュメントより)

OTLP exporter endpoint for all signals (e.g. http://localhost:4317). See https://code.claude.com/docs/en/monitoring-usage#common-configuration-variables

関連ドキュメント

関連する変更履歴

v2.1.265(1件)

Changed
Claude アプリのゲートウェイセッションについて、OpenTelemetry をゲートウェイのリレー経由ではなく、ゲートウェイの管理対象設定が OTEL_EXPORTER_OTLP_ENDPOINT に指定したコレクターへ直接エクスポートするよう変更した。コレクターが指定されていないセッションは引き続きリレーを使う
英語原文を表示
Changed Claude apps gateway sessions to export OpenTelemetry directly to a collector the gateway's managed settings name in OTEL_EXPORTER_OTLP_ENDPOINT, instead of through the gateway's relay; sessions without a named collector still use the relay

変更後

ゲートウェイ経由のセッションでも、管理ポリシーで OTEL_EXPORTER_OTLP_ENDPOINT を指定すれば、テレメトリーをリレーを経由せずに自社の OpenTelemetry コレクターへ直接送信できる。これにより、既存のコレクター環境を持つ組織は、テレメトリーの経路を自分の環境に直接統合できる。

関連ドキュメント

v2.1.217(1件)

Fixed
OTEL_EXPORTER_OTLP_ENDPOINTが全信号に適用されるよう管理設定を修正しました。
英語原文を表示
Fixed managed settings that set OTEL_EXPORTER_OTLP_ENDPOINT not governing all signals — lower-scope signal-specific overrides no longer redirect telemetry away from the managed endpoint

変更後

テレメトリの送信先がバラバラにならず、管理者側の設定が確実に反映されます。

関連ドキュメント