監視

Claude Code の OpenTelemetry を有効にして設定する方法を学びます。

OpenTelemetry (OTel) を通じてテレメトリデータをエクスポートすることで、組織全体で Claude Code の使用状況、コスト、ツールアクティビティを追跡します。Claude Code はメトリクスを標準メトリクスプロトコル経由で時系列データとしてエクスポートし、イベントをログ/イベントプロトコル経由でエクスポートし、オプションで OpenTelemetry 経由の分散トレースをエクスポートします。

[!NOTE]

Claude API または Managed Agents については、Claude API 向けの OpenTelemetry を参照してください。

クイックスタート

環境変数を使用して OpenTelemetry を設定します:

# 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

メトリクスをエクスポートするセットアップを検証するには、バックエンドで claude_code.session.count メトリクスを確認してください。Claude Code はセッション開始時にこのメトリクスを出力します。ログのみのセットアップを検証するには、プロンプトを送信して claude_code.user_prompt イベントを確認してください。

何も到着しない場合は、claude --debug-file <path> を使用して Claude Code を起動し、そのパスに書き込まれるログを確認してください。Claude Code は、設定したエクスポーターからの失敗を [3P telemetry] エラーとして報告します。ここで 3P はサードパーティを意味します。[Anthropic telemetry] で始まる行は、Anthropic の個別の運用テレメトリについて説明しており、セットアップの問題を示していません。

完全な設定オプションについては、OpenTelemetry 仕様を参照してください。

管理者設定

管理者は、管理設定ファイルを通じてすべてのユーザーの OpenTelemetry 設定を設定できます。設定がどのように適用されるかについては、設定の優先順位を参照してください。

管理設定の設定例：

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

Claude Desktop アプリでは、Code タブセッションは各種 Desktop セッションに到達するソースからこれらの管理設定を読み込みます。管理コンソールのデータとプライバシー設定の監視下にある Cowork の OpenTelemetry フォームは Cowork セッションのみに適用されるため、ターミナル CLI も Code タブも、そこで設定したコレクターにはエクスポートしません。

Claude Code は、リポジトリの .claude/settings.json と .claude/settings.local.json の OpenTelemetry エクスポーター変数を無視するため、リポジトリはそれらを使用してテレメトリをオンにしたり、送信先を選択したり、コンテンツをキャプチャしたりすることはできません。管理設定で設定するか、各開発者がシェルまたは ~/.claude/settings.json で設定してください。リポジトリは、OTEL_LOGS_EXPORTER などのエクスポーターセレクターを none に設定することでシグナルをオフにすることはできますが、管理設定、--settings ファイル、または Claude Code を起動する環境がその変数を設定している場合を除きます。

Claude Code は、Bash ツール、フック、MCP サーバー、言語サーバーを含む、生成するサブプロセスに OTEL_* 環境変数を渡しません。OpenTelemetry でインストルメント化されたアプリケーションを Bash ツール経由で実行する場合、Claude Code のエクスポーターエンドポイントまたはヘッダーを継承しないため、そのアプリケーションが独自のテレメトリをエクスポートする必要がある場合は、コマンド内でこれらの変数を直接設定してください。

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

管理設定で OTEL_EXPORTER_OTLP_* 変数を設定すると、Claude Code は起動時に競合する開発者設定の変数を削除し、デバッグログに警告をログに記録します。削除される内容は、設定する変数によって異なります：

• エンドポイント：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 は、管理設定がコレクターをピン留めしている場合でも、詳細ベータ版トレーシングがエクスポートするログとトレースをリダイレクトしていました。

Claude Code は管理設定自体で設定したシグナル別変数を削除しないため、その変数をそこに設定することで 1 つのシグナルを別のコレクターにルーティングできます。SIEM の例がこれを行っています。そこでシグナル別認証情報を設定する場合、Claude Code はそのシグナルの開発者設定エンドポイントを削除します。

この削除動作は、テレメトリが配信される場所を変更するもので、Claude Code が収集する内容ではありません。

v2.1.217 より前では、すべての変数は独立してキーごとの設定優先順位に従っていたため、ユーザー設定またはシェルで設定されたシグナル固有のエンドポイントがそのシグナルを管理コレクターから離れた場所にリダイレクトしていました。

デスクトップアプリまたはセルフホスト環境ランナーが Claude Code を起動し、提供する環境で OTLP エンドポイントを指定する場合、Claude Code は同じ方法で宛先をピン留めします。ランナーのテレメトリ変数は、管理設定と同じように開発者設定の変数を削除します。Claude Code はランナー自体が設定した変数を削除しません。Claude Code v2.1.251 以降が必要です。

設定の詳細

共通の設定変数

これらの変数は、すべてのデプロイに共通するエクスポーター、エンドポイント、エクスポート動作を設定します。

OTEL_EXPORTER_OTLP_METRICS_ENDPOINT のようなシグナルごとのエンドポイント変数またはプロトコル変数を設定すると、Claude Code はそのシグナルについて汎用の変数の代わりにそれを使用します。OTEL_EXPORTER_OTLP_METRICS_HEADERS のようなシグナルごとのヘッダー変数を設定すると、Claude Code はそのシグナルについて汎用の OTEL_EXPORTER_OTLP_HEADERS とマージします。

管理設定があるマシンで Claude Code が何を削除するかについては、管理設定が OTLP の送信先をロックする仕組みを参照してください。

http/protobuf および http/json プロトコルでは、Claude Code は各エクスポートリクエストを Content-Length ヘッダー付きで送信します。

mTLS 認証

OTLP エクスポーターのクライアント証明書の設定方法は、そのシグナルで使用される OTLP プロトコル（OTEL_EXPORTER_OTLP_PROTOCOL またはシグナルごとの上書きで設定）によって異なります。同じ設定がメトリクス、ログ、トレースに適用されます。

grpc の場合、OpenTelemetry SDK が標準の OTLP 変数を直接読み取るため、シグナルごとのメトリクス変数を設定している既存の設定はそのまま動作します。管理設定があるマシンでは、Claude Code は起動時に開発者が設定したシグナルごとの認証情報とエンドポイントを削除する場合があります。

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

以下の環境変数は、カーディナリティを管理するためにメトリクスとイベントに含める属性を制御します。

一般に、カーディナリティが低いほどパフォーマンスが向上しストレージコストが下がりますが、分析用のデータの粒度は粗くなります。

トレース（ベータ）

分散トレースは、各ユーザープロンプトと、それによってトリガーされる API リクエストおよびツール実行を結び付けるスパンをエクスポートするため、トレースバックエンドで 1 つのリクエスト全体を単一のトレースとして確認できます。

トレースはデフォルトでオフです。有効にするには、CLAUDE_CODE_ENABLE_TELEMETRY=1 と CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 の両方を設定し、OTEL_TRACES_EXPORTER を設定してスパンの送信先を選択します。トレースは、エンドポイント、プロトコル、ヘッダー、mTLS について共通の OTLP 設定を再利用します。管理設定があるマシンでは、Claude Code は起動時に開発者が設定したシグナルごとの認証情報とエンドポイントを削除する場合があります。

スパンでは、ユーザープロンプトのテキスト、ツール入力の詳細、ツールコンテンツがデフォルトで編集（秘匿）されます。これらを含めるには、OTEL_LOG_USER_PROMPTS=1、OTEL_LOG_TOOL_DETAILS=1、OTEL_LOG_TOOL_CONTENT=1 を設定します。

