動的ヘッダー

動的認証が必要なエンタープライズ環境では、ヘッダーを動的に生成するスクリプトを設定できます。動的ヘッダーは 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 を実行した後のデバッグログ
• stderr、-p で開始された非対話型セッション内

リフレッシュ動作

ヘッダーヘルパースクリプトはスタートアップ時に実行され、その後定期的に実行されてトークンリフレッシュをサポートします。デフォルトでは、スクリプトは 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 Code が Claude アプリゲートウェイ にサインインしている場合、CLI はゲートウェイセッションの認証済みアイデンティティでエクスポートをスタンプします。user.id は匿名インストール識別子ではなく IdP サブジェクト、user.email はサインイン済みメール、user.groups は IdP グループメンバーシップをコンマ区切り文字列として保持します。各エクスポートは identity.source: gateway-oidc も保持します。ゲートウェイアイデンティティは最後に適用されるため、OTEL_RESOURCE_ATTRIBUTES を通じて設定された user.* および identity.* キーはゲートウェイセッションで無視されます。

イベントには、以下の追加属性が含まれます。これらはメトリクスに添付されることはありません。無制限のカーディナリティを引き起こすためです。

• prompt.id: ユーザープロンプトと、次のプロンプトまでのすべての後続イベントを相関させる UUID。イベント相関属性 を参照。
• workspace.host_paths: デスクトップアプリで選択されたホストワークスペースディレクトリ。文字列配列として
• workflow.run_id: Workflow ツール実行に属するエージェントが発行する API およびツールイベントのプレフィックス wf_ の実行識別子。イベントを 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 を設定して、メトリクスとイベントをセッションのリポジトリの ID でタグ付けします。共有コレクターが使用状況をリポジトリごとに属性付けできるようにします。Claude Code v2.1.269 以降が必要です。

Claude Code はセッションごとに 1 回、リポジトリの origin リモートからこれらの属性を派生させます。1 つのリポジトリの HTTPS および SSH リモートは同じ値を生成します。

値は小文字に変換され、リモート URL からの認証情報、クエリ文字列、フラグメントは決して表示されません。セッションに origin リモートがない場合、リモートが URL 形状でない場合、または唯一の囲むリポジトリがホームディレクトリである場合、属性は省略されます。

OTEL_RESOURCE_ATTRIBUTES で宣言した vcs.* キーは、そのキーの派生値を置き換えます。vcs.repository.url.full を宣言した場合、Claude Code はリモートを読み取らず、宣言したキーのみを報告します。

属性は独自のエクスポーターにのみフローします。Anthropic のテレメトリはすべての vcs.* キーをドロップします。

メトリクス

Claude Code は以下のメトリクスをエクスポートします。Unit 列は各メトリクスに添付される OpenTelemetry ユニット文字列を示します。カウントメトリクスには何も含まれません。

prometheus が OTEL_METRICS_EXPORTER にリストされた唯一のエクスポーターである場合、Claude Code はエクスポートされたメトリクスから USD、tokens、s ユニットを省略して、スクレイプが有効な Prometheus テキスト形式のままになるようにします。メトリクス名は変わらず、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 リクエスト後にインクリメントされます。

属性:

