gatewayのOTel直接エクスポートへ変更

コレクターへ直接エクスポートする

/login でサインインしたセッションが、テレメトリをリレー経由ではなくコレクターへ直接送信するようにするには、managed policy の env ブロックで、OTEL_EXPORTER_OTLP_ENDPOINT をコレクターの https:// ベース URL に設定します。Claude Code は、設定した URL に /v1/metrics、/v1/logs、/v1/traces のいずれかを付加し(例: https://otel-collector.example.com:4318)、各シグナルを OTLP/HTTP でそこへエクスポートします。各開発者のマシンで Claude Code v2.1.265 以降が必要です。それより前のクライアントは、引き続きリレー経由でエクスポートします。

コレクターへの認証には、同じ env ブロックで OTEL_EXPORTER_OTLP_HEADERS を設定します。この方法で指定したコレクターに、開発者のゲートウェイセッショントークンが送信されることはありません。

ポリシーでこのエンドポイントを追加または変更すると、Claude Code は対話型セッションに適用する前に、各開発者に security approval dialog での承認を求めます。

Claude Code は、シグナルを直接エクスポートする前にエンドポイントをチェックし、チェックに失敗した場合はそのシグナルをリレー上に維持します。チェック内容は次のとおりです。

• エンドポイントがゲートウェイ自体から提供されていること。同じ変数を MDM プロファイルやローカルの managed-settings.json で設定した場合、エクスポートはリレー上に留まります。
• URL が https://、またはループバックアドレスへの http:// であること
• URL の解決先パスが /v1/<signal> で終わり、クエリやフラグメントを含まないこと。このパスは、汎用の変数から Claude Code 自身が組み立てます。OTEL_EXPORTER_OTLP_METRICS_ENDPOINT のようなシグナル別の変数は、記述されたとおりに使われるため、そこにはパス全体を含めてください。
• URL がゲートウェイ自身のホストでないこと。ゲートウェイ宛てのエンドポイントは、リレー経由のパスとそのセッショントークンを維持します。
• あなたも開発者も、otelHeadersHelper をどの設定元でも設定していないこと。ヘルパーが設定されている場合、すべてのシグナルはリレー上に留まります。

指定したエンドポイントが変えるのは、エクスポート先だけです。どのシグナルをそもそもエクスポートするかは、引き続き OTEL_*_EXPORTER セレクターで選びます。

エンドポイントを指定するだけではエクスポートは有効になりません。ゲートウェイがすでにプッシュしている場合を除き、有効化する変数も設定してください。

• ゲートウェイがすでにテレメトリ変数をプッシュしている場合、それらが有効化・セレクター・プロトコルをカバーします。明示的に指定したエンドポイントは、プッシュされた <public_url> の値を上書きします。OTEL_*_EXPORTER セレクターを自分で otlp に設定するのは、forward_to の宛先がどれも有効にしていないシグナルに対してだけにしてください。
• プッシュしていない場合は、CLAUDE_CODE_ENABLE_TELEMETRY=1、OTEL_*_EXPORTER セレクター、OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf も設定してください。

開発者がサインアウトするか、別のゲートウェイにサインインすると、コレクターへのエクスポートは停止し、Claude Code は残っている各バッチを送信せずに破棄します。