トレースが有効な場合、Bash と PowerShell のサブプロセスは、アクティブなツール実行スパンの W3C トレースコンテキストを含む TRACEPARENT 環境変数を自動的に継承します。これにより、TRACEPARENT を読み取るサブプロセスは自身のスパンを同じトレースの下に親付けでき、Claude が実行するスクリプトやコマンドを通じたエンドツーエンドの分散トレースが可能になります。

トレースが有効で、Claude Code が Anthropic API に直接接続されている場合、各モデルリクエストには claude_code.llm_request スパンのコンテキストに設定された W3C traceparent ヘッダーが付与され、API の traceresponse ヘッダーはスパンリンクとして記録されます。これらを組み合わせることで、準拠した中継サーバーを経由しても、Claude Code のクライアント側スパンがサーバー側のトレースに接続されます。送信される HTTP MCP リクエストにも同様に traceparent が付与されます。このヘッダーはサードパーティのプロバイダーには送信されません。

一部のプロキシは認識できないヘッダーを拒否するため、デフォルトでは、モデルリクエストと HTTP MCP リクエストの traceparent ヘッダーは、ANTHROPIC_BASE_URL が未設定であるか Anthropic API を指している場合にのみ送信されます。一貫性のため、サブプロセスの TRACEPARENT 変数も同じスイッチで制御されます。カスタムの ANTHROPIC_BASE_URL プロキシを介して Claude Code を実行していて、トレースコンテキストを伝播させたい場合は、CLAUDE_CODE_PROPAGATE_TRACEPARENT=1 を設定してください。

Agent SDK および -p で開始した非対話型セッションでは、Claude Code は各インタラクションスパンの開始時に、自身の環境から TRACEPARENT と TRACESTATE も読み取ります。これにより、埋め込み側のプロセスがアクティブな W3C トレースコンテキストをサブプロセスに渡し、Claude Code のスパンを呼び出し元の分散トレースの子として表示させることができます。対話型セッションでは、CI やコンテナ環境の周囲の値を誤って継承しないよう、受信した TRACEPARENT は無視されます。

受信したトレースコンテキストはイベントにも適用されます。TRACEPARENT が設定された Agent SDK および -p セッションでは、トレースエクスポーターが設定されていない場合でも、各 OTLP イベントログレコードにアプリケーションのトレースと結び付ける trace_id と span_id の値が付与されるため、ログバックエンドでイベントをトレースの他の部分と関連付けることができます。

インタラクションがアクティブな間に出力されたレコードには、Claude Code がスパンの非同期コンテキストの外で出力した場合（権限プロンプトのコールバック内や、起動中にバッファリングされて後でエクスポートされたレコードなど）でも、インタラクションスパンの ID が付与されます。アクティブなインタラクションスパンがない状態で出力されたレコードには、受信した TRACEPARENT の ID が直接付与されます。

スパンの階層

各ユーザープロンプトは claude_code.interaction ルートスパンを開始します。API 呼び出し、ツール呼び出し、フックの実行は、その子として記録されます。ツールスパンには独自の子スパンが 2 つあります。1 つは権限の決定を待つ時間、もう 1 つは実行自体の時間です。Agent ツールまたはレガシーの Task ツールがサブエージェントを起動すると、サブエージェントの API スパンとツールスパンは親の claude_code.tool スパンの下にネストされます。

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (requires detailed beta tracing)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (Agent tool) subagent claude_code.llm_request / claude_code.tool spans

Agent SDK および claude -p セッションでは、環境に TRACEPARENT が設定されている場合、claude_code.interaction 自体が呼び出し元のスパンの子になります。

PreToolUse フックがツール呼び出しを延期すると、Claude Code は延期したターンのトレースコンテキストを保存します。セッションを再開してツールが再実行されると、そのツールのスパンは以前のターンのトレースに、そのターンの claude_code.interaction スパンの子として加わります。

スパン属性

すべてのスパンには、標準属性に加えて、スパン名と一致する span.type 属性が付与されます。以下の表は、各スパンに設定される追加の属性を示しています。llm_request、tool.execution、hook スパンは、失敗を記録した場合に OpenTelemetry のステータス ERROR を設定します。その他のスパンは常にステータス UNSET で終了します。

claude_code.interaction

claude_code.llm_request

各再試行は、attempt 属性と client_request_id 属性を持つ gen_ai.request.attempt スパンイベントとしても記録されます。

claude_code.tool

claude_code.tool の tool.output スパンイベント

OTEL_LOG_TOOL_CONTENT=1 を設定すると、Read と Bash の呼び出しで claude_code.tool スパンに tool.output スパンイベントを記録できます。Edit と Write の呼び出しでは、OTEL_LOG_TOOL_DETAILS=1 も設定した場合にのみ記録されます。この変数はこれら 2 つのツールに限定されないため、他の箇所で追加される引数については設定テーブルの該当行を確認してください。

MCP ツール、WebFetch、WebSearch も、Claude Code v2.1.283 以降ではこのイベントを記録します。

Claude Code はツール呼び出しが正常に戻ったときにこのイベントを書き込むため、エラーを発生させた呼び出しは、ツールにかかわらず何も記録しません。正常に戻った呼び出しのうち、次の場合は tool.output イベントを記録しません。

• Read、Edit、Write、Bash、WebFetch、WebSearch、MCP ツール以外のツールの呼び出し
• ファイルのテキスト以外を返す Read（画像、PDF、内容が変更されていないファイルの再読み込みなど）
• OTEL_LOG_TOOL_DETAILS=1 も設定していない場合の Edit または Write の呼び出し
• 待機中のメッセージが Claude に届くよう、実行中に Claude Code がバックグラウンドに移した WebFetch または WebSearch の呼び出し。後から届く結果も記録されません。Claude Code が呼び出しを移すタイミングについては、ターミナルの場合はキューに入れた内容を Claude Code が送信するタイミングを、Agent SDK セッションの場合は priority フィールドを参照してください

このイベントには以下の属性が付与され、それぞれコンテンツ上限（デフォルトで 60 KB）で切り詰められます。ゲートは OTEL_LOG_TOOL_CONTENT=1 に加えて属性に必要な変数を示します。Edit と Write については、その変数は属性ではなくイベント自体のゲートとなります。

親スパンの tool_name 属性で、イベントがどのツールから来たかがわかります。コンテンツ上限で切り詰められた属性には、<attribute>_truncated と <attribute>_original_length が付随します。

claude_code.tool.blocked_on_user

source が user_abort である cancelled の決定は、権限プロンプトまたは auto モードのチェックが保留中の間に、即時配信が必要なメッセージがターンを中断したことを意味します。たとえば、auto モードのチェック中に、ユーザーがキューに入れていたメッセージをすぐに送信した場合です。

claude_code.tool.execution

claude_code.hook

このスパンは詳細ベータトレースが有効な場合にのみ表示されます。詳細ベータトレースには ENABLE_BETA_TRACING_DETAILED=1 と BETA_TRACING_ENDPOINT が必要で、この組み合わせはログとトレースの送信先も変更します。この組み合わせは、シェル、ユーザー設定、または管理設定で設定してください。どちらの変数もプロジェクト設定とローカル設定では無視されます。CLAUDE_CODE_ENHANCED_TELEMETRY_BETA だけではこのスパンは生成されません。

