動的ヘッダー

動的認証を必要とするエンタープライズ環境の場合、ヘッダーを動的に生成するスクリプトを設定できます。動的ヘッダーは http/protobuf および http/json プロトコルにのみ適用されます。grpc プロトコルでは、Claude Code は静的ヘッダー変数 OTEL_EXPORTER_OTLP_HEADERS およびそのシグナル固有の変数のみを使用します。

設定の設定

.claude/settings.json に追加します。パスを独自のスクリプトに置き換えます：

{
  "otelHeadersHelper": "/path/to/generate-otel-headers.sh"
}

値は、スペースを含むパスを含む実行可能ファイルへのパス、またはコマンドライン引数を含むシェルコマンドラインです。Windows では、値は常にシェルを通じて実行されるため、スペースを含むパスを JSON 値内で引用符で囲みます。

スクリプト要件

スクリプトは、HTTP ヘッダーを表す文字列キーと値のペアを持つ有効な JSON を出力する必要があります：

#!/bin/bash
# 例：複数のヘッダー
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

ヘルパーが失敗するか、これらの要件を満たさない出力を出力する場合、エクスポートは失敗し、テレメトリバックエンドはヘルパーが再び機能するまでセッションから何も受け取りません。Claude Code は以下で失敗を報告します：

• 対話型セッションの警告通知。otelHeadersHelper failed; telemetry is not being exported。ヘルパーが最初に失敗したときにセッションごとに 1 回表示されます
• /status 出力
• --debug で実行するか、セッション内で /debug を実行した後のデバッグログ
• -p で開始された非対話型セッションの stderr

リフレッシュ動作

ヘッダーヘルパースクリプトはスタートアップ時に実行され、その後定期的に実行されてトークンリフレッシュをサポートします。デフォルトでは、スクリプトは 29 分ごとに実行されます。CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS 環境変数で間隔をカスタマイズします。

マルチチーム組織サポート

複数のチームまたは部門を持つ組織は、OTEL_RESOURCE_ATTRIBUTES 環境変数を使用してカスタム属性を追加し、異なるグループを区別できます：

# チーム識別用のカスタム属性を追加
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

これらのカスタム属性はすべてのメトリクスおよびイベントに含まれ、以下を可能にします：

• チームまたは部門別にメトリクスをフィルタリング
• コストセンターごとのコストを追跡
• チーム固有のダッシュボードを作成
• 特定のチーム向けのアラートを設定

Claude Code はこれらの値をすべてのメトリクスデータポイントおよびイベントレコード上の属性として、OTLP リソースブロックで送信することに加えて、属性として付加します。ほとんどのメトリクスバックエンドはデータポイント属性をクエリ可能なラベルとして公開するため、カスタムキーで直接メトリクスをグループ化およびフィルタリングできます。vcs.* リポジトリ属性を除き、カスタムキーは user.id または session.id などの標準属性をオーバーライドしません：キーが衝突する場合、Claude Code は組み込み値を保持します。

各カスタムキーはすべてのメトリクスシリーズ上のラベルになるため、高カーディナリティ値はメトリクスバックエンドのストレージコストを増加させます。カスタム属性をリソースブロックのみで送信し、データポイントラベルから省略するには、OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false を設定します。メトリクスカーディナリティ制御を参照してください。

設定例

claude を実行する前にこれらの環境変数を設定します。以下の各シナリオは完全な設定を示し、各変数は一般的な設定変数の下で説明されています。設定が有効になったことを確認するには、セッションを開始した後、バックエンドで claude_code.session.count メトリクスを確認します。クイックスタートはログのみの検証と、何も到着しない場合に確認する内容をカバーしています。

コンソールデバッグ用に 1 秒のエクスポート間隔で：

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

OTLP over gRPC の場合：

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

Prometheus の場合。http://localhost:9464/metrics からスクレイプ：

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

自己ホスト環境では、セッションはランナーのデフォルト容量 1 でのみポート 9464 をバインドします。容量が高い場合、ランナーは代わりに独自の /metrics エンドポイント上でセッションカウンターとゲージを再公開します。

複数のエクスポーターにメトリクスを送信するには：

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console,otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

メトリクスとログを異なるエンドポイントまたはバックエンドに送信するには：

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://metrics.example.com:4318
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

イベントまたはログなしでメトリクスのみをエクスポートするには：

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

メトリクスなしでイベントとログのみをエクスポートするには：

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

クラウドセッションと Claude Tag からのテレメトリ

クラウドセッション（Claude Tag チャネルセッションを含む）は、ユーザーのデバイス上ではなく クラウド環境 で実行されるため、これらのデバイス上の管理設定ファイルまたはシェルプロファイルではテレメトリを設定できません。Anthropic ホスト環境のセッションの場合、このセクションではテレメトリ変数を設定する場所、コレクターを環境から到達可能にする方法、およびエクスポートされたデータでクラウドセッションと Claude Tag セッションを区別する方法について説明します。

これらのセッションからテレメトリをエクスポートするには、管理者設定 の例と同じキーを使用して、CLAUDE_CODE_ENABLE_TELEMETRY と OTEL_* 変数を次の 2 つの場所のいずれかに設定します。

• サーバー管理設定: 組織の サーバー管理設定 の env ブロックに追加します。Claude Code は サーバー管理設定が適用される 場所（ユーザーのマシンと Claude Tag チャネルセッション以外のクラウドセッションを含む）で起動時にこれらの設定を取得します。Claude Tag セッションはサーバー管理設定を受け取らないため、このルートではそれらを設定できません。
• 環境の変数: クラウド環境の 環境変数 に追加して、その環境で実行されるセッションのみを設定します。これは Claude Tag セッションに到達するルートです。

環境を使用する誰もがその変数を読み取ることができるため、OTEL_EXPORTER_OTLP_HEADERS のコレクタートークンなどの認証情報をそこに配置しないでください。環境の API 認証情報 も役に立ちません。Claude Code 独自のテレメトリエクスポートは、認証情報を取得しないリクエスト の 1 つだからです。コレクターが認証情報を必要とする場合は、代わりにサーバー管理設定を通じてエクスポート全体を設定してください。認証情報をそこに設定すると、Claude Code は管理設定外で設定されたエンドポイント変数を削除します。

クラウドセッションのテレメトリを設定する際は、これらの制約を念頭に置いてください。

• セッションがコレクターに到達できるようにする: Claude Code はセッションのネットワークを通じてエクスポートを送信するため、OTEL_EXPORTER_OTLP_ENDPOINT のホストに到達できるかどうかは、環境の ネットワークアクセスレベル によって異なります。セッションが選択したレベルでコレクターのドメインに到達できない場合は、ドメインを環境のアローリストに追加してください。サーバー管理設定はドメインを環境のネットワークアローリストに追加しないためです。
• Claude Tag チャネルは組織レベルの環境を使用します: チャネルセッションはメンバーの個人環境ではなく組織レベルの環境で実行されるため、共有環境 でアローリストと環境変数の変更を行い、組織のデフォルトとして設定するか、チャネルにピン留めしてください。
• Cowork は個別に設定されます: サーフェスカバレッジテーブル に示されているように、Cowork セッションはサーバー管理設定を受け取らないため、サーバー管理 env ブロックはそれらのテレメトリを設定しません。

クラウドセッションにテレメトリを属性付けする

デフォルトでは、クラウドセッションからのメトリクスとイベントは、session.id、ccr.session.id、organization.id を含む 標準属性 を含むため、追加の設定なしでセッションまたは組織でフィルタリングできます。ccr.session.id の値はセッションの CLAUDE_CODE_REMOTE_SESSION_ID です。これをセッションのトランスクリプト URL に変換するには、出力をセッションにリンク戻す を参照してください。

テレメトリをより詳細に属性付けするには、これらのオプションを使用します。

• Claude Tag セッションを識別する: メトリクスカーディナリティ制御 で説明されているように、OTEL_METRICS_INCLUDE_ENTRYPOINT=true を設定します。メトリクスは app.entrypoint を含むようになり、Claude Tag セッションの値は claude-in-slack です。
• カスタム属性を追加する: これらのセッションの他の OTEL_* 変数を設定する場所と同じ場所に OTEL_RESOURCE_ATTRIBUTES を設定します。代わりに環境の セットアップスクリプト でそれを export する場合、値は Claude Code に到達しません。セットアップスクリプトは Claude Code が起動する前に実行される別の Bash スクリプトであり、それがエクスポートする変数はそれで終わります。

Claude Tag チャネルセッションでは、Claude はメンバーではなく組織の 共有 ID として機能するため、user.* 属性に依存して Claude にタグを付けたユーザーを識別しないでください。

利用可能なメトリクスとイベント

標準属性

すべてのメトリクスとイベントは、以下の標準属性を共有します。

/login を通じて Claude apps gateway にサインインしたセッションでは、CLI は認証済みの ID をエクスポートに付与します。user.id は IdP のサブジェクト、user.email はサインインしたメールアドレスで、user.groups は IdP のグループメンバーシップをカンマ区切りの文字列として保持します。各エクスポートには identity.source: gateway-oidc も付与されます。ゲートウェイの ID は最後に適用されるため、これらのセッションでは OTEL_RESOURCE_ATTRIBUTES で設定した user.* および identity.* キーは無視されます。

ゲートウェイ経由で接続する Claude Desktop および Cowork セッションの ID 属性については、ゲートウェイの telemetry リファレンスを参照してください。

イベントには、さらに以下の属性が含まれます。これらはカーディナリティが無制限に増大する原因となるため、メトリクスには付与されません。

• prompt.id: ユーザーのプロンプトと、次のプロンプトまでに発生する後続のすべてのイベントを関連付ける UUID。イベント相関属性を参照してください。
• workspace.host_paths: デスクトップアプリで選択されたホストのワークスペースディレクトリ（文字列配列）
• workflow.run_id: wf_ をプレフィックスとする実行識別子。Workflow ツールの実行に属するエージェントが発行する API イベントとツールイベントに付与されます。1 つの workflow.run_id でイベントをフィルタリングすると、その実行の API リクエストとツール結果を再構成できます。この識別子は、ワークフロースクリプトが起動するエージェントと、それらがさらに起動するエージェント（スキルの呼び出しなど）を対象とします。Workflow ツールの結果で報告される実行識別子と一致します。その他のすべてのイベントには含まれません。Claude Code v2.1.202 以降が必要です
• workflow.name: ワークフローの名前（スクリプトの meta.name）。workflow.run_id と一緒に出力されます。組み込みワークフローの名前は、未変更の組み込みスクリプトが実行された場合にそのまま表示されます。ユーザーが作成した名前（組み込みスクリプトを編集したコピーを含む）は、OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り custom に置き換えられます。Claude Code v2.1.202 以降が必要です

リポジトリ属性

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

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

値は小文字に変換され、リモート 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.* キーを破棄します。

メトリクス

Claude Code は以下のメトリクスをエクスポートします。「単位」列には各メトリクスに付与される OpenTelemetry の単位文字列を示しています。カウント系のメトリクスには単位はありません。

