環境変数

OTEL_RESOURCE_ATTRIBUTES

Claude Codeがゲートウェイ経由でサインインしている場合に、認証済みアイデンティティ情報をエクスポートデータに付与するための設定です。

使い方・用途

  • 複数チームが存在する組織で、department=salesのようにカスタム属性を付加してメトリクスを識別するために使用します
  • スペースを含まないkey=value形式で指定し、カンマ区切りで複数設定可能です
  • ゲートウェイ経由のサインイン時は、手動設定したuser.*やidentity.*キーよりもゲートウェイの認証情報が優先されます
英語原文(公式ドキュメントより)

When Claude Code is signed in to a Claude apps gateway, the CLI stamps exports with the authenticated identity from the gateway session: user.id is the IdP subject rather than an anonymous installation identifier, user.email is the signed-in email, and user.groups carries IdP group membership as a comma-separated string. Each export also carries identity.source: gateway-oidc. The gateway identity is applied last, so user.* and identity.* keys set through OTEL_RESOURCE_ATTRIBUTES are ignored on gateway sessions.

関連ドキュメント

関連する変更履歴

v2.1.161(1件)

Added
Settings
OTEL_RESOURCE_ATTRIBUTES の値をメトリクスのデータポイントにラベルとして含める機能を追加。チームやリポジトリなどのカスタムディメンションによる使用状況メトリクスの分析が可能になりました。
英語原文を表示
OTEL_RESOURCE_ATTRIBUTES values are now included as labels on metric datapoints, so you can slice usage metrics by custom dimensions like team or repo

変更前

OpenTelemetry(OTel)による監視において、環境変数 OTEL_RESOURCE_ATTRIBUTES で定義されたリソース属性がメトリクスのラベルとして出力されていませんでした。

変更後

リソース属性がメトリクスの各データポイントにラベルとして自動的に付与されるようになり、収集したデータをチーム別やプロジェクト別に集計して分析できるようになりました。

ユーザーへの恩恵

組織全体で Claude Code の利用状況やコストを追跡する際、特定のチームやリポジトリ単位でフィルタリングやグループ化が容易になり、より詳細なモニタリングが可能になります。

関連ドキュメント