Skip to content
← リリースに戻る · 2.1.269
新機能 / v2.1.269

OTEL_METRICS_INCLUDE_REPOSITORY

CHANGELOG 原文(英語)

Added OTEL_METRICS_INCLUDE_REPOSITORY to tag OpenTelemetry metrics and events with vcs.* repository attributes; commit events get vcs.ref.head.* with OTEL_LOG_TOOL_DETAILS
公式の変更履歴を開く ↗

日本語での補足

OTEL_METRICS_INCLUDE_REPOSITORYを追加。OpenTelemetryのメトリクスとイベントにvcs.*のリポジトリ属性を付与する。OTEL_LOG_TOOL_DETAILSと併用すると、commitイベントにvcs.ref.head.*も付与される。

ドキュメント

ドキュメントの抜粋(参考訳)

リポジトリ属性

OTEL_METRICS_INCLUDE_REPOSITORY=true を設定すると、メトリクスとイベントにセッションのリポジトリの識別情報がタグ付けされ、共有のコレクターがリポジトリごとに使用量を集計できるようになります。Claude Code v2.1.269 以降が必要です。

Claude Code は、リポジトリの origin リモートから、セッションごとに 1 回これらの属性を導出します。リポジトリの HTTPS リモートと SSH リモートが、GitHub、GitLab、Bitbucket Cloud のように同じホストと同じパスを指している場合、両方とも同一の値を生成します。

Attribute Value
vcs.repository.url.full .git を除いたリポジトリのブラウザ URL。例: https://github.com/example-org/example-repo
vcs.owner.name オーナーまたはグループのパス。例: example-org。リモートパスのセグメントが 1 つしかない場合は省略されます
vcs.repository.name リポジトリ名そのもの。例: example-repo
vcs.provider.name Claude Code がリモートのホストまたは URL の形式をいずれかのプロバイダーとして認識した場合に github、gitlab、bitbucket、gitea のいずれかになります。それ以外の場合は省略されます

値はすべて小文字化され、リモート URL の認証情報、クエリ文字列、フラグメントがそこに現れることはありません。セッションに origin リモートがない場合、リモートが URL の形式でない場合、または囲んでいるリポジトリがホームディレクトリのみである場合、これらの属性は省略されます。

クラウドセッションでこれらの属性を取得するには、OTEL_METRICS_INCLUDE_REPOSITORY を含むテレメトリ変数を、そのクラウド環境で設定してください。また、環境のネットワークアクセスで、使用するコレクターのドメインを許可してください。

OTEL_RESOURCE_ATTRIBUTES で宣言した vcs.* キーは、そのキーの導出値を置き換えます。vcs.repository.url.full を宣言すると、Claude Code はリモートを読み取らなくなり、宣言したキーのみを報告します。

1 つのリポジトリの HTTPS クローンと SSH クローンが異なる値を報告する場合(例えば、セルフホスト環境で、HTTPS のクローン URL に SSH URL にはないパスプレフィックスが付いている場合など)は、OTEL_RESOURCE_ATTRIBUTES に vcs.repository.url.full と、報告したいその他すべての vcs.* キーを宣言してください。これにより、どのクローンも宣言した識別情報を報告するようになります。

これらの属性は自分自身のエクスポーターにのみ送られます。Anthropic のテレメトリは、すべての vcs.* キーを破棄します。

取得日 · 2026-11-20

変更の詳細