OTEL_METRICS_EXPORTER に指定されたエクスポーターが prometheus のみの場合、スクレイプ結果が有効な Prometheus テキスト形式となるよう、Claude Code はエクスポートするメトリクスから USD、tokens、s の単位を省略します。メトリクス名は変わりません。また、otlp,prometheus のようにエクスポーターを組み合わせた設定では単位が維持されます。v2.1.216 より前は、Prometheus のスクレイプ結果に OpenMetrics 専用の # UNIT 行が含まれており、一部のスクレイパーで拒否されていました。

メトリクスの詳細

各メトリクスには上記の標準属性が含まれます。追加のコンテキスト固有の属性を持つメトリクスについては、以下に記載しています。

セッションカウンター

各セッションの開始時にインクリメントされます。

属性:

• すべての標準属性
• start_type: セッションの開始方法。"fresh"、"resume"、"continue"、"agents_view" のいずれかです。"agents_view" の値は claude agents ダッシュボードプロセスを示します。これは会話セッションではなく、ユーザーが起動するローカル UI です。ダッシュボードで UI プロセスの起動と会話セッションを区別するには、この値でフィルタリングしてください。

コード行数カウンター

コードが追加または削除されたときにインクリメントされます。

属性:

• すべての標準属性
• type: （"added"、"removed"）
• model: 変更を行ったモデルのモデル識別子（例: "claude-sonnet-5"）

プルリクエストカウンター

Claude Code がシェルコマンドまたは MCP ツールを通じてプルリクエストまたはマージリクエストを作成したときにインクリメントされます。

属性:

• すべての標準属性

コミットカウンター

Claude Code 経由で Git コミットを作成したときにインクリメントされます。

属性:

• すべての標準属性

コストカウンター

各 API リクエストの後にインクリメントされます。

agent.name、skill.name、plugin.name、mcp_server.name、mcp_tool.name の各属性は、デフォルトで一部の名前を "custom" または "third-party" というプレースホルダーに置き換えて秘匿化します。OTEL_LOG_TOOL_DETAILS=1 を設定すると、代わりに実際の名前が含まれます。v2.1.273 より前は、OTEL_LOG_TOOL_DETAILS=1 を設定していても、コストカウンターとトークンカウンター、および api_request、api_error、api_refusal イベントには秘匿化された値が含まれていました。

属性:

• すべての標準属性
• model: モデル識別子（例: "claude-sonnet-5"）
• query_source: リクエストを発行したサブシステムのカテゴリ。"main"、"subagent"、"auxiliary" のいずれか
• speed: リクエストが fast mode を使用した場合は "fast"。それ以外の場合は含まれません
• effort: リクエストに適用された effort レベル。"low"、"medium"、"high"、"xhigh"、"max" のいずれか。Claude Code が effort レベルを送信しない場合（effort をサポートしていないモデルなど）は含まれません。
• agent.name: リクエストを発行したサブエージェントの種類。組み込みエージェント名と公式マーケットプレイスのプラグインのエージェントはそのまま表示されます。その他のユーザー定義のエージェント名は "custom" に置き換えられます。名前付きのサブエージェントの種類によって発行されたリクエストでない場合は含まれません。
• skill.name: リクエストでアクティブなスキル。Skill ツールまたは / コマンドによって設定されるか、起動されたサブエージェントに継承されます。組み込み、バンドル、ユーザー定義、および公式マーケットプレイスのプラグインのスキル名はそのまま表示されます。サードパーティのプラグインのスキル名は "third-party" に置き換えられます。アクティブなスキルがない場合は含まれません。
• plugin.name: アクティブなスキルまたはサブエージェントがプラグインによって提供されている場合の、所有元のプラグイン。公式マーケットプレイスのプラグイン名はそのまま表示されます。サードパーティのプラグイン名は "third-party" に置き換えられます。スキルとサブエージェントのどちらにも所有元のプラグインがない場合は含まれません。
• marketplace.name: 所有元のプラグインのインストール元のマーケットプレイス。OTEL_LOG_TOOL_DETAILS=1 が設定されている場合でも、公式マーケットプレイスのプラグインに対してのみ出力されます。それ以外の場合は含まれません。
• mcp_server.name: このリクエストが消費したツール結果を返した MCP サーバー。組み込み、claude.ai 経由のプロキシ、および公式レジストリのサーバー名はそのまま表示されます。ユーザーが設定したサーバー名は "custom" に置き換えられます。リクエストが MCP ツールの結果を消費しなかった場合は含まれません。v2.1.222 より前は、Claude Code はツール結果を消費したリクエストだけでなく、MCP ツール呼び出し後のすべてのリクエストにこの属性を設定していたため、この属性を集計するダッシュボードではアップグレード後に値が減少します。
• mcp_tool.name: このリクエストが結果を消費した MCP ツール。秘匿化とバージョンの挙動は mcp_server.name と同じです。リクエストが MCP ツールの結果を消費しなかった場合は含まれません。

トークンカウンター

各 API リクエストの後にインクリメントされます。

属性:

• すべての標準属性
• type: （"input"、"output"、"cacheRead"、"cacheCreation"）。"input" タイプには、プロンプトキャッシュから読み取られた、またはプロンプトキャッシュに書き込まれたトークンは含まれません。これらは "cacheRead" と "cacheCreation" でカウントされます
• model: モデル識別子（例: "claude-sonnet-5"）
• query_source: リクエストを発行したサブシステムのカテゴリ。"main"、"subagent"、"auxiliary" のいずれか
• speed: リクエストが fast mode を使用した場合は "fast"。それ以外の場合は含まれません
• effort: リクエストに適用された effort レベル。詳細はコストカウンターを参照してください。
• agent.name、skill.name、plugin.name、marketplace.name、mcp_server.name、mcp_tool.name: リクエストのスキル、プラグイン、エージェント、MCP の帰属情報。定義と秘匿化の挙動についてはコストカウンターを参照してください。

コード編集ツール決定カウンター

ユーザーが Edit、Write、NotebookEdit ツールの使用を承認または拒否したときにインクリメントされます。

属性:

• すべての標準属性
• tool_name: ツール名（"Edit"、"Write"、"NotebookEdit"）
• decision: ユーザーの決定（"accept"、"reject"）
• source: 決定の出どころ。"config"、"hook"、"user_permanent"、"user_temporary"、"user_abort"、"user_reject" のいずれかです。各値の意味についてはツール決定イベントを参照してください。
• language: 編集されたファイルのプログラミング言語。"TypeScript"、"Python"、"JavaScript"、"Markdown" など。認識されないファイル拡張子の場合は "unknown" を返します。

アクティブ時間カウンター

アイドル時間を除き、Claude Code をアクティブに使用した実際の時間を記録します。このメトリクスは、ユーザーの操作中（入力や応答の閲覧など）と、CLI の処理中（ツールの実行や AI の応答生成など）にインクリメントされます。

属性:

• すべての標準属性
• type: キーボード操作の場合は "user"、ツールの実行と AI の応答の場合は "cli"

イベント

Claude Code は、OpenTelemetry のログ/イベントを通じて以下のイベントをエクスポートします（OTEL_LOGS_EXPORTER が設定されている場合）。

イベント相関属性

ユーザーがプロンプトを送信すると、Claude Code は複数の API 呼び出しを行い、いくつかのツールを実行することがあります。prompt.id 属性を使用すると、それらのイベントすべてを、それらをトリガーした単一のプロンプトに結び付けることができます。

単一のプロンプトによってトリガーされたすべてのアクティビティを追跡するには、特定の prompt.id の値でイベントをフィルタリングします。これにより、そのプロンプトの処理中に発生した user_prompt イベント、api_request イベント、tool_result イベントが返されます。

event.sequence は Claude Code プロセスが開始されるたびに 0 から始まり、そのプロセスが存続する間カウントアップされます。新しい session.id が割り当てられる /clear の後もカウントは継続します。フォークせずにセッションを再開した場合、セッションは session.id を維持しますが、event.sequence の値は再開したプロセスのものになります。そのため、1 つのセッション内で後のイベントが前のイベントより小さい値を持つことや、同じ値が重複することがあります。セッションのイベントを順序付けるには、event.timestamp で並べ替え、同じタイムスタンプを持つイベントの順序付けに event.sequence を使用してください。

メッセージ単位で再構成するために、各イベントクラスはセッションのトランスクリプトのフィールドと一致するキーを保持しています。トランスクリプトのエントリ形式は Claude Code の内部仕様であり、バージョン間で変更されるため、これらのフィールドで結合するパイプラインはどのリリースでも壊れる可能性があります。結合は安定した契約ではなく、バージョン固有のものとして扱ってください。

• user_prompt、assistant_response、api_response_body の message.uuid
• API イベントの request_id。トランスクリプトのアシスタントエントリには requestId として保存されます
• tool_result および tool_decision イベントの tool_use_id

ユーザープロンプトイベント

ユーザーがプロンプトを送信したときにログに記録されます。

イベント名: claude_code.user_prompt

属性:

• すべての標準属性
• event.name: "user_prompt"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• prompt_length: プロンプトの長さ
• prompt: プロンプトの内容。デフォルトでは秘匿化されます。含めるには OTEL_LOG_USER_PROMPTS=1 を設定してください
• message.uuid: 結果として生成されたユーザーメッセージの UUID。保存されたトランスクリプトのエントリと一致します。0 個または複数のメッセージを生成する可能性があるコマンドのディスパッチには含まれません。Claude Code v2.1.214 以降が必要です
• command_name: プロンプトがコマンドを呼び出す場合のコマンド名。compact や debug などの組み込みおよびバンドルのコマンド名はそのまま出力されます。reset などのエイリアスは正規の名前ではなく入力されたとおりに出力されます。カスタム、プラグイン、MCP のコマンド名は、OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り custom または mcp にまとめられます
• command_source: コマンドが存在する場合のコマンドの出どころ。builtin、custom、mcp のいずれかです。プラグインが提供するコマンドは custom として報告されます

アシスタント応答イベント

モデルからテキストコンテンツを返す各 API リクエストの後にログに記録されます。応答のテキストブロックのみが含まれ、思考ブロックとツール使用ブロックは除外されます。Claude Code v2.1.193 以降が必要です。

イベント名: claude_code.assistant_response

属性:

• すべての標準属性
• event.name: "assistant_response"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• response_length: 応答テキストの長さ（文字数）
• response: 応答テキスト。コンテンツの上限（デフォルトは 60 KB）で切り詰められます。デフォルトでは <REDACTED> に秘匿化されます。含めるには OTEL_LOG_ASSISTANT_RESPONSES=1 を設定してください。OTEL_LOG_ASSISTANT_RESPONSES が未設定の場合は、代わりに OTEL_LOG_USER_PROMPTS によって制御されます。そのため、プロンプトのログ記録を有効にしたまま応答を秘匿化しておくには OTEL_LOG_ASSISTANT_RESPONSES=0 を設定してください
• model: モデル識別子（例: "claude-sonnet-5"）
• request_id: API リクエスト ID。イベント相関属性で説明しています
• message.uuid: 応答の最後のトランスクリプトエントリの UUID。API レスポンスはコンテンツブロックごとに 1 つのトランスクリプトエントリとして保存されます。これはその最後のエントリであり、次のターンの parentUuid がこれにチェーンされます。Claude Code v2.1.214 以降が必要です
• query_source: リクエストを発行したサブシステム。"repl_main_thread"、"compact"、またはサブエージェント名など

