監視

​

クイックスタート

# 1. テレメトリを有効にする
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# 2. エクスポーターを選択する (両方はオプション - 必要なものだけを設定してください)
export OTEL_METRICS_EXPORTER=otlp       # オプション: otlp、prometheus、console、none
export OTEL_LOGS_EXPORTER=otlp          # オプション: otlp、console、none

# 3. OTLP エンドポイントを設定する (OTLP エクスポーター用)
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 4. 認証を設定する (必要な場合)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# 5. デバッグ用: エクスポート間隔を短縮し、本番環境での使用に向けてリセットしてください
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 秒 (デフォルト: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5 秒 (デフォルト: 5000ms)

# 6. Claude Code を実行する
claude

​

管理者設定

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer example-token"
  }
}

​

管理設定が OTLP 宛先をロックする方法

• エンドポイント：OTEL_EXPORTER_OTLP_ENDPOINT を設定すると、Claude Code はすべての開発者設定のシグナル別エンドポイントを削除します。開発者は 1 つのシグナルを別のコレクターにポイントできないため、管理設定でシグナル別エンドポイント変数も設定する必要はありません。
• プロトコル：OTEL_EXPORTER_OTLP_PROTOCOL を設定すると、Claude Code はすべての開発者設定のシグナル別プロトコルを削除します。
• 認証情報：OTEL_EXPORTER_OTLP_HEADERS、OTEL_EXPORTER_OTLP_CLIENT_KEY、または OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE を設定すると、Claude Code はその変数の開発者設定のシグナル別バージョンと、すべての開発者設定のエンドポイント変数（汎用またはシグナル別）を削除します。これらの認証情報が管理設定で選択されていないコレクターに到達するのを防ぐためです。
• エクスポーターセレクター：OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER、およびベータ版の OTEL_TRACES_EXPORTER は通常のキーごとの優先順位に従います。開発者の設定はシグナルを無効にするか、コンソールエクスポーターに切り替えることができるため、ロックが必要な場合は管理設定でセレクターも設定してください。管理ソース全体で、OTEL_LOGS_EXPORTER はテレメトリユニットに従い、他の 2 つのセレクターはキーごとにマージされます。Claude Code v2.1.223 以降が必要です。
• ベータ版トレーシングエンドポイント：詳細ベータ版トレーシングがアクティブな場合、Claude Code はログとトレースをログおよびトレースエクスポーターを通じてではなく BETA_TRACING_ENDPOINT にエクスポートします。したがって、Claude Code は以下の管理設定のいずれかがシグナルの宛先を決定するたびに、開発者設定の BETA_TRACING_ENDPOINT を削除します：
  • 汎用またはログ/トレースエンドポイントまたは認証情報
  • otelHeadersHelper
  • none、console、または空に設定されたログまたはトレースエクスポーターセレクター。これらの値はシグナルをコレクターから外します
  • CLAUDE_CODE_ENABLE_TELEMETRY がオフ
  メトリクスのみのエンドポイントまたは認証情報は削除しません。v2.1.251 より前では、開発者設定の BETA_TRACING_ENDPOINT は、管理設定がコレクターをピン留めしている場合でも、詳細ベータ版トレーシングがエクスポートするログとトレースをリダイレクトしていました。

​

設定の詳細

​

一般的な設定変数

​

mTLS 認証

​

メトリクスカーディナリティ制御

​

トレース（ベータ）

​

スパン階層

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (詳細なベータトレースが必要)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (Agent ツール) サブエージェント claude_code.llm_request / claude_code.tool スパン

​

スパン属性

• Read、Edit、Write、Bash、WebFetch、WebSearch、および MCP ツール以外のツールへの呼び出し
• ファイルテキスト以外を返す Read（画像、PDF、または内容が変更されていないファイルの再読み込みなど）
• OTEL_LOG_TOOL_DETAILS=1 も設定していない限り、Edit または Write 呼び出し
• Claude Code がターンを中断してキューに入れたメッセージをすぐに送信している間に実行していた WebFetch または WebSearch 呼び出し。Claude はその結果をツールスパンが終了した後に受け取ります