対話型 CLI セッションでは、詳細ベータトレースには、組織がこの機能の許可リストに登録されていることも必要です。Agent SDK および非対話型の -p セッションでは、許可リストへの登録は不要です。

[!WARNING]

ENABLE_BETA_TRACING_DETAILED はデバッグ目的でのみ設定し、本番環境では設定しないでください。詳細ベータトレースはエクスポート量が多く、そのコンテンツ属性は安定したスパンスキーマには含まれません。

詳細ベータトレースでのコンテンツ属性

[!NOTE]

new_context、system_reminders、system_prompt_preview、user_system_prompt、tool_input、response.model_output など、コンテンツを保持する追加の属性は、詳細ベータトレースが有効な場合にのみ出力されます。これらは安定したスパンスキーマには含まれません。

これらの属性は以下のスパンに付与され、ゲートは詳細ベータトレースに加えて属性に必要な変数を示します。コンテンツ上限（デフォルトで 60 KB）を超える値は切り詰められます。

詳細ベータトレースで OTEL_LOG_USER_PROMPTS=1 を設定している場合、Claude Code は完全なシステムプロンプトを保持する claude_code.system_prompt イベントも出力します。このシステムプロンプトはコンテンツ上限で切り詰められます。このイベントは、セッションが個々の異なるシステムプロンプトを初めて送信したときに届き、コンテキスト圧縮の後にも再度届きます。

動的ヘッダー

動的な認証を必要とするエンタープライズ環境では、ヘッダーを動的に生成するスクリプトを設定できます。動的ヘッダーは 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
# Example: Multiple headers
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

ヘルパーが失敗するか、これらの要件を満たさない出力を表示した場合、エクスポートは失敗し、ヘルパーが再び動作するまでテレメトリバックエンドはそのセッションから何も受信しません。Claude Code は次の場所で失敗を報告します。

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

更新の動作

ヘッダーヘルパースクリプトは、トークンの更新をサポートするために、起動時とその後定期的に実行されます。デフォルトでは、スクリプトは 29 分ごとに実行されます。間隔は CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS 環境変数でカスタマイズできます。

複数チームの組織のサポート

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

# Add custom attributes for team identification
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 を設定します。メトリクスのカーディナリティ制御を参照してください。

[!WARNING]

OTEL_RESOURCE_ATTRIBUTES 環境変数は、厳密なフォーマット要件を持つカンマ区切りの key=value ペアを使用します。

• スペース不可: 値にスペースを含めることはできません。たとえば、user.organizationName=My Company は無効です
• フォーマット: カンマ区切りの key=value ペアである必要があります: key1=value1,key2=value2
• 使用可能な文字: 制御文字、空白、二重引用符、カンマ、セミコロン、バックスラッシュを除く US-ASCII 文字のみ
• 特殊文字: 使用可能な範囲外の文字はパーセントエンコードする必要があります

スペースが必要な値には、代わりにアンダースコアまたはキャメルケースを使用してください。以下の例では、それぞれの形式で org.name を設定しています。

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

除外された文字に限らず、任意の文字をパーセントエンコードできます。この例では、スペースとアポストロフィの両方をエンコードしています。

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

値を引用符で囲んでもスペースはエスケープされません。たとえば、org.name="My Company" は My Company ではなく、引用符を含むリテラル値 "My Company" になります。

Desktop SSH セッションにテレメトリを関連付ける

Desktop SSH セッションがどのリモートマシンで実行されたかを確認するには、カスタム属性で各マシンに名前を付けます。メトリクスとイベントには、セッションが実行されたマシンの名前は含まれません。

各リモートマシンで、セッションが読み取る管理設定ファイル内の、テレメトリをオンにする env ブロックに OTEL_RESOURCE_ATTRIBUTES を追加します。名前は各マシンのファイルに直接書き込んでください。Claude Code は値を展開しないため、host.name=$(hostname) はその文字列のまま届きます。

次の例では、マシンに build-7 という名前を付けています。

{
  "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_RESOURCE_ATTRIBUTES": "host.name=build-7"
  }
}

他にこの変数を設定するものがない場合、host.name は、Desktop SSH セッションでもそのマシン上の CLI でも、リソースブロックに含まれて届きます。カスタム属性が他にどこに表示されるかについては、複数チームの組織のサポートを参照してください。

名前が届かない場合は、次のいずれかの原因を確認してください。

• Desktop を実行しているコンピューターで設定した: Desktop は、そこで設定した値を SSH セッションに渡しません
• /etc/profile など、ログインシェルのみが読み取るファイルでエクスポートした: ログインシェルから claude を実行した場合は名前が届きますが、Desktop SSH セッションでは届きません。Desktop はログインシェル経由で Claude Code を起動しません。代わりに、リモートマシン上の管理設定ファイルの env で変数を設定してください。
• 値の中にスペースが含まれている: この場合、Claude Code はどのキーもイベントやデータポイントにコピーせず、エラーも報告しません。値からスペースを取り除いてください。
• 他の何かがすでにこの変数を設定している: デスクトップアプリが開始するセッションでは、起動環境ですでに設定されている変数が設定ファイルより優先されます。デバッグログには、無視された各変数の名前が記録されます。サードパーティの Desktop デプロイが、提供する環境で OTLP エンドポイントを指定している場合、その環境には Desktop 独自の OTEL_RESOURCE_ATTRIBUTES が含まれます。

設定例

claude を実行する前に、これらの環境変数を設定してください。以下の各シナリオは完全な設定を示しており、各変数は共通の設定変数で説明しています。設定が反映されたことを確認するには、セッションを開始した後にバックエンドで claude_code.session.count メトリクスを確認してください。ログのみの検証方法と、何も届かない場合の確認事項についてはクイックスタートで説明しています。

エクスポート間隔 1 秒でのコンソールデバッグの場合:

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

gRPC 経由の OTLP の場合:

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

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

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

セルフホスト環境では、セッションがポート 9464 をバインドするのは、ランナーのキャパシティがデフォルトの 1 の場合のみです。キャパシティがそれより大きい場合、ランナーは代わりにセッションのカウンターとゲージを自身の /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/v1/metrics
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

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

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

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

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

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

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

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

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

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

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

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

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

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

クラウドセッションを区別するには、session.id ではなく ccr.session.id でグループ化またはフィルタリングしてください。

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

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

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

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

標準属性

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

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

[!NOTE]

開発者がサインインする前に Claude Code がログに記録したイベントには、ゲートウェイの ID は付与されません。たとえばゲートウェイがサインインを終了した後など、Claude Code がゲートウェイからサインアウトした状態でセッションを開いた場合、サインイン前にログに記録された起動時のイベントには匿名の user.id が付与され、identity.source は付与されません。これには managed_settings_resolved、plugin_loaded、mcp_server_connection が含まれます。

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

イベントには、さらに次の属性が含まれます。これらは無制限のカーディナリティを引き起こすため、メトリクスには付与されません。