ツール結果イベント

ツールの実行が完了したときにログに記録されます。ツール呼び出しが拒否された場合は出力されません。拒否についてはツール決定イベントを参照してください。

イベント名: claude_code.tool_result

属性:

• すべての標準属性
• event.name: "tool_result"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• tool_name: ツールの名前
• tool_use_id: このツール呼び出しの一意の識別子。フックに渡される tool_use_id と一致するため、OTel イベントとフックで取得したデータを関連付けることができます。
• success: "true" または "false"
• duration_ms: 実行時間（ミリ秒）
• error_type: ツールが失敗した場合のエラーカテゴリの文字列。"Error:ENOENT" や "ShellError" など
• error（OTEL_LOG_TOOL_DETAILS=1 の場合）: ツールが失敗した場合の完全なエラーメッセージ
• decision_type: 常に "accept"。このイベントはツールの実行後にのみ出力されるためです。拒否された呼び出しはツール結果を生成しません
• decision_source: 権限決定の出どころ。"config"、"hook"、"user_permanent"、"user_temporary" のいずれかです。各値の意味についてはツール決定イベントを参照してください。拒否専用のソースである "user_abort" と "user_reject" がこのイベントに現れることはありません。
• tool_input_size_bytes: JSON シリアライズされたツール入力のサイズ（バイト）
• tool_result_size_bytes: ツール結果のサイズ（バイト）
• mcp_server_scope: MCP サーバーのスコープ識別子（MCP ツールの場合）
• vcs.ref.head.revision、vcs.ref.head.name、vcs.ref.head.type（OTEL_LOG_TOOL_DETAILS=1 の場合）: Bash または PowerShell ツールによって実行され成功した git commit のコミットの識別情報。vcs.ref.head.revision はコミット SHA、vcs.ref.head.name はコミットされたブランチ、vcs.ref.head.type は branch です。detached HEAD 上でコミットされた場合、名前と種類は省略されます。Claude Code v2.1.269 以降が必要です
• tool_parameters（OTEL_LOG_TOOL_DETAILS=1 の場合）: ツール固有のパラメーターを含む JSON 文字列。Claude Desktop の組み込みサーバーについては、Claude Desktop が所有するセッションでは、フラグがオフでも mcp_server_name/mcp_tool_name のペアが含まれます。これはツール決定イベントと同じ、ホストが作成した名前に対する例外であり、Claude Code v2.1.214 以降が必要です。パラメーターはツールによって異なります。
  • Bash ツールの場合: bash_command、full_command、timeout、description、dangerouslyDisableSandbox を含みます。さらに git commit コマンドが成功した場合は git_commit_id と git_branch を含みます。git_commit_id は、コミットがセッションの作業ディレクトリの HEAD である場合は完全なコミット SHA、それ以外の場合は Git の短縮 SHA です。git_branch はコミットされたブランチで、detached HEAD の場合は省略されます
  • デスクトップアプリのワークスペース Bash ツール（tool_name も Bash として報告されます）の場合: bash_command、full_command、timeout のみを含みます
  • MCP ツールの場合: mcp_server_name、mcp_tool_name を含みます
  • Skill ツールの場合: skill_name を含みます
  • Agent ツールまたは従来の Task ツールの場合: subagent_type を含みます
• tool_input（OTEL_LOG_TOOL_DETAILS=1 の場合）: JSON シリアライズされたツールの引数。512 文字を超える個々の値は切り詰められ、ペイロード全体は約 4 K 文字に制限されます。MCP ツールを含むすべてのツールに適用されます。

API リクエストイベント

Claude への各 API リクエストについてログに記録されます。

イベント名: claude_code.api_request

属性:

• すべての標準属性
• event.name: "api_request"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• model: 使用されたモデル（例: "claude-sonnet-5"）
• cost_usd: 推定コスト（USD）
• cost_usd_micros: 推定コスト（100 万分の 1 米ドル単位）。整数として出力されます
• duration_ms: リクエストの所要時間（ミリ秒）
• input_tokens: 入力トークン数。プロンプトキャッシュから読み取られた、またはプロンプトキャッシュに書き込まれたトークンは含みません
• output_tokens: 出力トークン数
• cache_read_tokens: キャッシュから読み取られたトークン数
• cache_creation_tokens: キャッシュの作成に使用されたトークン数
• request_id: API リクエスト ID（例: "req_011..."）。イベント相関属性で説明しています。
• client_request_id: x-client-request-id リクエストヘッダーとして送信される、クライアントが生成した UUID。含まれる条件についてはイベント相関属性の表を参照してください。Claude Code v2.1.214 以降が必要です
• speed: "fast" または "normal"。fast mode が有効だったかどうかを示します
• query_source: リクエストを発行したサブシステム。"repl_main_thread"、"compact"、またはサブエージェント名など
• effort: リクエストに適用された effort レベル。"low"、"medium"、"high"、"xhigh"、"max" のいずれか。Claude Code が effort レベルを送信しない場合（effort をサポートしていないモデルなど）は含まれません。
• agent.name、skill.name、plugin.name、marketplace.name、mcp_server.name、mcp_tool.name: リクエストのスキル、プラグイン、エージェント、MCP の帰属情報。定義と秘匿化の挙動についてはコストカウンターを参照してください。

API エラーイベント

Claude への API リクエストが失敗したときにログに記録されます。

イベント名: claude_code.api_error

属性:

• すべての標準属性
• event.name: "api_error"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• model: 使用されたモデル（例: "claude-sonnet-5"）
• error: エラーメッセージ
• status_code: 数値としての HTTP ステータスコード。接続の失敗など、HTTP 以外のエラーの場合は含まれません。
• duration_ms: リクエストの所要時間（ミリ秒）
• attempt: 最初のリクエストを含む試行の合計回数（1 は再試行が発生しなかったことを意味します）
• request_id: API リクエスト ID（例: "req_011..."）。イベント相関属性で説明しています。
• client_request_id: x-client-request-id リクエストヘッダーとして送信される、クライアントが生成した UUID。タイムアウトや接続エラーなどの失敗によってサーバーの request_id が生成されなかった場合でも利用できます。含まれる条件についてはイベント相関属性の表を参照してください。Claude Code v2.1.214 以降が必要です
• speed: "fast" または "normal"。fast mode が有効だったかどうかを示します
• query_source: リクエストを発行したサブシステム。"repl_main_thread"、"compact"、またはサブエージェント名など
• effort: リクエストに適用された effort レベル。Claude Code が effort レベルを送信しない場合（effort をサポートしていないモデルなど）は含まれません。
• agent.name、skill.name、plugin.name、marketplace.name、mcp_server.name、mcp_tool.name: リクエストのスキル、プラグイン、エージェント、MCP の帰属情報。定義と秘匿化の挙動についてはコストカウンターを参照してください。

API 拒否イベント

API リクエストが stop_reason: "refusal" を返したときにログに記録されます。拒否は HTTP エラーとしてではなく成功したレスポンスストリーム上で届くため、api_error イベントは発生しません。このイベントを使用すると、拒否の頻度を追跡し、api_request や api_error と同じ属性で拒否をグループ化できます。

イベント名: claude_code.api_refusal

属性:

• すべての標準属性
• event.name: "api_refusal"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• model: リクエストのモデル識別子
• request_id: API リクエスト ID（例: "req_011..."）。イベント相関属性で説明しています。
• query_source: リクエストを発行したサブシステム。"repl_main_thread"、"compact"、またはサブエージェント名など。定義については api_request を参照してください。
• speed: Fast mode が有効な場合は "fast"、それ以外は "normal"
• attempt: 再試行の試行番号。最初の試行は 1 です。
• effort: リクエストに適用された effort レベル。Claude Code が effort レベルを送信しない場合（effort をサポートしていないモデルなど）は含まれません。
• server_fallback_hop: API のサーバー側のモデルフォールバックがこの拒否をすでに別のモデルで再試行したため、ユーザーにはこの拒否が表示されなかった場合は true。リクエストが拒否で終了した場合は false。フォールバック先のモデルも拒否した場合、1 つのターンで true のホップイベントと、その後の false の最終イベントの両方が出力されることがあります。
• has_category: API レスポンスに "cyber"、"bio"、"frontier_llm"、"reasoning_extraction" のいずれかの stop_details.category が含まれていた場合は true。レスポンスにカテゴリが含まれていなかった場合、またはその集合以外の値だった場合は false。ホップのブロックには stop_details が含まれないため、server_fallback_hop が true の場合は含まれません。
• has_explanation: API レスポンスに stop_details.explanation が含まれていた場合は true、それ以外は false。server_fallback_hop が true の場合は含まれません。
• category: API レスポンスの stop_details.category の値。"cyber"、"bio"、"frontier_llm"、"reasoning_extraction" のいずれかです。OTEL_LOG_TOOL_DETAILS=1 が設定され、かつ has_category が true の場合にのみ含まれます。
• agent.name、skill.name、plugin.name、marketplace.name、mcp_server.name、mcp_tool.name: リクエストのスキル、プラグイン、エージェント、MCP の帰属情報。定義と秘匿化の挙動についてはコストカウンターを参照してください。

API リクエストボディイベント

OTEL_LOG_RAW_API_BODIES が設定されている場合、各 API リクエストの試行についてログに記録されます。試行ごとに 1 つのイベントが出力されるため、パラメーターを調整した再試行はそれぞれ独自のイベントを生成します。

イベント名: claude_code.api_request_body

属性:

• すべての標準属性
• event.name: "api_request_body"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• body: システムプロンプト、メッセージ、ツールなどを含む、JSON シリアライズされた Messages API のリクエストパラメーター。コンテンツの上限（デフォルトは 60 KB）で切り詰められます。過去のアシスタントのターンに含まれる拡張思考のコンテンツは秘匿化されます。インラインモード（OTEL_LOG_RAW_API_BODIES=1）でのみ出力されます。
• body_ref: 切り詰められていないボディを含む <dir>/<uuid>.request.json ファイルへの絶対パス。ファイルモード（OTEL_LOG_RAW_API_BODIES=file:<dir>）でのみ出力されます。
• body_length: 切り詰め前のボディの長さ。OTEL_LOG_RAW_API_BODIES=file:<dir> の場合は UTF-8 バイト、=1 の場合は UTF-16 コード単位です
• body_truncated: インラインでの切り詰めが発生した場合は "true"。ファイルモードの場合、および切り詰めが発生しなかった場合は含まれません。
• model: リクエストパラメーターのモデル識別子
• query_source: リクエストを発行したサブシステム（例: "compact"）
• request_body_id: この試行のリクエストボディを識別する UUID。成功した試行の api_response_body イベントにも同じ値が含まれるため、レスポンスとそれを生成した正確なリクエストを対応付けることができます。Claude Code v2.1.274 以降が必要です

API レスポンスボディイベント

OTEL_LOG_RAW_API_BODIES が設定されている場合、成功した各 API レスポンスについてログに記録されます。