​

動的ヘッダー

​

設定の設定

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

​

スクリプト要件

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

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

​

リフレッシュ動作

​

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

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

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

export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

​

設定例

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

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_METRICS_EXPORTER=prometheus

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 からのテレメトリ

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

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

​

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

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

​

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

​

標準属性

• 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 以降が必要

​

リポジトリ属性

​

メトリクス

​

メトリクスの詳細

​

セッションカウンター

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

​

コード行カウンター

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

​

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

• すべての標準属性

​

コミットカウンター

• すべての標準属性

​

コストカウンター

• すべての標準属性
• model: モデル識別子（例：「claude-sonnet-5」）
• query_source: リクエストを発行したサブシステムのカテゴリ。"main"、"subagent"、または "auxiliary" のいずれか
• speed: リクエストが高速モードを使用した場合は "fast"。それ以外の場合は不在
• effort: リクエストに適用された努力レベル。"low"、"medium"、"high"、"xhigh"、または "max"。Claude Code が努力レベルを送信しない場合（例：努力をサポートしないモデル）は不在。
• 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 ツール結果を消費しなかった場合は不在。

​

トークンカウンター

• すべての標準属性
• 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 属性。定義と難読化動作についてはコストカウンターを参照。

​

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

• すべての標準属性
• 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" を返します。

​

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

• すべての標準属性
• type: キーボードインタラクションの場合は "user"、ツール実行と AI レスポンスの場合は "cli"

​

イベント

​

イベント相関属性

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

​

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

• すべての標準属性
• 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 として報告されます

​

アシスタントレスポンスイベント

• すべての標準属性
• 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"、またはサブエージェント名など

​

ツール結果イベント

• すべての標準属性
• 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 リクエストイベント

• すべての標準属性
• 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: API リクエスト ID。"req_011..." など。イベント相関属性で説明。
• 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"。Claude Code が努力レベルを送信しない場合（例：努力をサポートしないモデル）は不在。
• agent.name、skill.name、plugin.name、marketplace.name、mcp_server.name、mcp_tool.name: リクエストのスキル、プラグイン、エージェント、MCP 属性。定義と難読化動作についてはコストカウンターを参照。

​

API エラーイベント

• すべての標準属性
• 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"
• query_source: リクエストを発行したサブシステム。"repl_main_thread"、"compact"、またはサブエージェント名など
• effort: リクエストに適用された努力レベル。Claude Code が努力レベルを送信しない場合（例：努力をサポートしないモデル）は不在。
• agent.name、skill.name、plugin.name、marketplace.name、mcp_server.name、mcp_tool.name: リクエストのスキル、プラグイン、エージェント、MCP 属性。定義と難読化動作についてはコストカウンターを参照。

​

API 拒否イベント

• すべての標準属性
• 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"、またはそれ以外の場合は "normal"
• attempt: 再試行試行番号。最初の試行は 1。
• effort: リクエストに適用された努力レベル。Claude Code が努力レベルを送信しない場合（例：努力をサポートしないモデル）は不在。
• server_fallback_hop: API のサーバー側モデルフォールバックがこの拒否を別のモデルで既に再試行した場合は true。ユーザーはこの特定の拒否を見ませんでした。リクエストが拒否で終了した場合は false。フォールバックモデルも拒否する場合、1 つのターンは 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 リクエストボディイベント

• すべての標準属性
• 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 レスポンスボディイベント

• すべての標準属性
• 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: 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 以降が必要

​

ツール決定イベント