• すべての 標準属性
• model: モデル識別子（例：「claude-sonnet-5」）
• query_source: リクエストを発行したサブシステムのカテゴリ。"main"、"subagent"、または "auxiliary" のいずれか
• speed: リクエストが高速モードを使用した場合は "fast"。それ以外の場合は存在しません
• effort: リクエストに適用された 努力レベル。"low"、"medium"、"high"、"xhigh"、または "max"。モデルが努力をサポートしていない場合は存在しません。
• agent.name: リクエストを発行したサブエージェントタイプ。組み込みエージェント名と公式マーケットプレイスプラグインのエージェントはそのまま表示されます。その他のユーザー定義エージェント名は "custom" に置き換えられます。OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り。リクエストが名前付きサブエージェントタイプによって発行されなかった場合は存在しません。
• skill.name: リクエストに対してアクティブなスキル。Skill ツール、/ コマンド、または生成されたサブエージェントによって継承されて設定されます。組み込み、バンドル、ユーザー定義、および公式マーケットプレイスプラグインスキル名はそのまま表示されます。サードパーティプラグインスキル名は "third-party" に置き換えられます。OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り。アクティブなスキルがない場合は存在しません。
• plugin.name: アクティブなスキルまたはサブエージェントを提供するプラグインの所有者。公式マーケットプレイスプラグイン名はそのまま表示されます。サードパーティプラグイン名は "third-party" に置き換えられます。OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り。スキルもサブエージェントも所有プラグインを持たない場合は存在しません。
• marketplace.name: 所有プラグインがインストールされたマーケットプレイス。公式マーケットプレイスプラグインに対してのみ発行されます。それ以外の場合は存在しません。
• mcp_server.name: このリクエストがツール結果を使用した MCP サーバー。組み込み、claude.ai プロキシ、および公式レジストリサーバー名はそのまま表示されます。ユーザー設定サーバー名は "custom" に置き換えられます。OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り。リクエストが MCP ツール結果を使用しなかった場合は存在しません。v2.1.222 より前では、Claude Code は MCP ツール呼び出し後のすべてのリクエストにこの属性を設定していました。ツール結果を使用したリクエストのみではなく、アップグレード後のダッシュボードがこれを集計すると段階的に低下します。
• mcp_tool.name: このリクエストがツール結果を使用した MCP ツール。mcp_server.name と同じ削除およびバージョン動作を持ちます。リクエストが MCP ツール結果を使用しなかった場合は存在しません。

トークンカウンター

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

属性:

• すべての 標準属性
• type: （"input"、"output"、"cacheRead"、"cacheCreation"）
• model: モデル識別子（例：「claude-sonnet-5」）
• query_source: リクエストを発行したサブシステムのカテゴリ。"main"、"subagent"、または "auxiliary" のいずれか
• speed: リクエストが高速モードを使用した場合は "fast"。それ以外の場合は存在しません
• 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 の実際の使用時間を追跡し、アイドル時間を除外します。このメトリクスは、入力や応答の読み取りなどのユーザーインタラクション中、およびツール実行や AI 応答生成などの CLI 処理中にインクリメントされます。

属性:

• すべての 標準属性
• 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 から始まり、そのプロセスの生涯にわたってカウントアップされます。/clear を横切ってカウントを続けます。これは新しい session.id を割り当てます。セッションをフォークせずに再開 する場合、セッションは session.id を保持しますが、それを再開したプロセスから event.sequence 値を取得するため、1 つのセッション内で、後のイベントが前のイベントより低い値を持つか、1 つを繰り返す可能性があります。セッションのイベントを順序付けするには、event.timestamp でソートし、タイムスタンプを共有するイベントを順序付けするために event.sequence を使用します。

メッセージレベルの再構成の場合、各イベントクラスはセッショントランスクリプトのフィールドと一致するキーを持ちます。トランスクリプトエントリ形式は Claude Code に内部的 であり、バージョン間で変わるため、これらのフィールドで結合するパイプラインはリリースで破損する可能性があります。結合を安定した契約ではなくバージョン固有として扱います。

• message.uuid on user_prompt、assistant_response、および api_response_body
• request_id on the API events、persisted as requestId on the transcript's assistant entries
• tool_use_id on tool_result and tool_decision events

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

ユーザーがプロンプトを送信するとログされます。

