環境変数

OTEL_RESOURCE_ATTRIBUTES

型string

すべてのテレメトリーに付与される、カンマ区切りの key=value 形式のリソース属性。

使い方・用途

  • 複数チームや部門が同じ監視基盤を使う環境で、カスタム属性を付けてメトリクスをチーム単位でグループ化・フィルタリングできるようにする。
  • Desktop SSH セッションがどのリモートマシンで実行されたかを、host.name などのカスタム属性で識別できるようにする。
  • API キー直接認証や Amazon Bedrock 等の構成では user.email などの識別属性が付与されないため、managed settings 経由でユーザー単位の属性を設定してイベントを利用者に紐付ける。
英語原文(公式ドキュメントより)

Comma-separated key=value resource attributes attached to all telemetry. See https://code.claude.com/docs/en/monitoring-usage#multi-team-organization-support

関連する変更履歴

v2.1.161(1件)

Added
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

変更後

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

関連ドキュメント