• すべての標準属性
• 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 は、権限プロンプトリクエスト自体が失敗した場合（例：Agent SDK の canUseTool コールバックまたは --permission-prompt-tool ツールが無効な結果を返す場合、または入力ストリームがリクエスト保留中に閉じる場合）も "config" を報告します。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 文字列。ツール結果イベント と同じ形状。git_commit_id などの実行後フィールドを除きます。受け入れられた呼び出しの場合、権限決定が updatedInput を通じてツール入力を書き直す場合、値は tool_result と異なる可能性があります。decision が "reject" の場合、どのコマンドが拒否されたかを確認するにはこの属性を使用します。
  • "sdk_host_builtin_mcp" ツール用: mcp_server_name および mcp_tool_name は OTEL_LOG_TOOL_DETAILS がオフの場合でも含まれます。ホストアプリケーションがこれらの名前を定義するため。これらなしでは、これらの組み込みサーバーの 1 つへの拒否された呼び出しはデフォルトストリームで属性付けできません。ユーザー設定 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 を含みます

​

権限モード変更イベント

• すべての標準属性
• 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 またはブリッジから遷移が発生する場合は不在。

​

認証イベント

• すべての標準属性
• 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 サーバー接続イベント

• すべての標準属性
• 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 の場合）: 接続が失敗した場合の完全なエラーメッセージ

​

内部エラーイベント

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

​

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

• すべての標準属性
• 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 が設定されている場合のみ含まれます

​

プラグインロードイベント

• すべての標準属性
• 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"。セーフモードでは、このイベントは設定されたインベントリのみを報告します。プラグインのコマンド、スキル、フック、MCP サーバーは読み込まれません。Claude Code v2.1.169 以降が必要

​

スキル有効化イベント

• すべての標準属性
• 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 の場合またはプラグインが公式マーケットプレイスから）: スキルがプラグインによって提供される場合、所有プラグインがインストールされたマーケットプレイス

​

@ メンションイベント

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

​

API 再試行枯渇イベント

• すべての標準属性
• 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"

​

フック登録イベント

• すべての標準属性
• 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 はプラグインロードイベントで説明されているように計算します

​

フック実行開始イベント

• すべての標準属性
• 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 の両方が有効な場合のみ含まれます

​

フック実行完了イベント

• すべての標準属性
• 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 の両方が有効な場合のみ含まれます

​

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

• すべての標準属性
• 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}$ と一致します。値はブール値または数値。

​

圧縮イベント

• すべての標準属性
• 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 以降が必要

​

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

• すべての標準属性
• 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" に置き換えられます

​

フィードバック調査イベント

• すべての標準属性
• 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 調査イベントに存在。このオーバーライドがフロート全体に適用されていることを確認するにはこの属性でフィルタリング

​

保持スイープイベント

• すべての標準属性
• 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: スイープがファイルをリストまたは削除する際に遭遇したエラーの数

​

管理設定解決イベント

• 管理設定、ユーザー設定、--settings の env ブロック、または Claude Code を起動する環境に設定します。プロジェクトまたはローカル設定の値はオンにしません。クローンされたリポジトリはそれらを書き込むことができるため。
• サーバー管理設定は、変数が組織が既に受け取るイベントに組織自体の難読化ポリシーのみを追加するため、セキュリティ承認ダイアログを表示せずに設定できます。

• すべての標準属性
• 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"、MDM または OS レベルポリシーの "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 ルールは、ツール名で発行。コンテンツは難読化。Read([REDACTED]) など。ツールが Claude Code のこのバージョンに組み込まれているか、mcp__jira__create_issue などの mcp__ 参照の場合。他のルールは "[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。ブール値として発行。文字列ではなく

​

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

​

使用状況監視

​

コスト監視

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

​

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

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

​

再試行枯渇の検出

​

イベント分析

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

​

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

​

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

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

​

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

• 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" に編集されるため、プラグイン提供サーバーは詳細ログなしで区別可能なままです

​

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

​

SIEM にイベントを送信する

{
  "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"
  }
}

​

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

​

メトリクスの場合

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

​

イベント/ログの場合

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

​

トレースの場合

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

​

サービス情報

• 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

​

ROI 測定リソース

​

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

• 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 の監視