イベント名: 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。保持されたトランスクリプトエントリと一致します。コマンドディスパッチには存在しません。ゼロまたは多くのメッセージを生成できます。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: 応答の request-id ヘッダーからの Anthropic API リクエスト ID。API が返す場合のみ存在
• 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: 推定コスト（米ドルの百万分の一）。整数として発行
• duration_ms: リクエスト期間（ミリ秒）
• input_tokens: 入力トークン数
• output_tokens: 出力トークン数
• cache_read_tokens: キャッシュから読み取られたトークン数
• cache_creation_tokens: キャッシュ作成に使用されたトークン数
• request_id: 応答の request-id ヘッダーからの Anthropic API リクエスト ID。"req_011..." など。API が返す場合のみ存在。
• client_request_id: x-client-request-id リクエストヘッダーとして送信されるクライアント生成 UUID。存在する場合については イベント相関属性 テーブルを参照。Claude Code v2.1.214 以降が必要
• speed: 高速モードがアクティブであったかどうかを示す "fast" または "normal"
• query_source: リクエストを発行したサブシステム。"repl_main_thread"、"compact"、またはサブエージェント名など
• effort: リクエストに適用された 努力レベル。"low"、"medium"、"high"、"xhigh"、または "max"。モデルが努力をサポートしていない場合は存在しません。
• 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: 応答の request-id ヘッダーからの Anthropic API リクエスト ID。"req_011..." など。API が返す場合のみ存在。
• client_request_id: x-client-request-id リクエストヘッダーとして送信されるクライアント生成 UUID。タイムアウトや接続エラーなどの障害がサーバー request_id を生成しなかった場合でも利用可能です。存在する場合については イベント相関属性 テーブルを参照。Claude Code v2.1.214 以降が必要
• speed: 高速モードがアクティブであったかどうかを示す "fast" または "normal"
• query_source: リクエストを発行したサブシステム。"repl_main_thread"、"compact"、またはサブエージェント名など
• 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: 応答の request-id ヘッダーからの Anthropic API リクエスト ID。"req_011..." など。API が返す場合のみ存在。
• query_source: リクエストを発行したサブシステム。"repl_main_thread"、"compact"、またはサブエージェント名など。定義については api_request を参照。
• speed: 高速モード がアクティブな場合は "fast"、またはそれ以外の場合は "normal"
• attempt: 再試行試行番号。最初の試行は 1。
• effort: リクエストに適用された 努力レベル。モデルが努力をサポートしていない場合は存在しません。
• server_fallback_hop: API のサーバー側モデルフォールバックがこの拒否を別のモデルで既に再試行した場合は true。ユーザーはこの特定の拒否を見ませんでした。リクエストが拒否で終了した場合は false。単一のターンは、フォールバックモデルも拒否する場合、true ホップイベントと後の false 最終イベントの両方を発行できます。
• has_category: API 応答が stop_details.category の "cyber"、"bio"、"frontier_llm"、または "reasoning_extraction" を持つ場合は true。応答がカテゴリを持たないか、そのセット外の値を持つ場合は false。server_fallback_hop が true の場合は存在しません。ホップブロックは stop_details を持たないため。
• 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 は成功した応答ごとに 1 つの JSON 行を <dir>/index.jsonl に追加します。フィールド 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: JSON シリアル化された Messages API レスポンス。ID、コンテンツブロック、使用状況、停止理由を含みます。コンテンツ制限（デフォルト 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: 応答の request-id ヘッダーからの Anthropic API リクエスト ID。"req_011..." など。API が返す場合のみ存在。
• 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": ユーザーが権限プロンプトで「はい、今後このツールについて聞かないでください」を選択した場合に発行されます。これにより、許可ルールが個人設定に保存されます。インタラクティブ CLI では、その選択自体に対してのみ発行されます。後の呼び出しが保存されたルールと一致する場合は、代わりに "config" を発行します。Agent SDK または非インタラクティブ -p セッションでは、初期選択と後のルール一致の両方が "user_permanent" を発行します。受け入れとして扱われます。
  • "user_temporary": ユーザーが権限プロンプトで「はい」を選択した場合、またはファイル編集または読み取りプロンプトでセッションの残りの間アクセスを許可するオプションを選択した場合に発行されます。インタラクティブ 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": ユーザーがプロンプトで「いいえ」を選択した場合に発行されます。インタラクティブ CLI では、その選択自体に対してのみ発行されます。ユーザーの個人設定の拒否ルールと一致する呼び出しは、代わりに "config" を発行します。Agent SDK または非インタラクティブ -p セッションでは、個人設定の拒否ルールと一致する呼び出しは "user_reject" を発行します。拒否として扱われます。
• tool_parameters（OTEL_LOG_TOOL_DETAILS=1 の場合）: ツール固有のパラメーターを含む JSON 文字列。ツール結果イベント と同じ形状。updatedInput を介した権限決定がツール入力を書き直す場合、受け入れられた呼び出しの値は異なる可能性があります。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 サイクリング、プランモード終了、または自動モードゲートチェックから。