• prompt.id: ユーザーのプロンプトと、次のプロンプトまでに発生するすべての後続イベントを関連付ける UUID。イベント相関属性を参照してください。
• workspace.host_paths: デスクトップアプリで選択されたホストのワークスペースディレクトリ（文字列配列）
• workflow.run_id: 実行識別子。wf_ というプレフィックスが付き、Workflow ツールの実行に属するエージェントが発行する API イベントとツールイベントに付与されます。1 つの workflow.run_id でイベントをフィルタリングすると、その実行の API リクエストとツール結果を再構築できます。この識別子は、ワークフロースクリプトが生成するエージェントと、それらがさらに生成するエージェント（スキルの呼び出しなど）を対象とします。Workflow ツールの結果で報告される実行識別子と一致します。
• workflow.name: ワークフローの名前（スクリプトの meta.name）。workflow.run_id と一緒に発行されます。変更されていない組み込みスクリプトが実行された場合、組み込みのワークフロー名はそのまま表示されます。ユーザーが作成した名前（組み込みスクリプトを編集したコピーを含む）は、OTEL_LOG_TOOL_DETAILS=1 が設定されている場合を除き、custom に置き換えられます。
• agent_id: イベントを発生させたサブエージェントの識別子。例: a3f2c1b4d5e6f7a80。これが付与されるイベントには、サブエージェントの API イベントとツールイベント、その assistant_response イベント、完了したサブエージェントの subagent_completed があります。メインセッションおよびインプロセスのチームメイトのイベントには付与されません。サブエージェントのスパンの agent_id は同じ値であるか、acompact-3f2c1b4d5e6f7a80 のように先頭の a の後にラベルが追加された値です。Claude Code v2.1.310 以降が必要です
• parent_agent_id: イベントを発生させたサブエージェントを生成した、または最後に再開したエージェントの agent_id。そのエージェントがメインセッションの場合は付与されません。Claude Code v2.1.310 以降が必要です

リポジトリ属性

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

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

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

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

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

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

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

メトリクス

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

OTEL_METRICS_EXPORTER に指定されたエクスポーターが prometheus のみの場合、スクレイプが有効な Prometheus テキスト形式を保つように、Claude Code はエクスポートされるメトリクスから USD、tokens、s の単位を省略します。メトリクス名は変わりません。また、otlp,prometheus のように複数のエクスポーターを組み合わせた設定では単位が保持されます。

メトリクスの詳細

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

セッションカウンター

各セッションの開始時にインクリメントされます。代わりに人数をカウントするには、使用状況の監視を参照してください。

属性:

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

コード行数カウンター

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

属性:

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

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

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

属性:

• すべての標準属性

コミットカウンター

Claude Code を介して git コミットを作成したときにインクリメントされます。

属性:

• すべての標準属性

コストカウンター

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

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

属性:

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

トークンカウンター

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

属性:

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

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

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

属性:

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

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

アイドル時間を除き、Claude Code を実際にアクティブに使用した時間を追跡します。このメトリクスは、入力や応答の閲覧などのユーザー操作中、およびツールの実行や 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 から始まり、そのプロセスが存続する間カウントアップします。新しい session.id を割り当てる /clear をまたいでもカウントは続きます。フォークせずにセッションを再開した場合、セッションは session.id を保持しますが、event.sequence の値はセッションを再開したプロセスから取得されます。そのため、1 つのセッション内で後のイベントが前のイベントより小さい値を持ったり、同じ値が繰り返されたりすることがあります。セッションのイベントを順序付けるには、event.timestamp で並べ替え、タイムスタンプが同じイベントの順序付けには event.sequence を使用してください。

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

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

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

プロンプトが送信されたときにログに記録されます。Claude Code が自ら開始するターンも含まれます。

イベント名: claude_code.user_prompt

属性:

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

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

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

イベント名: claude_code.assistant_response

属性:

• すべての標準属性
• event.name: "assistant_response"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• response_length: 応答テキストの長さ（文字数）
• response: 応答テキスト。コンテンツの上限（デフォルトは 60 KB）で切り詰められます。デフォルトで <REDACTED> に秘匿化されます。含めるには OTEL_LOG_ASSISTANT_RESPONSES=1 を設定します。OTEL_LOG_ASSISTANT_RESPONSES が未設定の場合は、代わりに OTEL_LOG_USER_PROMPTS によって制御されます。そのため、プロンプトのログ記録を有効にしたまま応答を秘匿化しておくには、OTEL_LOG_ASSISTANT_RESPONSES=0 を設定してください
• model: モデル識別子（例: "claude-sonnet-5"）
• request_id: API リクエスト ID。イベント相関属性で説明しています
• message.uuid: 応答の最後のトランスクリプトエントリの UUID。API レスポンスはコンテンツブロックごとに 1 つのトランスクリプトエントリとして保存されます。これはその最後のエントリであり、次のターンの parentUuid がこれにチェーンされます。
• 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 イベントとフックで取得したデータを関連付けることができます。
• request_id: このツール呼び出しを含んでいた API レスポンスの request_id。これにより、呼び出しをそのレスポンスの API イベントと結合できます。そのレスポンスにリクエスト ID がなかった場合、またはどの API レスポンスにも呼び出しが含まれていなかった場合は付与されません。Claude Code v2.1.310 以降が必要です
• 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 のペアが含まれます。これはツール決定イベントと同じ、ホストが作成したものに対する例外です。パラメーターはツールによって異なります。
  • Bash ツールの場合: bash_command、full_command、timeout、description、dangerouslyDisableSandbox が含まれ、git commit コマンドが成功した場合は git_commit_id と git_branch も含まれます。git_commit_id は、コミットがセッションの作業ディレクトリの HEAD である場合は完全なコミット SHA、それ以外の場合は git の短縮 SHA です。git_branch はコミットされたブランチで、detached HEAD の場合は省略されます
  • デスクトップアプリのワークスペース Bash ツール（これも tool_name を Bash として報告します）の場合: bash_command、full_command、timeout のみが含まれます
  • MCP ツールの場合: mcp_server_name、mcp_tool_name が含まれます
  • Skill ツールの場合: skill_name が含まれます
  • Agent ツールまたはレガシーの Task ツールの場合: subagent_type が含まれます
• tool_input（OTEL_LOG_TOOL_DETAILS=1 の場合）: JSON シリアライズされたツールの引数。512 文字を超える個々の値は切り詰められ、ペイロード全体は約 4 K 文字に制限されます。MCP ツールを含むすべてのツールに適用されます。

API リクエストイベント

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

イベント名: claude_code.api_request

属性:

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

API エラーイベント

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

イベント名: claude_code.api_error

属性:

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

API 拒否イベント

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

イベント名: claude_code.api_refusal

属性:

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

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

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

イベント名: claude_code.api_request_body

属性:

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

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

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

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

イベント名: claude_code.api_response_body

属性:

• すべての標準属性
• event.name: "api_response_body"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• body: 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 以降が必要です

ツール決定イベント

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

イベント名: 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 イベントとフックで取得したデータを関連付けることができます。

• request_id: このツール呼び出しを含んでいた API レスポンスの request_id。これにより、呼び出しをそのレスポンスの API イベントと結合できます。そのレスポンスにリクエスト ID がなかった場合、またはどの API レスポンスにも呼び出しが含まれていなかった場合は付与されません。Claude Code v2.1.310 以降が必要です

• decision: "accept" または "reject"