ファイルモード（OTEL_LOG_RAW_API_BODIES=file:<dir>）では、Claude Code は成功したレスポンスごとに <dir>/index.jsonl にも 1 行の JSON を追記します。この行には timestamp、session_id、query_source、model、request_id、message_id、message_uuid、request_file、response_file のフィールドが含まれます。これを読むと、テレメトリバックエンドにクエリを実行することなく、特定のトランスクリプトメッセージの背後にあるリクエストファイルとレスポンスファイルを見つけることができます。インデックスファイルには Claude Code v2.1.274 以降が必要です。

イベント名: claude_code.api_response_body

属性:

• すべての標準属性
• event.name: "api_response_body"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• body: ID、コンテンツブロック、使用量、停止理由を含む、JSON シリアライズされた Messages API のレスポンス。コンテンツの上限（デフォルトは 60 KB）で切り詰められます。拡張思考のコンテンツは秘匿化されます。インラインモード（OTEL_LOG_RAW_API_BODIES=1）でのみ出力されます。
• body_ref: 切り詰められていないボディを含む <dir>/<request_id>.response.json ファイルへの絶対パス。ファイルモード（OTEL_LOG_RAW_API_BODIES=file:<dir>）でのみ出力されます。
• body_length: 切り詰め前のボディの長さ。OTEL_LOG_RAW_API_BODIES=file:<dir> の場合は UTF-8 バイト、=1 の場合は UTF-16 コード単位です
• body_truncated: インラインでの切り詰めが発生した場合は "true"。ファイルモードの場合、および切り詰めが発生しなかった場合は含まれません。
• model: モデル識別子
• query_source: リクエストを発行したサブシステム
• request_id: API リクエスト ID（例: "req_011..."）。イベント相関属性で説明しています。
• request_body_id: このレスポンスが応答する api_request_body イベントの request_body_id。Claude Code v2.1.274 以降が必要です
• message.id: API がレスポンスに割り当てたメッセージ ID（レスポンスボディの id フィールド）。Claude Code v2.1.274 以降が必要です
• message.uuid: レスポンスの最後のトランスクリプトエントリの UUID。request_body_id と組み合わせることで、トランスクリプトのメッセージをその背後にあるリクエストボディとレスポンスボディに結び付けます。Claude Code v2.1.274 以降が必要です

ツール決定イベント

ツールの権限決定（承認/拒否）が行われたときにログに記録されます。

イベント名: claude_code.tool_decision

属性:

• すべての標準属性
• event.name: "tool_decision"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• tool_name: ツールの名前（例: "Read"、"Edit"、"Write"、"NotebookEdit"）
• tool_use_id: このツール呼び出しの一意の識別子。フックに渡される tool_use_id と一致するため、OTel イベントとフックで取得したデータを関連付けることができます。
• decision: "accept" または "reject"
• tool_source: 常に含まれます。ツールの出自を示す、CLI が定める閉じた集合の値です。Claude Code v2.1.214 以降が必要です
  • "builtin": CLI 自身のツール
  • "mcp": 一般的な MCP サーバー
  • "sdk_host_builtin_mcp": Claude Desktop が所有するセッションにおける、Claude Desktop 自体に組み込まれたインプロセスサーバー。Claude Desktop は、自身のエントリポイント（claude-desktop、claude-desktop-3p、local-agent）のいずれかから開始したセッションが、ネストされた子セッションでない場合にそのセッションを所有します。Claude Code 自体が起動するセッションを含むネストされたセッションでは、これらのサーバーは "mcp" として報告されます
• source: 決定の出どころ:
  • "config": プロンプトを表示せずに自動的に決定されたもの。プロジェクト設定、ユーザーの個人設定の許可ルールまたは拒否ルール、エンタープライズの管理ポリシー、--allowedTools または --disallowedTools フラグ、アクティブな権限モード、同じ対話型 CLI セッション内の以前のプロンプトで付与されたセッションスコープの権限、またはツールが本質的に安全であることに基づきます。イベントには、これらのうちどのソースが一致したかは示されません。Claude Code は、権限プロンプトのリクエスト自体が失敗した場合にも "config" を報告します。たとえば、Agent SDK の canUseTool コールバックや --permission-prompt-tool ツールが無効な結果を返した場合や、リクエストの保留中に入力ストリームが閉じられた場合です。v2.1.216 より前は、Claude Code はこれらの失敗を "user_reject" として報告していました。
  • "hook": PreToolUse または PermissionRequest フックが決定を返したもの。
  • "user_permanent": ユーザーが権限プロンプトで「Yes, and don't ask again for ...」を選択したときに出力されます。この選択により、ユーザーの個人設定に許可ルールが保存されます。対話型 CLI では、その選択自体に対してのみ出力され、保存されたルールに一致する以降の呼び出しでは代わりに "config" が出力されます。Agent SDK または非対話型の -p セッションでは、最初の選択と以降のルール一致の両方で "user_permanent" が出力されます。承認として扱われます。
  • "user_temporary": ユーザーが権限プロンプトで 1 回限りの承認として「Yes」を選択した場合、またはファイルの編集や読み取りのプロンプトでセッションの残りの間アクセスを許可するオプションを選択した場合に出力されます。対話型 CLI では選択自体に対してのみ出力され、そのセッションスコープの権限によって許可された以降の呼び出しでは代わりに "config" が出力されます。Agent SDK または非対話型の -p セッションでは、選択と以降の一致の両方で "user_temporary" が出力されます。承認として扱われます。
  • "user_abort": ユーザーが応答せずに権限プロンプトを閉じたときに出力されます。Agent SDK および非対話型の -p セッションでは、canUseTool または --permission-prompt-tool の権限リクエストが保留中にターンを中断した場合も含まれます。v2.1.216 より前は、Claude Code はその中断を "user_reject" として報告していました。拒否として扱われます。
  • "user_reject": プロンプトが表示されたときにユーザーが「No」を選択したときに出力されます。対話型 CLI では、その選択自体に対してのみ出力され、ユーザーの個人設定の拒否ルールに一致する呼び出しでは代わりに "config" が出力されます。Agent SDK または非対話型の -p セッションでは、個人設定の拒否ルールに一致する呼び出しで "user_reject" が出力されます。拒否として扱われます。
• tool_parameters（OTEL_LOG_TOOL_DETAILS=1 の場合）: ツール固有のパラメーターを含む JSON 文字列。ツール結果イベントと同じ形式ですが、git_commit_id などの実行後のフィールドは含まれません。権限決定が updatedInput を介してツール入力を書き換えた場合、承認された呼び出しでは値が tool_result と異なることがあります。decision が "reject" の場合にどのコマンドが拒否されたかを確認するには、この属性を使用してください。
  • "sdk_host_builtin_mcp" ツールの場合: ホストアプリケーションがこれらの名前を定義しているため、OTEL_LOG_TOOL_DETAILS がオフの場合でも mcp_server_name と mcp_tool_name が含まれます。これらがなければ、これらの組み込みサーバーへの拒否された呼び出しをデフォルトのストリームで特定できなくなります。ユーザーが設定した MCP サーバーの場合、イベントの tool_name は常にリテラルの "mcp_tool" であり、サーバー名とツール名はフラグがオンの場合にのみ tool_parameters に表示されます。引数の内容はどの場合もフラグが必要です。Claude Code v2.1.214 以降が必要です
  • Bash ツールの場合: bash_command、full_command、timeout、description、dangerouslyDisableSandbox を含みます。デスクトップアプリのワークスペース Bash ツールも tool_name を Bash として報告しますが、bash_command、full_command、timeout のみを含みます
  • MCP ツールの場合: mcp_server_name、mcp_tool_name を含みます
  • Skill ツールの場合: skill_name を含みます
  • Agent ツールまたは従来の Task ツールの場合: subagent_type を含みます

権限モード変更イベント

権限モードが変更されたときにログに記録されます。たとえば、Shift+Tab による切り替え、plan モードの終了、auto モードのゲートチェックなどです。

イベント名: claude_code.permission_mode_changed

属性:

• すべての標準属性
• event.name: "permission_mode_changed"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• from_mode: 以前の権限モード。例: "default"、"plan"、"acceptEdits"、"auto"、"bypassPermissions"
• to_mode: 新しい権限モード
• trigger: 変更の原因。"shift_tab"、"exit_plan_mode"、"auto_gate_denied"、"auto_opt_in" のいずれかです。遷移が SDK またはブリッジから発生した場合は含まれません

認証イベント

/login または /logout が完了したときにログに記録されます。

イベント名: claude_code.auth

属性:

• すべての標準属性
• event.name: "auth"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• action: "login" または "logout"
• success: "true" または "false"
• auth_method: 認証方法。"oauth" など
• error_category: アクションが失敗した場合のエラーの種類のカテゴリ。生のエラーメッセージが含まれることはありません
• status_code: アクションが HTTP エラーで失敗した場合の、文字列としての HTTP ステータスコード

MCP サーバー接続イベント

MCP サーバーが接続、切断、または接続に失敗したときにログに記録されます。

イベント名: claude_code.mcp_server_connection

属性:

• すべての標準属性
• event.name: "mcp_server_connection"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• status: "connected"、"failed"、"disconnected" のいずれか
• transport_type: サーバーのトランスポート。"stdio"、"sse"、"http" など
• server_scope: サーバーが設定されているスコープ。"user"、"project"、"local" など
• duration_ms: 接続試行の所要時間（ミリ秒）
• error_code: 接続が失敗した場合のエラーコード
• is_plugin: サーバーがプラグインによって提供されている場合は true、それ以外は false
• plugin_id_hash（is_plugin が true の場合）: プラグイン名とマーケットプレイスの安定したハッシュ。名前を公開せずにプラグインごとにイベントをグループ化するために使用します。Claude Code はプラグイン読み込みイベントで説明している方法でこれを計算します
• plugin.name（is_plugin が true の場合）: サーバーを提供するプラグインの名前。サードパーティのプラグインの場合、OTEL_LOG_TOOL_DETAILS=1 でない限り、これはリテラル文字列 "third-party" になります。これにより、デフォルトではサードパーティのプラグイン名がログに表示されないよう保護されます。Anthropic の公式ソースのプラグインは常に名前で識別されます。plugin_id_hash と plugin.name の属性は独自の監視バックエンドに送信され、Anthropic には送信されません
• server_name（OTEL_LOG_TOOL_DETAILS=1 の場合）: 設定されたサーバー名
• error（OTEL_LOG_TOOL_DETAILS=1 の場合）: 接続が失敗した場合の完全なエラーメッセージ

内部エラーイベント

Claude Code が予期しない内部エラーを捕捉したときにログに記録されます。エラークラス名と errno 形式のコードのみが記録されます。エラーメッセージとスタックトレースが含まれることはありません。このイベントは、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry に対して実行している場合、または DISABLE_ERROR_REPORTING が設定されている場合は出力されません。

イベント名: claude_code.internal_error

属性:

• すべての標準属性
• event.name: "internal_error"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• error_name: エラークラス名。"TypeError" や "SyntaxError" など
• error_code: エラーに存在する場合の Node.js の errno コード（"ENOENT" など）