イベント名: 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" 値は、プラグインが 組織設定 > プラグイン で組織に対して必須またはオートインストールに設定されていることを意味します。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"。セーフモードでは、このイベントは設定されたインベントリのみを報告します。プラグインのコマンド、スキル、フック、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 の場合）: フック設定が設定されている場合のマッチャー文字列
• 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: マッチャーを含む完全なフック名。"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: マッチャーを含む完全なフック名
• 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 回。何も削除しない実行でもイベントを発行します。Claude Code が同じマシン上の任意のセッションで過去 24 時間にスイープを実行した場合、このセッションのスイープを少なくとも 10 分遅延させるため、より早く終了するセッションは何も発行しません。claude -p を --bare で実行する場合、Claude Code はスイープを実行せず、何も発行しません。

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

Claude Code が保持期間を安全に決定できない場合、スイープを一時停止し、result を "skipped" に設定し、skip_reason を持つイベントを発行します。管理設定 が cleanupPeriodDays を設定する場合、管理値は保持期間をピンし、下位優先度スコープの設定ファイルが破損または無効な場合でもスイープが実行されます。managed-settings.json 自体が読み取れない場合、Claude Code は 管理層 がサーバー管理設定などの他の場所から cleanupPeriodDays を提供しない限り、スイープを一時停止します。破損したファイルの横にある managed-settings.d/ ドロップイン。削除カウンター属性は 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。スキップされたイベントでは、スイープが使用した値。Claude Code が読み取れた設定ソースから計算
• used_default: 読み取り可能な設定ソースが cleanupPeriodDays を設定しない場合は "true"。それ以外の場合は "false"。完了イベントでは、"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 回、セッション中に管理設定または ポリシーヘルパー の状態が変わるときに再度、Claude Code がセッションを開始することを拒否するか、error.type 属性がリストする理由の 1 つでセッションを終了するときに。 このイベントを使用して、予期しない管理ソースで実行されているマシン、ポリシーヘルパーが失敗しているマシン、マシンが開始を拒否した理由を見つけます。 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 は組織ログイン強制をチェックできません
  • "consent_rejected": ユーザーがサーバー管理設定の セキュリティ承認ダイアログ を拒否しました
  • "force_refresh_failed": forceRemoteSettingsRefresh が必要とする設定フェッチが失敗しました
  • "gateway_rejected": Claude アプリゲートウェイ が管理設定ロードに HTTP 403 で応答しました
  • "version_below_minimum": この Claude Code バージョンは requiredMinimumVersion より下、または requiredMaximumVersion より上です
  • "_OTHER": Claude アプリゲートウェイ管理設定ロードが別の理由で失敗しました

• managed_settings.sources: ポリシーキー を少なくとも 1 つ配信するすべての管理ソース。優先度が最も高い順。first-wins の下で効果を持たないソースを含む。値は "remote"、"plist" または "hklm" は MDM または OS レベルのポリシー、"file" は管理設定ファイルおよびドロップイン、"parent" は 埋め込みホスト が設定を提供する場合、"hkcu" は Claude Code が 読み取る 場合の Windows 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__ 参照（mcp__jira__create_issue など）である場合、そのツール名としてエクスポートされます。その他のルールは "[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 は値を 8 KB の UTF-8 で切り詰め、切り詰められた値は有効な 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 イベントは 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 セッションでは、ゲートウェイが発行したトークンからの IdP サブジェクトです。

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

Claude Code が直接 API キーで認証する場合、または Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、user.id と session.id のみが入力されます。これらのデプロイメントでは、OTEL_RESOURCE_ATTRIBUTES を使用してユーザー ID を自分で添付し、管理設定 ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません：CLI は 標準属性 で説明されているように、IdP 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 を実行し、デバッグログで [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 が含まれます
  • トレーススパンには、同じ tool_input 属性と file_path などの入力派生属性が含まれ、tool_input と同じ切り詰めが行われます
• ツールコンテンツはデフォルトではトレーススパンにログに記録されません。これを含めるには、OTEL_LOG_TOOL_CONTENT=1 を設定してください。その後、claude_code.tool スパンは、ファイルの生コンテンツと Bash コマンド出力を含む tool.output スパンイベントを含みます。これは属性ごとのコンテンツ制限（デフォルトでは 60 KB）で切り詰められます。ツールコンテンツは 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）を参照してください。