• tool_source: 常に付与されます。ツールの出所を示す、CLI が定める閉じた値の集合です。

  • "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 フラグ
    • アクティブな権限モード
    • auto モードの分類器（その判定は同じイベントの classifier_verdict に記録されます）
    • 同じインタラクティブな CLI セッションで、以前の権限プロンプトにおいて与えられた、セッションの残りの期間に対する許可
    • ツールが本質的に安全であること

    source の値は、これらのソースのどれが一致したかを示しません。classifier_verdict が付与されている場合、それは呼び出しを決定した分類器の結果を示します。呼び出しを拒否した権限ルールや設定の名前を示す tool_decision 属性はありません。

    Claude Code は、権限プロンプトのリクエスト自体が失敗した場合にも "config" を報告します。たとえば、Agent SDK の canUseTool コールバックや --permission-prompt-tool ツールが無効な結果を返した場合や、リクエストの保留中に入力ストリームが閉じられた場合に、そのリクエストは失敗します。

  • "hook": PreToolUse または PermissionRequest フックが決定を返しました。

  • "user_permanent": ユーザーが権限プロンプトで "Yes, and don't ask again for ..." を選択した場合に発行されます。これにより、許可ルールがユーザーの個人設定に保存されます。インタラクティブな CLI では、この選択そのものについてのみ発行され、保存されたルールに一致する後続の呼び出しでは代わりに "config" が発行されます。Agent SDK または非インタラクティブな -p セッションでは、最初の選択と後続のルール一致の両方で "user_permanent" が発行されます。承認として扱われます。

  • "user_temporary": ユーザーが権限プロンプトで 1 回限りの承認として "Yes" を選択した場合、またはファイルの編集や読み取りのプロンプトでセッションの残りの期間アクセスを許可するオプションを選択した場合に発行されます。インタラクティブな CLI では、この選択そのものについてのみ発行され、そのセッションスコープの許可によって許可された後続の呼び出しでは代わりに "config" が発行されます。Agent SDK または非インタラクティブな -p セッションでは、選択と後続の一致の両方で "user_temporary" が発行されます。承認として扱われます。

  • "user_abort": ユーザーが回答せずに権限プロンプトを閉じた場合に発行されます。Agent SDK および非インタラクティブな -p セッションでは、canUseTool または --permission-prompt-tool の権限リクエストが保留中にターンを中断した場合も含まれます。拒否として扱われます。

  • "user_reject": プロンプトが表示されたときにユーザーが "No" を選択した場合に発行されます。インタラクティブな CLI では、この選択そのものについてのみ発行され、ユーザーの個人設定の拒否ルールに一致する呼び出しでは代わりに "config" が発行されます。Agent SDK または非インタラクティブな -p セッションでは、個人設定の拒否ルールに一致する呼び出しで "user_reject" が発行されます。拒否として扱われます。

• classifier_verdict: 呼び出しに対する auto モードの分類器の判定、または判定が得られなかった場合に Claude Code が呼び出しを拒否した理由。Claude Code v2.1.301 以降が必要です

  • "allow": 分類器が呼び出しを承認しました
  • "block": 分類器が呼び出しをブロックしました。途中で失敗した分類器のチェックも "block" で終わることがあるため、分類器の部分的な障害は "unavailable" としてではなく、ブロックの増加として現れることがあります
  • "no_verdict": チェックは実行されましたが使用可能な判定が得られなかったため、Claude Code が呼び出しを拒否しました。この拒否は、分類器が呼び出しを安全でないと判断したことを意味するものではありません
  • "unavailable": レート制限、タイムアウト、接続エラーなどにより分類器へのリクエストが失敗したため、Claude Code が呼び出しを拒否しました。サーバー側の分類器レビューでは、サーバーが安全性の判定を返さなかったために拒否された呼び出しも示します

  この属性は、分類器が plan モードでコマンドをレビューする場合の plan モードの呼び出しにも付与されます。次の場合、この属性は付与されません。

  • 許可または拒否の権限ルールが呼び出しを決定した場合
  • auto モードで Claude Code が分類器に問い合わせずに呼び出しを承認した場合
  • ブロックの繰り返しの後に Claude Code が表示したプロンプトにユーザーが回答した場合
  • --permission-prompt-tool のない -p の実行で、プロンプトに回答する人がいなかったため、ブロックの繰り返しの後に Claude Code が呼び出しを拒否した場合。そのイベントは decision を "reject"、source を "config" として報告します

• classifier_category（OTEL_LOG_TOOL_DETAILS=1 の場合）: 分類器が呼び出しをブロックしたときに挙げた組み込みルールの名前。小文字とアンダースコアで表されます。例: Data Exfiltration ルールの場合は "data_exfiltration"。Claude Code v2.1.301 以降が必要です。この属性は、次の両方が成り立つ場合に付与されます。

  • classifier_verdict が "block" である
  • 分類器が挙げたルールがちょうど 1 つで、そのルールがユーザーが作成したものではなく組み込みのものである

  v2.1.302 より前は、サーバー側の分類器レビューが決定したブロックにもこの属性は付与されていませんでした。

• permission_mode: この呼び出しの権限チェックが開始されたときにアクティブだった権限モード: "default"、"plan"、"acceptEdits"、"bypassPermissions"、"dontAsk"、"auto"。手動モードは "default" として表示されます。サブエージェントの呼び出しでは、セッションの権限モードではなくサブエージェントの権限モードが報告されます。Claude Code v2.1.301 以降が必要です

• tool_parameters（OTEL_LOG_TOOL_DETAILS=1 の場合）: ツール固有のパラメーターを含む JSON 文字列。ツール結果イベントと同じ形式ですが、git_commit_id などの実行後のフィールドは含まれません。権限決定が updatedInput を介してツール入力を書き換えた場合、承認された呼び出しでは値が tool_result と異なることがあります。decision が "reject" の場合にどのコマンドが拒否されたかを確認するには、この属性を使用します。

  • "sdk_host_builtin_mcp" ツールの場合: これらの名前はホストアプリケーションが定義するため、OTEL_LOG_TOOL_DETAILS がオフの場合でも mcp_server_name と mcp_tool_name が含まれます。これらがないと、これらの組み込みサーバーへの拒否された呼び出しをデフォルトのストリームで特定できなくなります。ユーザーが設定した MCP サーバーの場合、イベントの tool_name は常にリテラルの "mcp_tool" であり、サーバー名とツール名はフラグがオンの場合にのみ tool_parameters に表示されます。引数の内容には、どの場合でもフラグが必要です。
  • 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 が含まれます

OpenTelemetry SDK の OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT を tool_decision イベントの属性数より低く設定すると、SDK は Claude Code が最後に設定した属性を破棄します。SDK は他のどの属性よりも先に、次の順序でこれらを破棄します。イベントに付与されていないものはスキップされます。

1. parent_agent_id
2. agent_id
3. request_id
4. permission_mode
5. classifier_category
6. classifier_verdict

permission_mode、classifier_category、classifier_verdict がこの順序で破棄されるのは Claude Code v2.1.302 以降です。parent_agent_id、agent_id、request_id には v2.1.310 以降が必要です。

セーフティイベント

Claude Code は claude_code.safety_event の送信を停止しています。

• v2.1.312 以降: これらのバージョンはイベントを送信せず、有効にする設定もありません
• v2.1.307 から v2.1.311 まで: セッションは次回のフィーチャーフラグの更新時にイベントの送信を停止します。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry の場合など、フィーチャーフラグを取得しないセッションでは、送信が続くことがあります。

拒否されたツール呼び出しを確認するには、tool_decision イベントをクエリしてください。これらのイベントは呼び出しが拒否されたことを示しますが、どのチェックが拒否したかを常に示すわけではありません。