プラグインインストールイベント

プラグインのインストールが完了したときにログに記録されます。claude plugin install CLI コマンドと対話型の /plugin UI の両方が対象です。

イベント名: claude_code.plugin_installed

属性:

• すべての標準属性
• event.name: "plugin_installed"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• marketplace.is_official: マーケットプレイスが Anthropic の公式マーケットプレイスの場合は "true"、それ以外は "false"
• install.trigger: "cli" または "ui"
• plugin.name: インストールされたプラグインの名前。サードパーティのマーケットプレイスの場合は、OTEL_LOG_TOOL_DETAILS=1 の場合にのみ含まれます
• plugin.version: マーケットプレイスのエントリで宣言されている場合のプラグインのバージョン。サードパーティのマーケットプレイスの場合は、OTEL_LOG_TOOL_DETAILS=1 の場合にのみ含まれます
• marketplace.name: プラグインのインストール元のマーケットプレイス。サードパーティのマーケットプレイスの場合は、OTEL_LOG_TOOL_DETAILS=1 の場合にのみ含まれます

プラグイン読み込みイベント

セッションの開始時に、有効化されているプラグインごとに 1 回ログに記録されます。インストール操作自体を記録する plugin_installed を補完するものとして、このイベントを使用してフリート全体でどのプラグインがアクティブかを把握できます。

イベント名: claude_code.plugin_loaded

属性:

• すべての標準属性
• event.name: "plugin_loaded"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• plugin.name: プラグインの名前。公式マーケットプレイスおよび組み込みバンドル以外のプラグインの場合、OTEL_LOG_TOOL_DETAILS=1 でない限り値は "third-party" になります
• marketplace.name: 判明している場合の、プラグインのインストール元のマーケットプレイス。plugin.name と同じ条件で "third-party" に秘匿化されます
• plugin.version: プラグインマニフェストのバージョン。名前が秘匿化されておらず、マニフェストでバージョンが宣言されている場合にのみ含まれます
• plugin.scope: プラグインの出自カテゴリ。"official"、"community"、"org"、"user-local"、"default-bundle" のいずれか
• enabled_via: プラグインが有効化された経緯。"default-enable"、"org-policy"、"admin-install"、"seed-mount"、"user-install" のいずれかです。"admin-install" の値は、Organization settings > Plugins & skills でプラグインが組織に対して必須または自動インストールに設定されていることを意味します。v2.1.246 より前は、Claude Code はこれらのプラグインを "user-install" または "seed-mount" として報告していました
• plugin_id_hash: プラグイン名とマーケットプレイスの決定論的なハッシュ。設定したエクスポーターにのみ送信されます。名前を記録せずに、フリート全体で読み込まれた個別のサードパーティプラグインの数をカウントできます。claude.ai から同期されたプラグインの場合、Claude Code は、claude.ai がそのプラグインについて報告するマーケットプレイス名、それがない場合は synced とプラグイン名を組み合わせてハッシュします。v2.1.246 より前は、Claude Code は claude.ai が報告するマーケットプレイス名をハッシュに使用していませんでした
• has_hooks: プラグインがフックを提供するかどうか
• has_mcp: プラグインが MCP サーバーを提供するかどうか
• host_owned_mcp: SDK ホストがこのプラグインの MCP 接続を管理しており、Claude Code がプラグインの MCP サーバー設定の読み取りをスキップした場合は true、それ以外は false。Claude Code v2.1.172 以降が必要です
• skill_path_count: プラグインが宣言するスキルディレクトリの数
• command_path_count: プラグインが宣言するコマンドディレクトリの数
• agent_path_count: プラグインが宣言するエージェントディレクトリの数
• safe_mode: セッションが --safe-mode で開始された場合は "true"、それ以外は "false"。safe モードでは、このイベントは設定されたインベントリのみを報告し、プラグインのコマンド、スキル、フック、MCP サーバーは読み込まれません。Claude Code v2.1.169 以降が必要です

スキル有効化イベント

スキルが呼び出されたときにログに記録されます。Claude が Skill ツールを通じて呼び出した場合と、ユーザーが / コマンドとして実行した場合の両方が対象です。

イベント名: claude_code.skill_activated

属性:

• すべての標準属性
• event.name: "skill_activated"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• skill.name: スキルの名前。ユーザー定義およびサードパーティのプラグインのスキルの場合、OTEL_LOG_TOOL_DETAILS=1 でない限り値はプレースホルダーの "custom_skill" になります
• invocation_trigger: スキルがトリガーされた方法（"user-slash"、"claude-proactive"、"nested-skill"）
• skill.source: スキルの読み込み元（例: "bundled"、"userSettings"、"projectSettings"、"plugin"）
• skill.kind: スキルがワークフロースキルの場合は "workflow"。それ以外の場合は含まれません
• plugin.name（OTEL_LOG_TOOL_DETAILS=1 の場合、またはプラグインが公式マーケットプレイスのものの場合）: スキルがプラグインによって提供されている場合の、所有元のプラグインの名前
• marketplace.name（OTEL_LOG_TOOL_DETAILS=1 の場合、またはプラグインが公式マーケットプレイスのものの場合）: スキルがプラグインによって提供されている場合の、所有元のプラグインのインストール元のマーケットプレイス

@ メンションイベント

Claude Code がプロンプト内の @ メンションを解決したときにログに記録されます。すべてのメンションでイベントが出力されるわけではありません。権限の拒否、サイズが大きすぎるファイル、PDF の参照添付、ディレクトリ一覧の取得失敗などの早期終了パスでは、ログに記録せずに戻ります。

イベント名: claude_code.at_mention

属性:

• すべての標準属性
• event.name: "at_mention"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• mention_type: メンションの種類（"file"、"directory"、"agent"、"mcp_resource"、"peer"）。"peer" の値は、ユーザーの他の Claude Code セッションのいずれかをメンションしたことを意味します。Claude Code v2.1.232 以降が必要です
• success: メンションが正常に解決されたかどうか（"true" または "false"）

API 再試行上限到達イベント

API リクエストが複数回の試行の後に失敗したときに 1 回ログに記録されます。最後の api_error イベントと一緒に出力されます。

イベント名: claude_code.api_retries_exhausted

属性:

• すべての標準属性
• event.name: "api_retries_exhausted"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• model: 使用されたモデル
• error: 最終的なエラーメッセージ
• status_code: 数値としての HTTP ステータスコード。HTTP 以外のエラーの場合は含まれません。
• total_attempts: 試行の合計回数
• total_retry_duration_ms: すべての試行にわたる合計の実経過時間
• speed: "fast" または "normal"

フック登録イベント

セッションの開始時に、設定されたフックごとに 1 回ログに記録されます。実行ごとの hook_execution_start および hook_execution_complete イベントを補完するものとして、このイベントを使用してフリート全体でどのフックがアクティブかを把握できます。

イベント名: claude_code.hook_registered

属性:

• すべての標準属性
• event.name: "hook_registered"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• hook_event: フックイベントの種類。"PreToolUse" や "PostToolUse" など
• hook_type: フックの実装の種類。"command"、"prompt"、"mcp_tool"、"http"、"agent" のいずれか
• hook_source: フックが定義されている場所。"userSettings"、"projectSettings"、"localSettings"、"flagSettings"、"policySettings"、"pluginHook" のいずれか
• safe_mode: セッションが --safe-mode で開始された場合は "true"、それ以外は "false"。Claude Code v2.1.169 以降が必要です
• hook_matcher（OTEL_LOG_TOOL_DETAILS=1 の場合）: フック設定で matcher が設定されている場合の matcher 文字列
• plugin.name（hook_source が "pluginHook" の場合）: フックを提供するプラグインの名前。公式マーケットプレイスおよび組み込みバンドル以外のプラグインの場合、OTEL_LOG_TOOL_DETAILS=1 でない限り値は "third-party" になります
• plugin_id_hash（hook_source が "pluginHook" の場合）: プラグイン名とマーケットプレイスの決定論的なハッシュ。設定したエクスポーターにのみ送信されます。名前を記録せずに、フックを提供する個別のプラグインの数をカウントできます。Claude Code はプラグイン読み込みイベントで説明している方法でこれを計算します

フック実行開始イベント

フックイベントに対して 1 つ以上のフックの実行が開始されたときにログに記録されます。

イベント名: claude_code.hook_execution_start

属性:

• すべての標準属性
• event.name: "hook_execution_start"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• hook_event: フックイベントの種類。"PreToolUse" や "PostToolUse" など
• hook_name: matcher を含む完全なフック名。"PreToolUse:Write" など
• num_hooks: 一致したフックコマンドの数
• managed_only: 管理ポリシーのフックのみが許可されている場合は "true"
• hook_source: "policySettings" または "merged"
• safe_mode: セッションが --safe-mode で開始された場合は "true"、それ以外は "false"。Claude Code v2.1.169 以降が必要です
• hook_definitions: JSON シリアライズされたフック設定。詳細なベータトレースと OTEL_LOG_TOOL_DETAILS=1 の両方が有効な場合にのみ含まれます

フック実行完了イベント

フックイベントに対するすべてのフックが完了したときにログに記録されます。

イベント名: claude_code.hook_execution_complete

属性:

• すべての標準属性
• event.name: "hook_execution_complete"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• hook_event: フックイベントの種類
• hook_name: matcher を含む完全なフック名
• num_hooks: 一致したフックコマンドの数
• num_success: 正常に完了した数
• num_blocking: ブロッキングの決定を返した数
• num_non_blocking_error: ブロックせずに失敗した数
• num_cancelled: 完了前にキャンセルされた数
• total_duration_ms: 一致したすべてのフックの実経過時間
• stdout_chars: 成功した一致フック全体の stdout の合計文字数。Claude Code v2.1.280 以降が必要です
• additional_context_chars: 一致したフックが返した additionalContext の合計文字数。Claude Code v2.1.280 以降が必要です
• system_message_chars: 一致したフックが返した systemMessage の合計文字数。Claude Code v2.1.280 以降が必要です
• initial_user_message_chars: 一致したフックが返した initialUserMessage の合計文字数。Claude Code v2.1.280 以降が必要です
• num_outputs_persisted: 10,000 文字の上限を超えたために Claude Code がファイルに保存したフック出力の数。Claude Code v2.1.280 以降が必要です
• managed_only: 管理ポリシーのフックのみが許可されている場合は "true"
• hook_source: "policySettings" または "merged"
• safe_mode: セッションが --safe-mode で開始された場合は "true"、それ以外は "false"。Claude Code v2.1.169 以降が必要です
• hook_definitions: JSON シリアライズされたフック設定。詳細なベータトレースと OTEL_LOG_TOOL_DETAILS=1 の両方が有効な場合にのみ含まれます

フックプラグインメトリクスイベント

公式マーケットプレイスのプラグインのフックが呼び出しごとのメトリクスを出力したときにログに記録されます。これを出力できるのは、Anthropic の公式マーケットプレイスからインストールされたプラグインのみです。サードパーティのマーケットプレイスのプラグインやユーザーが設定したフックは、このイベントに出力しません。このイベントを使用すると、検出率、コスト、所要時間などのプラグインの挙動を独自のオブザーバビリティスタックから監視できます。