ここでのイベントの詳細は v2.1.307 から v2.1.311 までのイベントについて説明しています。これらのバージョンでは、セーフティイベントは次のようなケースを記録します。

• チェックがツール呼び出しを拒否する、または権限プロンプトを必要とする場合（セーフティイベントのない呼び出しを除く）
• サンドボックスのネットワークプロキシが接続またはリクエストを拒否する場合
• フックが結果またはターンの終了をブロックする場合

このイベントは他のイベントと一緒にエクスポートされ、個別の設定はありません。イベント自身の属性には、コマンドテキスト、ファイルパス、ホスト名、MCP サーバー名およびツール名は含まれません。レコードには、すべてのイベントに付与される標準属性も含まれ、これには workspace.host_paths やリポジトリ属性が含まれることがあります。イベントの背後にあるコマンドや MCP ツールを確認するには、OTEL_LOG_TOOL_DETAILS=1 を設定し、対応する tool_decision イベントの tool_parameters を読み取ってください。

イベント名: claude_code.safety_event

属性:

• すべての標準属性
• event.name: "safety_event"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
• category: チェックまたは結果。カテゴリの値のいずれか
• decision: "accept"、"reject"、またはフックが結果やターンの終了をブロックした場合は "sent_back"
• decision_source: 決定した人または仕組み。tool_decision の source の値、または "other"
• reason_code: チェックの理由。"rule:policySettings"、"mode:dontAsk"、"hook:PreToolUse"、"classifier:auto-mode"、"bashMiss:too-complex"、"unknown" など
• reason_type: チェックの理由の種類。"rule"、"subcommandResults"、"mode"、"hook"、"classifier"、"asyncAgent" など
• rule_source: 関係するルールの設定ソース。"policySettings"、"userSettings"、"projectSettings"、"localSettings"、"flagSettings"、"cliArg"、"session" など
• grant_scope: 設定ファイルにルールを保存せずに承認されたプロンプトの場合は "once" または "session"
• circuit_breaker: 組み込みのセーフティチェック。"dangerousRemoval"、"outsideReadsBlocked"、"claudeSettingsFile" など
• classifier_category: OTEL_LOG_TOOL_DETAILS=1 の場合、auto モードのブロックの背後にある組み込みルール。例: "data_exfiltration"
• hook_event: PreToolUse フックの場合は "pre_tool_use"、"hook_review" イベントでは "post_tool_use"、"post_tool_use_failure"、"stop"、"subagent_stop"
• tool_class: Bash と Monitor の場合は "bash"、"powershell"、Read、Edit、Write、NotebookEdit、Glob、Grep の場合は "file"、WebFetch と WebSearch の場合は "web"、"mcp"、または "other"
• tool_name: ツールの名前。組み込みツールの場合は "Bash" など、または "mcp_tool"、"skill_tool"、"dynamic_tool"、"other_tool"
• tool_source: tool_decision と同様に、"builtin"、"mcp"、"sdk_host_builtin_mcp"
• permission_mode: チェック時の呼び出しの権限モード: "default"、"plan"、"acceptEdits"、"bypassPermissions"、"dontAsk"、"auto"
• tool_use_id: 呼び出しの ID。tool_decision および tool_result と同様です
• sandbox_violation_count: 呼び出しのコマンドからの異なる接続またはリクエストのうち、サンドボックスのネットワークプロキシが拒否した数。"0" から "20" までの文字列です。拒否は、フォアグラウンドで完了したサンドボックス化されたコマンドについてカウントされます
• sandbox_enabled: セッションでサンドボックス化が有効な場合は "true"、それ以外は "false"

管理設定の拒否ルールが Bash コマンドを拒否した場合のイベント自身の属性は次のとおりです。

{
  "event.name": "safety_event",
  "category": "managed_policy",
  "decision": "reject",
  "decision_source": "config",
  "reason_code": "rule:policySettings",
  "rule_source": "policySettings",
  "tool_class": "bash",
  "tool_name": "Bash",
  "tool_source": "builtin",
  "permission_mode": "default",
  "tool_use_id": "toolu_01ABC123...",
  "sandbox_violation_count": "0",
  "sandbox_enabled": "false"
}

セーフティイベントのカテゴリ

任意の category でプロキシによる拒否を見つけるには、sandbox_violation_count が付与されており、かつ "0" ではないものでフィルタリングしてください。

セーフティイベントのない呼び出し

カテゴリのないプロンプトに回答できる人がいなかったために拒否された呼び出しを見つけるには、source が "config" で "reject" を報告し、かつ同じ tool_use_id を持つセーフティイベントがない tool_decision イベントを探してください。このような拒否は、--permission-prompt-tool と --permission-prompts none のどちらも指定されていない -p の実行で発生します。

次のような呼び出しについては tool_decision イベントを確認してください。これらには、実行後に送信される "sandbox_network"、"sandbox_other"、"hook_review" イベントを除き、セーフティイベントがありません。

• カテゴリのないプロンプトで承認された呼び出し
• PreToolUse フックのみが必要としたプロンプトで、canUseTool コールバックまたは --permission-prompt-tool ツールが承認した呼び出し
• 拒否されたかどうかにかかわらず、AskUserQuestion または ExitPlanMode の呼び出し

カテゴリのないプロンプト

作業ディレクトリ内での編集に対する default モードのプロンプトなど、どの category の値もそのチェックを示さない場合、そのプロンプトにはカテゴリがありません。

権限モード変更イベント

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

各ツール呼び出しがチェックされた権限モードごとにツール呼び出しをグループ化するには、ツール決定イベントの permission_mode を使用してください。

イベント名: 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"。SDK が setPermissionMode() を通じて権限モードを設定した場合など、一部の変更では付与されません

認証イベント

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

イベント名: claude_code.auth

属性:

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

MCP サーバー接続イベント

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

イベント名: claude_code.mcp_server_connection

属性:

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

内部エラーイベント

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

イベント名: claude_code.internal_error

属性:

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

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

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

イベント名: claude_code.plugin_installed

属性:

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

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

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

イベント名: claude_code.plugin_loaded

属性:

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

イベント名: claude_code.at_mention

属性:

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

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

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

イベント名: claude_code.api_retries_exhausted

属性:

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

フック登録イベント

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

イベント名: claude_code.hook_registered

属性:

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

フック実行開始イベント

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

イベント名: claude_code.hook_execution_start

属性:

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

フック実行完了イベント

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

イベント名: claude_code.hook_execution_complete

属性:

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

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

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

イベント名: claude_code.hook_plugin_metrics

属性:

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

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

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

イベント名: 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" の場合、または対話型ターミナルセッションでのアイドル時の圧縮で trigger が "auto" の場合にのみ設定されます。自動圧縮は、コンテキストウィンドウがいっぱいになる前にバックグラウンドで要約を準備できます。この属性は、圧縮でその準備済みの要約が再利用されたかどうかを記録します。"hit" は再利用されたことを意味し、"miss_custom_instructions"、"miss_hook"、"miss_not_ready" は代わりに新しい要約が計算された理由を示します

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

サブエージェントが終了し、その結果を開始元の会話に返したときにログに記録されます。サブエージェントの種類ごとにツール使用と実行時間を集計するために使用します。トークンやコストの集計には、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 と異なります
• model_swapped: 複数のモデルがサブエージェントのリクエストを処理したかどうか
• 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" は「How is Claude doing?」評価プロンプトです
• response: responded イベントでのユーザーの選択
• enabled_via_override: CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL が設定されている場合は true。文字列ではなく Boolean として出力されます。session アンケートイベントに存在します。この属性でフィルタリングして、上書きがフリート全体に適用されていることを確認します