イベント名: claude_code.hook_plugin_metrics

属性:

• すべての標準属性
• event.name: "hook_plugin_metrics"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• plugin_id: <name>@<marketplace> 形式のプラグイン識別子
• hook_event: メトリクスを出力したフックイベントの種類
• プラグインが出力する最大 20 個のメトリクスキー。名前は ^[a-z][a-z0-9_]{0,39}$ に一致します。値はブール値または数値です。

コンテキスト圧縮イベント

会話のコンテキスト圧縮が完了したときにログに記録されます。

イベント名: claude_code.compaction

属性:

• すべての標準属性
• event.name: "compaction"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• trigger: "auto" または "manual"
• success: "true" または "false"
• duration_ms: 圧縮の所要時間
• pre_tokens: 圧縮前のおおよそのトークン数
• post_tokens: 圧縮後のおおよそのトークン数
• error: 圧縮が失敗した場合のエラーメッセージ
• precompute_reuse: trigger が "manual" の場合にのみ設定されます。自動圧縮では、コンテキストウィンドウがいっぱいになる前にバックグラウンドで要約を準備できます。この属性は、/compact がその準備済みの要約を再利用したかどうかを記録します。"hit" は再利用されたことを意味し、"miss_custom_instructions"、"miss_hook"、"miss_not_ready" は代わりに新しい要約が計算された理由を示します。Claude Code v2.1.153 以降が必要です

サブエージェント完了イベント

サブエージェントが終了し、その結果を起動元の会話に返したときに記録されます。サブエージェントの種類ごとにツール使用と実行時間を集計する用途に使用します。トークンやコストを集計する場合は、query_source を "subagent" でフィルタリングした トークンカウンターとコストカウンターを使用してください。このイベントの total_tokens は最後のリクエストのみを対象とするためです。"subagent" カテゴリには、エージェントベースのフックからのリクエストも含まれますが、これらはサブエージェントイベントを出力しません。

イベント名: claude_code.subagent_completed

属性:

• すべての標準属性
• event.name: "subagent_completed"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• agent_type: サブエージェントの種類。組み込みエージェント名と公式マーケットプレイスのプラグインからのエージェントはそのまま表示されます。その他のエージェント名は、OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り "custom" に置き換えられます
• agent.source: エージェント定義の取得元。built-in、plugin、またはカスタムエージェントを定義した設定ソース（userSettings や projectSettings など）
• is_built_in: サブエージェントが組み込みのエージェントタイプかどうか
• is_async: サブエージェントがバックグラウンドで実行されたかどうか
• total_tokens: サブエージェントの最後の API リクエストのトークン量。その 1 つのリクエストの入力、キャッシュ作成、キャッシュ読み取り、出力トークンであり、完了時点のサブエージェントのコンテキストサイズにおおよそ相当します。実行全体の合計ではありません
• total_tool_uses: サブエージェントが実行全体で行ったツール呼び出しの数
• duration_ms: 実行時間（ミリ秒）
• model: サブエージェントの実行に解決されたモデル
• final_model: サブエージェントの最終応答を生成したモデル。フォールバックなど実行途中で切り替えがあった場合は model と異なります。Claude Code v2.1.212 以降が必要です
• model_swapped: サブエージェントのリクエストを複数のモデルが処理したかどうか。Claude Code v2.1.212 以降が必要です
• plugin_id_hash、plugin.name: プラグインが提供するエージェントの場合に存在します。公式マーケットプレイスのプラグイン名はそのまま表示されます。その他のプラグイン名は、OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り "third-party" に置き換えられます

フィードバックアンケートイベント

セッション品質アンケートが表示されたとき、または回答されたときに記録されます。アンケートで収集される内容とその制御方法については、セッション品質アンケートを参照してください。

イベント名: claude_code.feedback_survey

属性:

• すべての標準属性
• event.name: "feedback_survey"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• event_type: アンケートのライフサイクルイベント。例: "appeared"、"responded"、"transcript_prompt_appeared"
• appearance_id: 1 つのアンケートインスタンスに対して出力されたイベントを結び付ける一意の ID
• survey_type: イベントを生成したアンケート。"session" は「Claude の調子はどうですか？」という評価プロンプトです
• response: responded イベントにおけるユーザーの選択
• enabled_via_override: CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL が設定されている場合は true。文字列ではなくブール値として出力されます。session アンケートイベントに存在します。この属性でフィルタリングすると、上書きがフリート全体に適用されていることを確認できます

保持期間スイープイベント

保持期間クリーンアップスイープの実行ごとに 1 回記録されます。このスイープは、cleanupPeriodDays 設定よりも古いセッショントランスクリプトやその他のアプリケーションデータを削除します。Claude Code はセッションごとに最大 1 回、バックグラウンドでスイープを実行し、何も削除しなかった実行でもイベントを出力します。同じマシン上のいずれかのセッションで過去 24 時間以内に Claude Code がスイープを実行していた場合、このセッションのスイープは少なくとも 10 分遅延されるため、それより早く終了したセッションは何も出力しません。claude -p を --bare とともに実行した場合、Claude Code はスイープを実行せず、何も出力しません。

このページのすべての OTel イベントと同様に、このイベントは設定したテレメトリバックエンドにのみ送信されます。Claude Code v2.1.227 以降が必要です。

Claude Code が保持期間を安全に判断できない場合、スイープを一時停止し、result を "skipped" に設定し、skip_reason を付けてイベントを出力します。管理設定で cleanupPeriodDays が設定されている場合は、管理設定の値によって保持期間が固定され、より優先度の低いスコープの設定ファイルが壊れていたり無効であったりしてもスイープは実行されます。managed-settings.json 自体を読み取れない場合、管理層がサーバー管理設定や壊れたファイルの隣にある managed-settings.d/ ドロップインなど、他の場所から cleanupPeriodDays を提供しない限り、Claude Code はスイープを一時停止します。削除カウンター属性は、result が "complete" の場合にのみ存在します。

イベント名: claude_code.retention_sweep

属性:

• すべての標準属性
• event.name: "retention_sweep"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• result: スイープが実行された場合は "complete"、Claude Code が一時停止した場合は "skipped"
• period_days: マージされた設定の cleanupPeriodDays の値（日数）。どのソースでも設定されていない場合は 30。skipped イベントでは、Claude Code が読み取れた設定ソースから算出した、スイープが使用するはずだった値
• used_default: 読み取り可能な設定ソースのいずれでも cleanupPeriodDays が設定されていない場合は "true"、それ以外は "false"。complete イベントでは、"true" は 30 日のデフォルトが適用されたことを意味します
• skip_reason: Claude Code がスイープを一時停止した理由。result が "skipped" の場合にのみ存在します:
  • "user_source_disabled": --setting-sources フラグや SDK の settingSources オプションなどによってユーザー設定が除外されており、有効なソースのいずれも cleanupPeriodDays を提供していない
  • "settings_unknowable": 設定ファイルを読み取りまたは解析できなかったため、cleanupPeriodDays または desktopSessionCleanupPeriodDays が Claude Code から見えない値に設定されている可能性がある
  • "settings_invalid_key_set": 設定に検証エラーがあり、かつ cleanupPeriodDays または desktopSessionCleanupPeriodDays が明示的に設定されているため、デフォルトにフォールバックするとその設定に反してファイルを削除または保持してしまう可能性がある
• transcripts_deleted: スイープが削除したセッショントランスクリプト（最上位の ~/.claude/projects/*/*.jsonl ファイル）の数
• transcripts_exempted_desktop: 保持期間を過ぎているものの、Claude Desktop と Cowork のルールによりスイープが保持したトランスクリプトの数。これらは files_past_cutoff にはカウントされません。Claude Code v2.1.248 以降が必要です
• session_files_deleted: セッションファイルスイープが削除したアーティファクトの数。トランスクリプトに加え、サイドカー、録画、ツール結果などのセッションごとの付随ファイルを含みます
• artifacts_deleted: スイープが対象とするデータディレクトリ全体で削除した項目の合計（セッションファイルを含む）。一部のスイープは削除したディレクトリツリー全体を 1 項目としてカウントし、いくつかのクリーンアップパスはカウンターに加算されないため、この値は正確なファイル数ではなく下限値として扱ってください
• files_retained_fresh: 検査されたものの、まだ保持期間内であるためそのまま残されたファイル。ファイル単位のスイープのみがこれらをカウントするため、この値は下限値です。ゼロ以外の値は通常の定常状態です
• files_past_cutoff: 保持期間より古いものの、権限エラーやファイルが開かれたままであることなどが原因でスイープが削除に失敗したファイル。ゼロより大きい値は、設定された保持期間を超えてファイルが残ったことを意味します。ただし、ディレクトリ全体の削除に失敗した場合は代わりに error_count にカウントされるため、ゼロであってもそのようなファイルがないことの証明にはなりません
• error_count: ファイルの一覧取得または削除中にスイープが遭遇したエラーの数

管理設定解決イベント

セッションが解決した管理設定とともに記録されます。セッション開始時に 1 回、セッション中に管理設定またはポリシーヘルパーの状態が変化したときに再度、そして error.type 属性に列挙されている理由のいずれかにより Claude Code が起動を拒否するかセッションを終了したときに記録されます。 このイベントを使用して、予期しない管理ソースで実行されているマシン、ポリシーヘルパーが失敗しているマシン、およびマシンが起動を拒否した理由を特定できます。 Claude Code v2.1.274 以降が必要です。

デフォルトでは、このイベントには管理ソースとポリシーヘルパーの状態が含まれますが、設定自体は含まれません。編集済みの managed_settings.settings 属性と managed_settings.resolved_sha256 ダイジェストを追加するには、OTEL_LOG_MANAGED_SETTINGS=1 を設定します:

• 管理設定、ユーザー設定、または --settings の env ブロック、あるいは Claude Code を起動する環境で設定してください。プロジェクト設定やローカル設定の値では有効になりません。クローンしたリポジトリがこれらを書き込めるためです。
• サーバー管理設定では、セキュリティ承認ダイアログを表示せずにこれを設定できます。この変数は、組織がすでに受け取っているイベントに、組織自身の編集済みポリシーを追加するだけだからです。

信頼していないフォルダーでの対話型セッションでは、Claude Code は拒否イベントをエクスポートしません。

イベント名: claude_code.managed_settings_resolved

属性:

• すべての標準属性

• event.name: "managed_settings_resolved"

• event.timestamp: ISO 8601 タイムスタンプ

• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています

• managed_settings.trigger: セッション開始時のイベントの場合は "startup"、セッションの後半で管理設定またはポリシーヘルパーの状態が変化した場合は "change"、管理設定ポリシーによってセッションが停止された場合は "refused"。Claude Code は、最後に送信したイベントと属性が異なる場合にのみ change イベントを送信します。設定値の変更は、OTEL_LOG_MANAGED_SETTINGS がオフの場合でもカウントされます

• error.type: Claude Code がセッションを停止した理由。refused イベントにのみ存在します:

  • "helper_failed": ポリシーヘルパーの実行が失敗した
  • "policy_invalid": 管理設定に Claude Code の起動を妨げるエラーが含まれている、または管理ソースが読み取り拒否以外の理由で読み込みに失敗したため、Claude Code が組織ログインやプロバイダーの強制を確認できない
  • "provider_not_allowed": セッションが、管理設定の allowedProviders リストで許可されていない API プロバイダーを使用する、またはプロバイダーのトラフィックを許可されていないホストに送信しようとしている。Claude Code v2.1.285 以降が必要です
  • "consent_rejected": ユーザーがサーバー管理設定のセキュリティ承認ダイアログを拒否した
  • "force_refresh_failed": forceRemoteSettingsRefresh が必要とする設定の取得に失敗した
  • "gateway_rejected": Claude apps ゲートウェイが管理設定の読み込みに HTTP 403 で応答した
  • "version_below_minimum": この Claude Code のバージョンが requiredMinimumVersion を下回っているか、requiredMaximumVersion を上回っている
  • "_OTHER": Claude apps ゲートウェイの管理設定の読み込みがその他の理由で失敗した

• managed_settings.sources: 少なくとも 1 つのポリシーキーを提供するすべての管理ソース。優先度の高い順に並び、first-wins の下でキーが有効にならないソースも含まれます。値は、MDM または OS レベルのポリシーの場合は "remote"、"plist"、または "hklm"、管理設定ファイルとドロップインの場合は "file"、埋め込みホストが設定を提供する場合は "parent"、Claude Code が Windows HKCU レジストリ値を読み取る場合は "hkcu" です。制御キーのみを含むソースや、Claude Code が読み取れなかったソースは一覧に含まれません。文字列の配列として出力され、ポリシーキーを提供する管理ソースがない場合は空になります

• managed_settings.source_behavior: Claude Code が読み取った managedSourcesBehavior の値で、"first-wins" または "merge"。どのソースでもこのキーが設定されていない場合は "first-wins"

• managed_settings.helper.state: 選択された MDM またはファイルソースが設定するポリシーヘルパーの状態:

  • "ok": ヘルパーの出力が管理設定として使用されている
  • "bad_path"、"not_a_file"、"exit_nonzero"、"timed_out"、"oversize"、"parse_failed"、"envelope_invalid"、または "schema_rejected": ヘルパーの最後の実行が失敗した。各ケースについてはヘルパーの失敗で説明しています
  • "none": ヘルパーが設定されていない、またはヘルパーを設定するソースが MDM ポリシーや管理設定ファイルではない

• managed_settings.helper.applied: ヘルパー自身の出力が管理設定として使用されている間は "output"、そうでない場合は "none"

• managed_settings.helper.entry: Claude Code が policyHelper を選択した場合は "policyHelper"。ヘルパーを選択しなかった場合は存在しません

• managed_settings.helper.path: ヘルパーに設定された path。Claude Code がヘルパーを選択した場合は、OTEL_LOG_MANAGED_SETTINGS が設定されているかどうかにかかわらず常に存在します

• managed_settings.resolved_sha256（OTEL_LOG_MANAGED_SETTINGS=1 の場合）: 編集前の解決済み管理設定の SHA-256。キーを再帰的にソートし、空白なしの JSON としてシリアル化したものです。同じダイジェストを持つマシンは同じポリシーで実行されています。短いポリシーは推測値をハッシュ化することで復元できてしまうため、Claude Code はオプトインした場合にのみダイジェストを送信します。管理設定が解決されなかった場合、および refused イベントでは存在しません

• managed_settings.settings（OTEL_LOG_MANAGED_SETTINGS=1 の場合）: 解決済み管理設定の名前と構造を、値を編集した JSON 文字列として表したもの。refused イベントでは存在しません。Claude Code は設定スキーマに基づいてこれを構築します:

  • スキーマで宣言されている設定名はエクスポートされ、宣言されていないキーは除外されます
  • ブール値、数値、およびスキーマが固定の選択肢に制限している文字列値（permissions.defaultMode など）はそのままエクスポートされます。sandbox.network.httpProxyPort と sandbox.network.socksProxyPort は "[REDACTED]" としてエクスポートされます
  • model、apiKeyHelper、すべての env の値、すべての URL、すべてのコマンドなど、その他のすべての文字列は "[REDACTED]" としてエクスポートされます
  • env の変数名やプラグイン ID など、マップのエントリ名はそのままエクスポートされます。vimInsertModeRemaps など、スキーマがエントリの型を定義していない設定は単一の "[REDACTED]" としてエクスポートされ、sandbox.ignoreViolations はコマンドパターンを除いたパスリストのリストとしてエクスポートされます
  • リストは長さを保持し、各エントリは同じルールで編集されます
  • permissions.allow、permissions.deny、または permissions.ask のルールは、ツールがこのバージョンの Claude Code に組み込まれている場合、または mcp__jira__create_issue のような mcp__ 参照である場合、Read([REDACTED]) のように内容を編集したツール名としてエクスポートされます。その他のルールは "[REDACTED]" としてエクスポートされます
  • フックも同じルールに従うため、type や timeout などの固定選択肢のフィールドや数値フィールドは表示されますが、各コマンド、URL、matcher、if 条件は "[REDACTED]" としてエクスポートされます

  たとえば、apiKeyHelper、2 つの env 変数、および拒否ルールを含む管理設定は、{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}} としてエクスポートされます。

  Claude Code は値を UTF-8 で 8 KB に切り詰め、切り詰められた値は有効な JSON ではありません

• managed_settings.settings_truncated（managed_settings.settings が存在する場合）: Claude Code が managed_settings.settings を 8 KB で切り詰めた場合は true、それ以外は false。文字列ではなくブール値として出力されます

メトリクスとイベントデータの解釈

エクスポートされたメトリクスとイベントは、さまざまな分析をサポートします:

使用状況監視

コスト監視

claude_code.cost.usage メトリクスは以下に役立ちます:

• チームまたは個人全体の使用トレンドを追跡する
• 最適化のための高使用セッションを特定する
• skill.name、plugin.name、および agent.name 属性を介して、特定のスキル、プラグイン、またはサブエージェントタイプへの支出を属性付けする

Claude Code は、ANTHROPIC_BASE_URL の背後にあるゲートウェイまたはプロキシが複数のフレーム全体で使用状況をプログレッシブにストリーミングする場合を含め、各ストリーミングレスポンスをコストおよびトークンメトリクスに対して正確に 1 回カウントします。v2.1.214 より前では、複数のフレームで使用状況を含むストリームは、claude_code.cost.usage と claude_code.token.usage を追加フレームごとにおよそ 1 つの追加フルリクエスト分だけ増加させました。

アラートとセグメンテーション

検討すべき一般的なアラート:

• コストスパイク
• 異常なトークン消費
• 特定のユーザーからの高いセッションボリューム

すべてのメトリクスは、標準属性 でセグメント化できます。model 属性は claude_code.token.usage、claude_code.cost.usage、および v2.1.172 以降の claude_code.lines_of_code.count で利用可能です。

コミットのモデル別の内訳は、1 つのセッションが複数のモデルにまたがる可能性があるため、session.id でトークンまたはコストメトリクスに対して結合することによってのみ概算できます。トークンまたはコスト側をフィルタリングして、query_source が "main" である行のみにしてください。これにより、補助的なリクエストとサブエージェントリクエストが、セッションのコミットをそれらを作成しなかったモデルに属性付けしません。

再試行枯渇の検出

Claude Code は失敗した API リクエストを内部的に再試行し、あきらめた後にのみ単一の claude_code.api_error イベントを出力するため、イベント自体がそのリクエストの終端信号です。中間再試行試行は個別のイベントとしてログされません。

イベントの attempt 属性は、試行の総数を記録します。CLAUDE_CODE_MAX_RETRIES はデフォルトで 10 で、15 で上限です。v2.1.199 以降では、CLAUDE_CODE_RETRY_WATCHDOG を設定してデフォルトを引き上げ、上限を削除できます。

リクエストが一時的なエラーのすべての再試行を枯渇させた場合、attempt はその有効な制限より 1 つ多くなります: デフォルトでは 11、ウォッチドッグが設定されていない限り 16 を超えることはありません。より低い値は、400 レスポンスなどの再試行不可能なエラー、または独自のより小さい再試行予算を持つ原因を示します。たとえば、Claude Code は AWS または Google Cloud 認証情報の読み込み失敗を最大 2 回再試行します。

セッションが回復したものと停止したものを区別するには、イベントを session.id でグループ化し、エラーの後に後続の api_request イベントが存在するかどうかを確認します。

イベント分析

イベントデータは Claude Code インタラクションに関する詳細な洞察を提供します:

ツール使用パターン: ツール結果イベントを分析して以下を特定します:

• 最も頻繁に使用されるツール
• ツール成功率
• 平均ツール実行時間
• ツールタイプ別のエラーパターン

パフォーマンス監視: API リクエスト期間とツール実行時間を追跡して、パフォーマンスボトルネックを特定します。

入力トークンを OpenTelemetry GenAI セマンティック規約にマッピングする

Claude Code は、入力トークン数を API レスポンスの usage ブロックに表示されるとおりにエクスポートするため、これらの値には プロンプトキャッシュ から読み取られたトークンやキャッシュに書き込まれたトークンは含まれません:

• claude_code.llm_request スパンと api_request イベントの input_tokens
• claude_code.token.usage メトリクスの "input" タイプ

Claude Code は gen_ai.usage.* 属性を設定しません。OpenTelemetry GenAI セマンティック規約 では、gen_ai.usage.input_tokens にはキャッシュから読み取られたトークンとキャッシュに書き込まれたトークンを含めるべきとされています。その合計を計算するには:

• スパンまたはイベントから: input_tokens、cache_read_tokens、cache_creation_tokens を合計します
• claude_code.token.usage メトリクスから: その "input"、"cacheRead"、"cacheCreation" タイプを合計します

規約では、キャッシュ読み取りとキャッシュ書き込みに対して個別の属性も定義されています:

• cache_read_tokens は gen_ai.usage.cache_read.input_tokens に対応します
• cache_creation_tokens は gen_ai.usage.cache_write.input_tokens に対応します。古いバージョンの規約ではキャッシュ書き込み属性の名前が gen_ai.usage.cache_creation.input_tokens となっているため、バックエンドが想定する名前を使用してください。

監査セキュリティイベント

OpenTelemetry イベントは Claude Code アクティビティの監査データソースです。すべてのイベントは、ツール呼び出し、MCP アクティビティ、権限決定をそれらをトリガーしたユーザーに結び付ける ID 属性を持ち、OTLP ログエクスポーターは、これらのイベントを OTLP レシーバーを持つセキュリティ情報およびイベント管理（SIEM）プラットフォーム、または SIEM にフォワードする OpenTelemetry Collector に配信できます。

属性アクションをユーザーに関連付ける

各イベントの 標準属性 には、認証されたユーザーの ID が含まれます：Claude アカウントでサインインしている場合は user.email、user.account_uuid、user.account_id、および organization.id、さらに クラウドセッション では、セッション自体の認証情報がそれらを持つ場合、user.id とセッションごとの session.id。user.id はインストールスコープの識別子です。ただし、Claude apps gateway セッションでは /login を通じてサインインしている場合、ゲートウェイが発行したトークンからの IdP サブジェクトです。

開発者が開始したセッションでは、MCP ツール呼び出し、Bash コマンド、ファイル編集はその開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または Claude apps gateway セッションでの開発者の IdP ID です。Claude Tag チャネルセッションでは、Claude はあなたの組織の 共有 ID として機能します。

Claude Code が直接 API キーで認証する場合、または Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、user.id と session.id のみが入力されます。これらのデプロイメントでは、OTEL_RESOURCE_ATTRIBUTES を使用してユーザー ID を自分で添付し、管理設定 ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません：標準属性 を参照して、それらのエクスポートが持つ ID を確認してください。

export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."

MCP アクティビティを監査する

完全なコール詳細で MCP サーバーアクティビティをキャプチャするには、ログエクスポーターを有効にし、OTEL_LOG_TOOL_DETAILS=1 を設定します。その後、各 MCP 操作は、標準 ID 属性と共にサーバー名、ツール名、呼び出し引数を含む構造化イベントを生成します：

OTEL_LOG_TOOL_DETAILS がない場合、これらのイベントは識別詳細を削除します：

• tool_result：mcp_server_scope と、ユーザー設定サーバーの場合はリテラル "mcp_tool" に編集された tool_name を保持し、引数コンテンツを省略します。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、tool_parameters 内の mcp_server_name/mcp_tool_name ペアも保持します。これは tool_decision と同じホスト作成例外です。Claude Code v2.1.214 以降が必要です
• tool_decision：tool_source と、ユーザー設定サーバーの場合はリテラル "mcp_tool" に編集された tool_name を保持し、引数コンテンツを省略します。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、tool_parameters 内の mcp_server_name/mcp_tool_name ペアも保持します。tool_source と名前ペアの両方に Claude Code v2.1.214 以降が必要です
• mcp_server_connection：server_name とエラーメッセージを省略しますが、is_plugin、plugin_id_hash、および plugin.name を保持し、Anthropic 以外のプラグイン名はリテラル "third-party" に編集されるため、プラグイン提供サーバーは詳細ログなしで区別可能なままです

セキュリティの質問をイベントにマップする

検出ルールを構築する場合、監視したいシグナルを検索し、対応するイベントと属性についてバックエンドをクエリします：

Claude Code は生のイベントストリームのみを出力します。異常検出、ベースライン化、セッション間の相関、アラートは SIEM または可観測性バックエンドの責任です。

SIEM にイベントを送信する

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT を SIEM の OTLP レシーバーに、または SIEM のネイティブ取り込み API にフォワードする OpenTelemetry Collector に指定します。以下の管理設定の例は、MCP および Bash 監査のための完全なツール詳細を有効にして、イベントのみをエクスポートします：

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_LOG_TOOL_DETAILS": "1",
    "OTEL_EXPORTER_OTLP_LOGS_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "https://siem.example.com:4318/v1/logs",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer your-siem-token"
  }
}

イベントが到着したことを確認するには、この設定で実行されているセッションでプロンプトを送信し、SIEM で claude_code.user_prompt イベントを確認します。何も到着しない場合は、claude --debug-file <path> で Claude Code を起動し、そのログで [3P telemetry] エクスポートエラーを確認します。

バックエンドに関する考慮事項

メトリクス、ログ、トレースバックエンドの選択により、実行できる分析のタイプが決まります:

メトリクスの場合

• 時系列データベース: レート計算、集約メトリクス
• カラムナーストア: 複雑なクエリ、一意のユーザー分析
• フル機能の可観測性プラットフォーム: 高度なクエリ、可視化、アラート

イベント/ログの場合

• ログ集約システム: 全文検索、ログ分析
• カラムナーストア: 構造化イベント分析
• フル機能の可観測性プラットフォーム: メトリクスとイベント間の相関

トレースの場合

分散トレースストレージとスパン相関をサポートするバックエンドを選択します:

• 分散トレースシステム: スパン可視化、リクエストウォーターフォール、レイテンシー分析
• フル機能の可観測性プラットフォーム: トレース検索とメトリクスおよびログとの相関

日次/週次/月次アクティブユーザー (DAU/WAU/MAU) メトリクスが必要な組織の場合は、効率的な一意値クエリをサポートするバックエンドを検討してください。

サービス情報

すべてのメトリクスとイベントは、以下のリソース属性でエクスポートされます:

• service.name: ターミナルセッションの場合は claude-code、Claude Desktop アプリのコードタブから開始されたセッションの場合は claude-code-desktop
• service.version: 現在の Claude Code バージョン、またはコードタブセッションの場合は Desktop アプリバージョン
• os.type: オペレーティングシステムタイプ (例: linux、darwin、windows)
• os.version: オペレーティングシステムバージョン文字列
• host.arch: ホストアーキテクチャ (例: amd64、arm64)
• wsl.version: WSL バージョン番号 (Windows Subsystem for Linux で実行している場合のみ存在)
• メーター名: com.anthropic.claude_code

service.name = claude-code でフィルタリングするコレクターパイプラインまたはダッシュボードがある場合は、コードタブセッションからのテレメトリもキャプチャするために、フィルターに claude-code-desktop を追加してください。

ROI 測定リソース

テレメトリセットアップ、コスト分析、生産性メトリクス、自動レポート生成を含む Claude Code の投資収益率（ROI）測定に関する包括的なガイドについては、Claude Code ROI 測定ガイドを参照してください。このリポジトリは、すぐに使用できる Docker Compose 設定、Prometheus と OpenTelemetry セットアップ、Linear などのツールと統合された生産性レポート生成テンプレートを提供します。

セキュリティとプライバシー

• OpenTelemetry エクスポートをバックエンドに送信することはオプトインであり、明示的な設定が必要です。Anthropic の個別の運用テレメトリと無効化方法については、データ使用を参照してください
• 生のファイルコンテンツとコードスニペットはメトリクスやイベントに含まれません。トレーススパンは別のデータパスです。以下の OTEL_LOG_TOOL_CONTENT の項目を参照してください
• OAuth 経由で認証されている場合、user.email はテレメトリ属性に含まれ、設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。これが組織にとって懸念事項である場合は、テレメトリバックエンドと協力してこのフィールドをフィルタリングまたは編集してください
• ユーザープロンプトコンテンツはデフォルトでは収集されません。プロンプト長のみが記録されます。プロンプトコンテンツを含めるには、OTEL_LOG_USER_PROMPTS=1 を設定してください。詳細なベータトレースでは、この変数はプロンプトテキストよりも広い範囲に達します。これは new_context スパン属性もゲートします。これは claude_code.llm_request スパンのツール結果を含みます
• アシスタント応答テキストはデフォルトでは収集されません。応答長のみが記録されます。応答テキストを含めるには、OTEL_LOG_ASSISTANT_RESPONSES=1 を設定してください。Claude Code からのすべての OpenTelemetry データと同様に、応答テキストは設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。この変数が設定されていない場合、OTEL_LOG_USER_PROMPTS がフォールバックとして使用されるため、プロンプトコンテンツなしで応答コンテンツが必要な場合は OTEL_LOG_ASSISTANT_RESPONSES=0 を設定してください
• ツール入力引数とパラメータはデフォルトではログに記録されません。これらを含めるには、OTEL_LOG_TOOL_DETAILS=1 を設定してください。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、tool_decision と tool_result は mcp_server_name/mcp_tool_name ペアを含みます。これはホストが作成した名前であり、フラグがオフの場合でも引数コンテンツではありません。この例外には Claude Code v2.1.214 以降が必要です。このデータは設定した OTEL エンドポイントにのみ送信され、Anthropic には送信されません。引数には機密値が含まれる可能性があるため、テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください。有効にすると：
  • tool_result と tool_decision イベントには、Bash コマンド、MCP サーバーとツール名、およびスキル名を含む tool_parameters 属性が含まれます。full_command などのフィールドは切り詰められずに出力されます
  • tool_result イベントには、ファイルパス、URL、検索パターン、およびその他の引数を含む tool_input 属性も含まれます。512 文字を超える個別の値は切り詰められ、合計は約 4 K 文字に制限されます
  • user_prompt イベントには、カスタム、プラグイン、および MCP コマンドの逐語的な command_name が含まれます
  • コストとトークンカウンターおよび api_request、api_error、および api_refusal イベントは、その属性の帰属に実際のエージェント、スキル、プラグイン、および MCP サーバーとツール名を含みます
  • トレーススパンには、同じ tool_input 属性と file_path などの入力派生属性が含まれ、tool_input と同じ切り詰めが行われます
• ツールコンテンツはデフォルトではトレーススパンにログに記録されません。これを含めるには、OTEL_LOG_TOOL_CONTENT=1 を設定してください。その後、claude_code.tool スパンは、生のファイルコンテンツ、Bash コマンド出力、および MCP ツール、WebFetch、WebSearch が返すものを含む tool.output スパンイベントを含みます。コンテンツは属性ごとにコンテンツ制限（デフォルトでは 60 KB）で切り詰められます。MCP ツール、WebFetch、WebSearch からの結果には Claude Code v2.1.283 以降が必要です。ツールコンテンツは new_context を通じてスパンに到達します。このゲートはスパンごとに異なります。テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください
• 生の Anthropic Messages API リクエストおよびレスポンスボディはデフォルトではログに記録されません。これらを含めるには、シェル、ユーザー設定、または管理設定で OTEL_LOG_RAW_API_BODIES を設定してください。プロジェクトおよびローカル設定では無視されます。ボディには、システムプロンプト、すべての以前のユーザーとアシスタントのターン、およびツール結果を含む完全な会話履歴が含まれるため、これを有効にすることは、他の OTEL_LOG_* コンテンツフラグが明かすすべてのことへの同意を意味します。Claude Code は、他の設定に関係なく、これらのボディから Claude の拡張思考コンテンツを常に編集します。設定する値は、Claude Code がボディを配信する方法を決定します：

  • =1 の場合、Claude Code は各 API 呼び出しに対して api_request_body と api_response_body ログイベントを出力します。イベントの body 属性は JSON シリアル化されたペイロードを含み、コンテンツ制限（デフォルトでは 60 KB）で切り詰められます

  • =file:<dir> の場合、Claude Code は切り詰められていないボディをそのディレクトリの .request.json と .response.json ファイルに書き込み、イベントはインラインボディの代わりに body_ref パスを含みます。テレメトリストリームではなく、ログコレクターまたはサイドカーでディレクトリを送信してください。

    各成功したレスポンスについて、Claude Code はそのディレクトリの index.jsonl に 1 行追加し、レスポンスファイルをそれを生成したリクエストファイルおよびそれが成為したトランスクリプトメッセージにリンクします。各行はメッセージコンテンツを含まず、API レスポンスボディイベントセクションがそのフィールドをリストします。インデックスファイルには Claude Code v2.1.274 以降が必要です

Amazon Bedrock での Claude Code の監視

Amazon Bedrock での Claude Code 使用状況監視ガイダンスの詳細については、Claude Code 監視実装（Amazon Bedrock）を参照してください。