保持スイープイベント

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

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

result を読んで、スイープが実行されたかどうかを確認します:

• "complete": スイープが実行され、イベントにはその件数が含まれます
• "skipped": Claude Code が保持期間を安全に判断できなかったため、スイープを一時停止しました。イベントには件数が含まれません。skip_reason が "settings_unknowable" または "settings_invalid_key_set" の場合は、そのマシンで /status が報告する設定エラーを修正して、後のセッションでスイープを実行できるようにしてください

管理設定で cleanupPeriodDays が設定されている場合、管理値によって保持期間が固定され、優先度の低いスコープの設定ファイルが壊れているか無効であってもスイープは実行されます。

イベント名: claude_code.retention_sweep

属性:

• すべての標準属性
• event.name: "retention_sweep"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: イベントの順序付けのためのプロセスごとのカウンター。イベント相関属性で説明しています
• result: スイープが実行された場合は "complete"、Claude Code がスイープを一時停止した場合は "skipped"
• period_days: スイープ開始時の保持期間（日数）。マージされた設定の cleanupPeriodDays に、settings.read フックによる変更を適用したものです。その結果キーが未設定の場合は 30。skipped イベントでは、Claude Code が読み取ることのできた設定ソースから計算された、スイープが使用するはずだった値
• used_default: period_days が 30 にフォールバックした場合は "true"、それ以外の場合は "false"。complete イベントでは、"true" は 30 日のデフォルトが適用されたことを意味します
• skip_reason: Claude Code がスイープを一時停止した理由。result が "skipped" の場合にのみ存在します:
  • "user_source_disabled": ユーザー設定が除外されており（例: --setting-sources フラグや SDK の settingSources オプションによって）、有効なソースのいずれも cleanupPeriodDays を提供していません
  • "settings_unknowable": 設定ファイルを読み取れなかったか解析できなかったため、cleanupPeriodDays または desktopSessionCleanupPeriodDays が Claude Code から見えない値に設定されている可能性があります
  • "settings_invalid_key_set": 設定に検証エラーがあり、かつ cleanupPeriodDays または desktopSessionCleanupPeriodDays が明示的に設定されているため、デフォルトにフォールバックすると、その設定に反してファイルを削除または保持してしまう可能性があります
  • "remote_settings_unknowable": サードパーティのデプロイ上の Claude Desktop の Code タブのセッションがサーバー管理設定を要求しましたが、使用可能なレスポンスを受信しなかったため、cleanupPeriodDays が Claude Code から見えない値に設定されている可能性があります
• 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: 検査されたものの、まだ保持期間内であるためそのまま残されたファイル。ファイル単位のスイープのみがこれをカウントするため、この値は下限です。0 以外の値は通常の定常状態です
• files_past_cutoff: 保持期間より古いにもかかわらず、権限エラーや開かれたままのファイルなどの理由でスイープが削除に失敗したファイル。この数には、スイープが skills/synced/ または plugins/synced/ の下で見つけた古いフォルダーも、そのフォルダーをゴミ箱に移動したかどうかにかかわらず、それぞれ含まれます。それらのフォルダーを除き、0 より大きい値は、設定された保持期間を過ぎてもファイルが残っていたことを意味します。ただし、0 であってもそうしたファイルがなかったことの証明にはなりません。ディレクトリ全体の削除に失敗した場合は、代わりに error_count にカウントされるためです
• error_count: ファイルの一覧表示または削除中にスイープが遭遇したエラーの数

管理設定解決イベント

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

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

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

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

イベント名: claude_code.managed_settings_resolved

属性:

• すべての標準属性

• event.name: "managed_settings_resolved"

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

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

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

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

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

• managed_settings.sources: 少なくとも 1 つのポリシーキーを提供するすべての管理ソース。優先度の高い順で、first-wins の下でキーが有効にならないソースも含みます。値は、"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。OTEL_LOG_MANAGED_SETTINGS が設定されているかどうかにかかわらず、Claude Code がヘルパーを選択した場合は常に存在します

• 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 は設定スキーマから次のようにこれを構築します:

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

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

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

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

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

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

使用状況監視

サーフェス間でアクティブユーザーを比較するには、OTEL_METRICS_INCLUDE_ENTRYPOINT=true を設定して、メトリクスとイベントに app.entrypoint を追加します。次に、claude_code.user_prompt イベント、またはメトリクスのみをエクスポートしている場合は claude_code.token.usage で、エントリポイントごとに一意の user.account_uuid 値の数をカウントします。たとえば、対話型 CLI セッションには cli を使用し、Claude Desktop の Code タブについては claude-desktop、claude-desktop-3p、remote_desktop をまとめてグループ化します。

user.account_uuid は Claude Tag チャネルセッションでは個人を識別せず、Claude アカウントのないセッションには含まれません。アクションをユーザーに帰属させる を参照してください。1 人が多数のセッションを開始した場合や、セッションがプロンプトを受け取らなかった場合、claude_code.session.count は増加しますが、アクティブユーザーは増えません。

コスト監視

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

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

[!NOTE]

コストメトリクスは概算です。公式な請求データについては、組織のコストを管理する を参照してください。

Claude Code は、ANTHROPIC_BASE_URL の背後にあるゲートウェイまたはプロキシが複数のフレーム全体で使用状況をプログレッシブにストリーミングする場合を含め、各ストリーミングレスポンスをコストおよびトークンメトリクスに対して正確に 1 回カウントします。

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

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

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

すべてのメトリクスは、標準属性 でセグメント化できます。model 属性は claude_code.token.usage、claude_code.cost.usage、および 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 で上限です。CLAUDE_CODE_RETRY_WATCHDOG を設定すると、デフォルトはより高くなり、上限はなくなります。

リクエストが一時的なエラーのすべての再試行を枯渇させた場合、attempt は最大でもその有効な制限より 1 つ多い値になります: デフォルトでは 11 です。

より低い値でも再試行が尽きたことを意味する場合があります: Claude Code がストリーミングの失敗後にリクエストを再発行するたびに、attempt は 1 から再び開始されるためです。

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

イベント分析

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

safety_event の行は、v2.1.307 から v2.1.311 までのバージョンで、このイベントをまだ送信する セッションにのみ適用されます。

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

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

送信経路を管理コントロールとイベントにマップする

次の表は、セッションの内容をマシン外に持ち出す可能性のある経路とローカル保持を、それらを制限する 管理設定 のキー、およびそれらを記録するイベントと対応付けたものです。/feedback レポートなど、Claude Code 自体が Anthropic に送信するものについては、データの使用 を参照してください。各名前はそれぞれのリファレンス項目にリンクしており、そこに値とデフォルトが記載されています。

allowedHttpHookUrls、managed-mcp.json、およびフックイベントの各項目には、表に示した以上の補足があります：

• allowedHttpHookUrls：エントリは設定ファイル間でマージされるため、開発者は空の管理リストに追加できます。どのフックを実行するかは allowManagedHooksOnly が決定します
• managed-mcp.json：MCP をオフにするには、MCP を完全に無効にする を参照してください。Claude Code がこのファイルを読み込んでいることを確認するには、設定を検証する を参照してください
• フックイベント：Claude Code は hook_execution_start と hook_execution_complete をフックイベントごとに 1 回ログに記録し、一致するすべてのフックを対象とします。OTEL_LOG_TOOL_DETAILS=1 だけでは HTTP フックの URL は記録されません。フックの設定は hook_definitions にのみ表示され、これには詳細なベータトレースも必要です

OTEL_LOG_TOOL_DETAILS=1 は、これらのイベントにコマンド文字列、サーバー名とツール名、およびツール入力を追加します。この詳細にはセッション自体と同じ機密コンテンツが含まれる可能性があるため、コレクターがそのコンテンツを保持することが承認されている場合にのみ有効にしてください。

保持スイープを確認する

すべてのマシンに同じ保持期間を適用するには、管理設定 で cleanupPeriodDays を設定します。マシンがその値でスイープを実行していることを確認するには、retention_sweep イベントを収集します。period_days とカウンターは文字列であるため、比較する前に数値にキャストしてください。

意図どおりに動作しているマシンでも、次のような理由でイベントが発生しないことがあります：

• 誰も Claude Code を起動しない：スイープは実行されず、マシンは次回の起動までデータを保持します
• セッションが開いたままになっている：Claude Code はセッションごとに最大 1 回しかスイープを実行しません
• セッションが早期に終了する：セッション終了時に完了していないスイープは何も出力せず、予期しないエラーで停止したスイープも同様です

スイープはすべてのパスを対象とするわけではありません。残るものは 削除するまで保持されるもの に一覧があり、その削除方法は ローカルデータを消去する で説明しています。

SIEM にイベントを送信する

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

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

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

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

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

メトリクス用のバックエンド

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

イベントとログ用のバックエンド

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

トレース用のバックエンド

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

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

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

サービス情報

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

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

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

ROI 測定リソース

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

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

• バックエンドへの OpenTelemetry エクスポートはオプトイン方式で、明示的な設定が必要です。Anthropic が別途収集する運用テレメトリとその無効化方法については、データの使用を参照してください
• デフォルトでは、生のファイル内容やコードスニペットはメトリクスやイベントに含まれません。OTEL_LOG_TOOL_DETAILS や OTEL_LOG_RAW_API_BODIES などの変数を設定すると、イベントにそれらが含まれる場合があります。トレーススパンは別のデータ経路です。後述の OTEL_LOG_TOOL_CONTENT の項目を参照してください
• OAuth で認証している場合、user.email がテレメトリ属性に含まれます。これは設定した OTel エンドポイントにのみ送信され、Anthropic に送信されることはありません。組織にとってこれが懸念事項となる場合は、テレメトリバックエンドと連携してこのフィールドをフィルタリングまたは編集してください
• ユーザーのプロンプト内容はデフォルトでは収集されません。記録されるのはプロンプトの長さのみです。プロンプト内容を含めるには、OTEL_LOG_USER_PROMPTS=1 を設定します。有効にすると、次のようになります。

  • user_prompt イベントは、プロンプトテキストを prompt と prompt_text の 2 つの属性で保持します。コレクターで属性名によってイベントのプロンプトテキストを削除またはマスクする場合は、ルールで両方の属性を指定してください

    次の OpenTelemetry Collector の attributes プロセッサーは、これを指定したパイプラインで両方の属性を削除します。

    processors:
      attributes/drop-prompt-text:
        actions:
          - key: prompt
            action: delete
          - key: prompt_text
            action: delete
    

  • トレースがオンの場合、claude_code.interaction スパンはその user_prompt 属性でプロンプトテキストを保持します

  • 詳細なベータトレースでは、スパンは各リクエストとともに送信される新しいユーザーメッセージ、ツール結果、システムリマインダー、システムプロンプトのテキスト、およびモデルの出力も保持します。各属性の一覧は詳細なベータトレースにおけるコンテンツ属性を参照してください。claude_code.system_prompt イベントは完全なシステムプロンプトを保持します

• アシスタントの応答テキストはデフォルトでは収集されません。記録されるのは応答の長さのみです。応答テキストを含めるには、OTEL_LOG_ASSISTANT_RESPONSES=1 を設定します。Claude Code からのすべての OpenTelemetry データと同様に、応答テキストは設定した OTel エンドポイントにのみ送信され、Anthropic に送信されることはありません。この変数が未設定の場合は OTEL_LOG_USER_PROMPTS がフォールバックとして使用されるため、イベントにプロンプト内容を含め、応答内容を含めたくない場合は OTEL_LOG_ASSISTANT_RESPONSES=0 を設定してください。詳細なベータトレースでは、claude_code.llm_request スパンは引き続き response.model_output でモデルの出力を保持し、これはこの変数ではなく OTEL_LOG_USER_PROMPTS に従います
• ツールの入力引数とパラメーターはデフォルトではログに記録されません。これらを含めるには、OTEL_LOG_TOOL_DETAILS=1 を設定します。Claude Desktop の組み込みサーバーについては、Claude Desktop が所有するセッションにおいて、このフラグがオフの場合でも、tool_decision と tool_result は mcp_server_name/mcp_tool_name のペアを保持します。これらは引数の内容ではなく、ホストが定めた名前です。このデータは設定した 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 サーバー名とツール名を保持します
  • claude_code.tool スパンは、file_path などの入力から派生した属性を保持します。詳細なベータトレースでは、tool_input 属性も保持します
• ツールのコンテンツは、デフォルトではトレーススパンに記録されません。これを含めるには、OTEL_LOG_TOOL_CONTENT=1 を設定します。すると、claude_code.tool スパンは、生のファイル内容、Bash コマンドの出力、および MCP ツール、WebFetch、WebSearch が返す内容を含む tool.output スパンイベントを保持します。これらは属性ごとにコンテンツ制限（デフォルトは 60 KB）で切り詰められます。MCP ツール、WebFetch、WebSearch の結果には Claude Code v2.1.283 以降が必要です。ツールのコンテンツは、スパンごとにゲートが異なる new_context を通じてもスパンに含まれます。必要に応じてテレメトリバックエンドでこれらの属性をフィルタリングまたは編集するよう設定してください
• 生の Anthropic Messages API のリクエストボディとレスポンスボディは、デフォルトではログに記録されません。これらを含めるには、シェル、ユーザー設定、または管理設定で OTEL_LOG_RAW_API_BODIES を設定します。プロジェクト設定とローカル設定では無視されます。ボディには、システムプロンプト、これまでのすべてのユーザーとアシスタントのターン、ツール結果を含む会話履歴全体が含まれるため、これを有効にすることは、他の OTEL_LOG_* コンテンツフラグで明らかになるすべての内容に同意することを意味します。Claude Code は、他の設定にかかわらず、これらのボディから Claude の拡張思考の内容を常に編集して除去します。設定する値によって、Claude Code がボディを配信する方法が決まります。

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

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

    成功したレスポンスごとに、Claude Code はそのディレクトリ内の index.jsonl にも 1 行を追記し、レスポンスファイルを、それを生成したリクエストファイルおよびそれが変換されたトランスクリプトのメッセージと関連付けます。各行にメッセージの内容は含まれず、そのフィールドは API レスポンスボディイベントのセクションに記載されています。インデックスファイルには Claude Code v2.1.274 以降が必要です

Amazon Bedrock での Claude Code の監視

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