監視

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

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

クイックスタート

環境変数を使用して 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 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 とそのシグナル用にマージします。

管理設定を持つマシンでは、管理設定が OTLP 宛先をロックする方法を参照して、Claude Code が削除するものを確認してください。

環境変数	説明	例の値
`CLAUDE_CODE_ENABLE_TELEMETRY`	テレメトリ収集を有効にします（必須）	`1`
`OTEL_METRICS_EXPORTER`	メトリクスエクスポーターの種類（カンマ区切り）。無効にするには `none` を使用	`console`、`otlp`、`prometheus`、`none`
`OTEL_LOGS_EXPORTER`	ログ/イベントエクスポーターの種類（カンマ区切り）。無効にするには `none` を使用	`console`、`otlp`、`none`
`OTEL_EXPORTER_OTLP_PROTOCOL`	OTLP エクスポーター用のプロトコル。すべてのシグナルに適用されます。Claude Code にはデフォルトプロトコルがないため、有効にする各 `otlp` エクスポーター用にこれまたはシグナル固有のプロトコル変数を設定してください	`grpc`、`http/json`、`http/protobuf`
`OTEL_EXPORTER_OTLP_ENDPOINT`	すべてのシグナル用の OTLP コレクターエンドポイント	`http://localhost:4317`
`OTEL_EXPORTER_OTLP_METRICS_PROTOCOL`	メトリクス用のプロトコル。汎用設定をオーバーライド	`grpc`、`http/json`、`http/protobuf`
`OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`	OTLP メトリクスエンドポイント。汎用設定をオーバーライド	`http://localhost:4318/v1/metrics`
`OTEL_EXPORTER_OTLP_LOGS_PROTOCOL`	ログ用のプロトコル。汎用設定をオーバーライド	`grpc`、`http/json`、`http/protobuf`
`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`	OTLP ログエンドポイント。汎用設定をオーバーライド	`http://localhost:4318/v1/logs`
`OTEL_EXPORTER_OTLP_HEADERS`	OTLP 用の認証ヘッダー	`Authorization=Bearer token`
`OTEL_EXPORTER_OTLP_METRICS_HEADERS`	メトリクス用の認証ヘッダー。汎用ヘッダーとマージされます	`Authorization=Bearer token`
`OTEL_EXPORTER_OTLP_LOGS_HEADERS`	ログ用の認証ヘッダー。汎用ヘッダーとマージされます	`Authorization=Bearer token`
`OTEL_METRIC_EXPORT_INTERVAL`	エクスポート間隔（ミリ秒単位）（デフォルト：60000）	`5000`、`60000`
`OTEL_LOGS_EXPORT_INTERVAL`	ログエクスポート間隔（ミリ秒単位）（デフォルト：5000）	`1000`、`10000`
`OTEL_LOG_USER_PROMPTS`	ユーザープロンプトコンテンツのログを有効にします（デフォルト：無効）	`1` で有効
`OTEL_LOG_ASSISTANT_RESPONSES`	`assistant_response` イベント上でアシスタント応答テキストのログを有効にします（デフォルト：無効）。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値にフォールバックします。Claude Code v2.1.193 以降が必要	`1` で有効、`0` でマスク状態を保持
`OTEL_LOG_TOOL_DETAILS`	ツールイベントおよびトレーススパン属性でのツールパラメーターおよび入力引数のログを有効にします：Bash コマンド、MCP サーバーおよびツール名、スキル名、ユーザー作成ワークフロー名、およびツール入力。また、`user_prompt` イベント上でカスタム、プラグイン、および MCP コマンド名を有効にし、コストおよびトークンカウンター上で実際のエージェント、スキル、プラグイン、および MCP サーバーおよびツール名を有効にします（デフォルト：無効）。Claude Desktop が所有するセッション内の Claude Desktop の組み込みサーバーの場合、フラグがオフでも `mcp_server_name`/`mcp_tool_name` は `tool_decision`/`tool_result` で出力されます。例外には Claude Code v2.1.214 以降が必要	`1` で有効
`OTEL_LOG_TOOL_CONTENT`	`tool.output` スパンイベントでのツールコンテンツのログを有効にします（デフォルト：無効）。スパン属性は独自のゲートの下でツールコンテンツを保持します。トレースが必要です。コンテンツはコンテンツ制限（デフォルト 60 KB）で切り詰められます	`1` で有効
`OTEL_LOG_MANAGED_SETTINGS`	マスク済み管理設定と、マスク前の設定の SHA-256 ダイジェストを管理設定解決イベントに追加します（デフォルト：無効）。プロジェクトまたはローカル設定の値はそれをオンにしません。Claude Code v2.1.274 以降が必要	`1` で有効
`OTEL_LOG_RAW_API_BODIES`	完全な Anthropic Messages API リクエストおよびレスポンス JSON を `api_request_body` / `api_response_body` ログイベントとして出力します（デフォルト：無効）。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、および `OTEL_LOG_TOOL_CONTENT` が明かすすべてのものへの同意を意味します	`1` でコンテンツ制限（デフォルト 60 KB）で切り詰められたインラインボディ、または `file:<dir>` でディスク上の切り詰められていないボディと、イベント内の `body_ref` ポインター
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	コンテンツ制限：モデル応答、ツールコンテンツ、システムプロンプト、および生 API ボディなどのコンテンツを含む属性の最大長。切り詰めマーカーを含む UTF-16 コード単位（デフォルト：61440、つまり 60 KB）。デフォルトは属性値を 64 KB でキャップするバックエンド向けにサイズ設定されています。バックエンドがより大きな値を受け入れる場合はそれを上げるか、テレメトリ量を削減するために下げてください。OpenTelemetry SDK 属性制限 `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` またはそのログレコードおよびスパン変数がより低い値に設定されている場合、Claude Code はその小さい値で切り詰めるため、`[TRUNCATED ...]` マーカーは SDK 制限内に留まります。Claude Code v2.1.214 以降が必要	`262144`
`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`	メトリクス時間性の設定（デフォルト：`delta`）。バックエンドが累積時間性を期待する場合は `cumulative` に設定	`delta`、`cumulative`
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	動的ヘッダーをリフレッシュする間隔（デフォルト：1740000ms / 29 分）	`900000`

http/protobuf および http/json プロトコルの場合、Claude Code は各エクスポートリクエストを Content-Length ヘッダーで送信します。v2.1.212 より前では、v2.1.191 以降の Claude Code バージョンはこれらのリクエストをチャンク転送エンコーディングで送信していました。Azure Monitor およびその他の宣言された長さを必要とするエンドポイントは、411 Length Required または 400 エラーでそれらを拒否しました。

mTLS 認証

OTLP エクスポーター用のクライアント証明書を設定する方法は、そのシグナル用に使用されている OTLP プロトコルに依存し、OTEL_EXPORTER_OTLP_PROTOCOL またはシグナル固有のオーバーライドで設定されます。同じ設定がメトリクス、ログ、およびトレースに適用されます。

プロトコル	クライアント証明書変数	コレクターの CA を信頼する方法
`http/protobuf`、`http/json`	`CLAUDE_CODE_CLIENT_CERT`、`CLAUDE_CODE_CLIENT_KEY`、およびオプションで `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`。ネットワーク設定を参照	`NODE_EXTRA_CA_CERTS`
`grpc`	`OTEL_EXPORTER_OTLP_CLIENT_KEY` および `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`、またはシグナルごとに異なる証明書を使用するための `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` などのシグナル固有の変数	`OTEL_EXPORTER_OTLP_CERTIFICATE`

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

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

次の環境変数は、カーディナリティを管理するためにメトリクスに含まれる属性を制御します：

環境変数	説明	デフォルト値	無効にする例
`OTEL_METRICS_INCLUDE_SESSION_ID`	メトリクスに session.id および、クラウドセッションの場合は ccr.session.id 属性を含める	`true`	`false`
`OTEL_METRICS_INCLUDE_VERSION`	メトリクスに app.version 属性を含める	`false`	`true`
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	メトリクスに user.account_uuid および user.account_id 属性を含める	`true`	`false`
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	メトリクスに app.entrypoint 属性を含める	`false`	`true`
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	`OTEL_RESOURCE_ATTRIBUTES` からのキーをメトリクスデータポイント上の属性として含める	`true`	`false`
`OTEL_METRICS_INCLUDE_REPOSITORY`	メトリクスおよびイベント上に `vcs.*` リポジトリ識別属性を含める。Claude Code v2.1.269 以降が必要	`false`	`true`

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

トレース（ベータ）

分散トレースは、各ユーザープロンプトをそれがトリガーする API リクエストおよびツール実行にリンクするスパンをエクスポートするため、トレーシングバックエンドで完全なリクエストを単一のトレースとして表示できます。

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

環境変数	説明	例の値
`CLAUDE_CODE_ENHANCED_TELEMETRY_BETA`	スパントレースを有効にします（必須）。`ENABLE_ENHANCED_TELEMETRY_BETA` も受け入れられます	`1`
`OTEL_TRACES_EXPORTER`	トレースエクスポーターの種類（カンマ区切り）。無効にするには `none` を使用	`console`、`otlp`、`none`
`OTEL_EXPORTER_OTLP_TRACES_PROTOCOL`	トレース用のプロトコル。`OTEL_EXPORTER_OTLP_PROTOCOL` をオーバーライド	`grpc`、`http/json`、`http/protobuf`
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	OTLP トレースエンドポイント。`OTEL_EXPORTER_OTLP_ENDPOINT` をオーバーライド	`http://localhost:4318/v1/traces`
`OTEL_EXPORTER_OTLP_TRACES_HEADERS`	トレース用の認証ヘッダー。`OTEL_EXPORTER_OTLP_HEADERS` とマージされます	`Authorization=Bearer token`
`OTEL_TRACES_EXPORT_INTERVAL`	スパンバッチエクスポート間隔（ミリ秒単位）（デフォルト：5000）	`1000`、`10000`

スパンはデフォルトでユーザープロンプトテキスト、ツール入力詳細、およびツールコンテンツをマスクします。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 値を含み、トレースエクスポーターが設定されていない場合でも、ログバックエンドがイベントをトレースの残りの部分と相関させることができるため、アプリケーションのトレースに参加します。

アクティブなインタラクション中に出力されたレコードは、インタラクションスパンの非同期コンテキスト外で出力される場合（許可プロンプトコールバックなど）でも、またはスタートアップ中にバッファリングされ後で出力されるレコードの場合でも、インタラクションスパンの ID を含みます。アクティブなインタラクションスパンなしで出力されたレコードは、インバウンド TRACEPARENT ID を直接含みます。v2.1.214 より前では、スパンの非同期コンテキスト外で出力されたレコードはインバウンド TRACEPARENT ID の代わりにスパンの ID を含みました。v2.1.212 より前では、アクティブなスパン外で出力されたイベントレコードは trace_id または span_id を含みませんでした。

スパン階層

各ユーザープロンプトは claude_code.interaction ルートスパンを開始します。API 呼び出し、ツール呼び出し、およびフック実行はその子として記録されます。ツールスパンは 2 つの子スパンを持ちます：1 つは許可決定を待つ時間用で、もう 1 つは実行自体用です。Agent ツール、またはレガシー Task ツールがサブエージェントを生成する場合、サブエージェントの API およびツールスパンは親の claude_code.tool スパンの下にネストされます。

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 スパン

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

属性	説明	ゲート対象
`user_prompt`	プロンプトテキスト。ゲートが設定されていない限り、値は `<REDACTED>`	`OTEL_LOG_USER_PROMPTS`
`user_prompt_length`	プロンプト長（文字数）
`interaction.sequence`	インタラクションの 1 ベースカウンター。Claude Code プロセスごとにカウントされ、セッションごとではなく、`event.sequence`で説明されているように
`parent.source`	スパンがトレース親を取得した方法：環境の `TRACEPARENT` から親になった場合は `env`、独自のトレースを開始した場合は `none`。Claude Code v2.1.268 以降が必要
`interaction.duration_ms`	ターンの壁時計期間

claude_code.llm_request

属性	説明	ゲート対象
`model`	モデル識別子
`gen_ai.system`	常に `anthropic`。OpenTelemetry GenAI セマンティック規約
`gen_ai.request.model`	`model` と同じ値。OpenTelemetry GenAI セマンティック規約
`query_source`	リクエストを発行したサブシステム（`repl_main_thread` またはサブエージェント名など）	`ENABLE_BETA_TRACING_DETAILED`
`query_source_safe`	`query_source` の制限された形式。詳細なベータトレースがアクティブかどうかに関わらず出力され、`repl_main_thread` または `agent.builtin.general-purpose` などの値を持ちます。`:` は `.` になり、ユーザー名のエージェントは `agent.custom` として表示されます。Claude Code v2.1.268 以降が必要
`agent_id`	リクエストを発行したサブエージェントまたはチームメイトの識別子。メインセッションでは不在
`parent_agent_id`	このエージェントを生成したエージェントの識別子。メインセッションおよび直接生成されたエージェントでは不在
`workflow.run_id`	このエージェントを生成したワークフローツール実行の実行識別子。`wf_` で始まります。ワークフローで生成されていないエージェントでは不在
`workflow.name`	このエージェントを生成したワークフローの名前。ユーザー作成の名前は、ゲートが設定されていない限り `custom` に置き換えられます	`OTEL_LOG_TOOL_DETAILS`
`speed`	`fast` または `normal`
`effort`	リクエストに適用される努力レベル：`low`、`medium`、`high`、`xhigh`、または `max`。Claude Code が努力レベルを送信しない場合（例えば、努力をサポートしないモデル）は不在。Claude Code v2.1.274 以降が必要
`llm_request.context`	親スパンに応じて `interaction`、`tool`、または `standalone`
`duration_ms`	再試行を含む壁時計期間
`ttft_ms`	最初のトークンまでの時間（ミリ秒単位）
`first_content_ms`	リクエスト開始から成功した試行の最初のコンテンツブロックまでの時間（ミリ秒単位）。ストリーミングパスにフォールバックしたリクエストでは不在。Claude Code v2.1.268 以降が必要
`input_tokens`	API 使用ブロックからの入力トークン数
`output_tokens`	出力トークン数
`cache_read_tokens`	プロンプトキャッシュから読み取られたトークン
`cache_creation_tokens`	プロンプトキャッシュに書き込まれたトークン
`request_id`	API リクエスト ID。`request_id` イベント相関属性と同じ値
`gen_ai.response.id`	`request_id` と同じ値。OpenTelemetry GenAI セマンティック規約
`client_request_id`	最終試行のクライアント生成 `x-client-request-id`
`attempt`	このリクエストに対して行われた試行の総数
`success`	`true` または `false`
`status_code`	リクエストが失敗した場合の HTTP ステータスコード
`error`	リクエストが失敗した場合のエラーメッセージ
`error_class`	リクエストが失敗した場合の短いエラークラストークン（`api_timeout` または `server_overload` など）。Claude Code v2.1.268 以降が必要
`response.has_tool_call`	レスポンスにツール使用ブロックが含まれている場合は `true`
`stop_reason`	API レスポンス `stop_reason`（`end_turn`、`tool_use`、`max_tokens`、`stop_sequence`、`pause_turn`、または `refusal` など）
`gen_ai.response.finish_reasons`	`stop_reason` と同じ値。文字列配列でラップされています。OpenTelemetry GenAI セマンティック規約

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

claude_code.tool

属性	説明	ゲート対象
`tool_name`	ツール名
`tool_name_safe`	ユーザー選択の名前を含まない `tool_name` の形式。組み込みツール名はそのまま渡されます。MCP ツール名は `mcp_other` として表示されます。ただし、`playwright` ツール（`browser_*` という名前）など、固定の形状に一致するツール名は例外です。Claude Code v2.1.268 以降が必要
`bash_command_class`	Bash ツール用：固定リストからのコマンドの最初のプログラムのカテゴリ（`vcs` または `package_manager` など）。リスト外のプログラムの場合は `other`、行を解析できない場合は `unparsed`。Claude Code v2.1.268 以降が必要
`bash_argv0`	Bash ツール用：同じ固定リスト上にあるコマンドの最初のプログラム（`git` または `npm` など）。リスト外のプログラムの場合は `other`。Claude Code v2.1.268 以降が必要
`duration_ms`	許可待機と実行を含む壁時計期間
`result_tokens`	ツール結果のおおよそのトークンサイズ
`agent_id`	ツールを実行したサブエージェントまたはチームメイトの識別子。メインセッションでは不在
`parent_agent_id`	このエージェントを生成したエージェントの識別子。メインセッションおよび直接生成されたエージェントでは不在
`workflow.run_id`	このエージェントを生成したワークフロータイプ実行の実行識別子。`wf_` で始まります。ワークフローで生成されていないエージェントでは不在
`workflow.name`	このエージェントを生成したワークフローの名前。ユーザー作成の名前は、ゲートが設定されていない限り `custom` に置き換えられます	`OTEL_LOG_TOOL_DETAILS`
`tool_use_id`	このコールのモデルの `tool_use` ブロック ID。tool_result および tool_decision イベント上の `tool_use_id` およびフックペイロード内と一致するため、スパンをそれらのレコードに参加させることができます
`gen_ai.tool.call.id`	`tool_use_id` と同じ値。OpenTelemetry GenAI セマンティック規約
`file_path`	Read、Edit、および Write ツール用のターゲットファイルパス	`OTEL_LOG_TOOL_DETAILS`
`full_command`	Bash ツール用のコマンド文字列	`OTEL_LOG_TOOL_DETAILS`
`skill_name`	Skill ツール用のスキル名	`OTEL_LOG_TOOL_DETAILS`
`subagent_type`	Agent ツールまたはレガシー Task ツール用のサブエージェントタイプ	`OTEL_LOG_TOOL_DETAILS`

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

OTEL_LOG_TOOL_CONTENT=1 を設定した場合、Read および Bash 呼び出しは claude_code.tool スパン上に tool.output スパンイベントを記録できます。Edit および Write 呼び出しは、OTEL_LOG_TOOL_DETAILS=1 も設定した場合にのみ 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 Code がターンを中断してキューに入れたメッセージをすぐに送信している間に実行していた WebFetch または WebSearch 呼び出し。Claude はその結果をツールスパンが終了した後に受け取ります

イベントはこれらの属性を含み、各属性はコンテンツ制限（デフォルト 60 KB）で切り詰められます。ゲート対象 は、属性が OTEL_LOG_TOOL_CONTENT=1 の上に必要とする変数を名前付けし、Edit および Write の場合、その変数は属性ではなくイベント自体をゲートします。

属性	説明	ゲート対象
`content`	Read ツールが返したテキスト、または Write 呼び出しが書き込むよう求められたテキスト	Write ツール用の `OTEL_LOG_TOOL_DETAILS`
`output`	Bash ツール用：コマンドの結合出力。stderr は stdout にインターリーブされています。MCP ツール、WebFetch、または WebSearch 用：ツールが返した結果：改行で結合されたテキストブロック。画像またはドキュメントは `[image]` などのプレースホルダーに置き換えられます
`diff`	Edit ツールが適用した構造化パッチ	`OTEL_LOG_TOOL_DETAILS`
`file_path`	Read、Edit、および Write ツール用のターゲットファイルパス。同じ名前のスパン属性を繰り返します	`OTEL_LOG_TOOL_DETAILS`
`bash_command`	Bash ツール用のコマンド文字列	`OTEL_LOG_TOOL_DETAILS`

親スパンの tool_name 属性は、イベントがどのツールから来たかを示します。コンテンツ制限で切り詰められた属性には、<attribute>_truncated および <attribute>_original_length が付属しています。

claude_code.tool.blocked_on_user

属性	説明	ゲート対象
`duration_ms`	許可決定を待つのに費やされた時間
`decision`	`accept` または `reject`
`source`	ツール決定イベントと一致する決定ソース

claude_code.tool.execution

属性	説明	ゲート対象
`duration_ms`	ツール本体を実行するのに費やされた時間
`tool_use_id`	親 `claude_code.tool` スパン上と同じ値
`gen_ai.tool.call.id`	`tool_use_id` と同じ値。OpenTelemetry GenAI セマンティック規約
`success`	`true` または `false`
`error`	実行が失敗した場合のエラーカテゴリ文字列（`Error:ENOENT` または `ShellError` など）。ゲートが設定されている場合は完全なエラーメッセージを含みます	`OTEL_LOG_TOOL_DETAILS`
`error_class`	識別子形式のエラーカテゴリ。文字、数字、アンダースコア以外の文字は `_` に置き換えられます（`Error_ENOENT` または `ShellError` など）。`error` が完全なメッセージを含む場合でもカテゴリを含みます。Claude Code v2.1.268 以降が必要

claude_code.hook

このスパンは、詳細なベータトレースがアクティブな場合にのみ表示されます。これには ENABLE_BETA_TRACING_DETAILED=1 と BETA_TRACING_ENDPOINT が必要です。このペアは、ログとトレースの送信先も変更します。シェル、ユーザー設定、または管理設定でペアを設定します。両方の変数はプロジェクトおよびローカル設定では無視されます。CLAUDE_CODE_ENHANCED_TELEMETRY_BETA だけではそれを生成しません。

対話型 CLI セッションでは、詳細なベータトレースは、組織がこの機能のホワイトリストに登録されていることも必要です。Agent SDK および非対話型 -p セッションはホワイトリスト登録を必要としません。

属性	説明	ゲート対象
`hook_event`	フックイベントタイプ（`PreToolUse` など）
`hook_name`	完全なフック名（`PreToolUse:Write` など）
`num_hooks`	実行された一致するフックコマンドの数
`hook_definitions`	JSON シリアル化されたフック設定	`OTEL_LOG_TOOL_DETAILS`
`duration_ms`	すべての一致するフックの壁時計期間
`num_success`	正常に完了したフックの数
`num_blocking`	ブロッキング決定を返したフックの数
`num_non_blocking_error`	ブロッキングなしで失敗したフックの数
`num_cancelled`	完了前にキャンセルされたフックの数

Note

new_context、system_prompt_preview、user_system_prompt、tool_input、および response.model_output などの追加のコンテンツを含む属性は、詳細なベータトレースがアクティブな場合にのみ出力されます。これらは安定したスパンスキーマの一部ではありません。

new_context 上のゲートは、それを含むスパンに依存し、各コピーはコンテンツ制限（デフォルト 60 KB）で切り詰められます。claude_code.tool スパン上では、ツールに関わらずそのツール呼び出しの結果を含み、OTEL_LOG_TOOL_CONTENT=1 が必要です。claude_code.interaction スパン上ではユーザープロンプトを含み、claude_code.llm_request スパン上ではそのリクエストの新しいユーザーメッセージとツール結果を含みます。どちらも OTEL_LOG_USER_PROMPTS=1 が必要です。

user_system_prompt はさらに OTEL_LOG_USER_PROMPTS=1 が必要です。systemPrompt SDK オプションまたは --system-prompt および --append-system-prompt フラグを通じて提供するシステムプロンプトテキストのみを含み、コンテンツ制限（デフォルト 60 KB）で切り詰められ、リクエストごとではなくセッションごとに 1 回出力されます。

動的ヘッダー

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

設定の設定

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

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

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

スクリプト要件

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

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

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

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

リフレッシュ動作

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

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

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

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

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

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

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

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

Warning

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

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

スペースが必要な値の場合は、アンダースコアまたは camelCase を代わりに使用します。次の例は、各形式で 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" というリテラル値になります。

設定例

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

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

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

OTLP over gRPC の場合：

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

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

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

標準属性

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

属性	説明	制御対象
`session.id`	一意のセッション識別子	`OTEL_METRICS_INCLUDE_SESSION_ID`（デフォルト: true）
`ccr.session.id`	クラウドセッション識別子。クラウド環境で実行されるセッションの `CLAUDE_CODE_REMOTE_SESSION_ID` の値	`OTEL_METRICS_INCLUDE_SESSION_ID`（デフォルト: true）
`app.version`	現在の Claude Code バージョン	`OTEL_METRICS_INCLUDE_VERSION`（デフォルト: false）
`app.entrypoint`	セッションの起動方法。`cli`、`sdk-cli`、`sdk-ts`、`sdk-py`、`claude-vscode`、Claude Tag セッションの `claude-in-slack` など	`OTEL_METRICS_INCLUDE_ENTRYPOINT`（デフォルト: false）
`organization.id`	組織 UUID（認証時）	利用可能な場合は常に含まれます
`user.account_uuid`	アカウント UUID（認証時）	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`（デフォルト: true）
`user.account_id`	Anthropic 管理 API と一致するタグ付き形式のアカウント ID（認証時）。例：`user_01BWBeN28...`	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`（デフォルト: true）
`user.id`	初回実行時に生成され、`~/.claude.json` に保持されるランダムな匿名識別子。個人情報は含まれず、Claude アカウントから派生していません。ファイルを削除すると、次回実行時に新しい無関係な値が生成されます。	常に含まれます
`user.email`	ユーザーのメールアドレス。サインイン時のメール、またはクラウドセッションの場合はセッション自体の認証情報から取得	利用可能な場合は常に含まれます
`terminal.type`	ターミナルタイプ。`iTerm.app`、`vscode`、`cursor`、`tmux` など	検出された場合は常に含まれます
`OTEL_RESOURCE_ATTRIBUTES` からのキー	`department` や `team.id` など、設定したカスタム属性。マルチチーム組織サポートを参照	`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`（デフォルト: true）
`vcs.repository.url.full`、`vcs.owner.name`、`vcs.repository.name`、`vcs.provider.name`	セッションリポジトリの ID。`origin` リモートから派生。リポジトリ属性を参照	`OTEL_METRICS_INCLUDE_REPOSITORY`（デフォルト: false）。Claude Code v2.1.269 以降が必要

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

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

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

リポジトリ属性

OTEL_METRICS_INCLUDE_REPOSITORY=true を設定して、セッションのリポジトリの ID でメトリクスとイベントにタグを付けます。共有コレクターがリポジトリごとに使用状況を属性付けできるようにします。Claude Code v2.1.269 以降が必要。

Claude Code はセッションごとに 1 回、リポジトリの origin リモートからこれらの属性を派生させます。リポジトリの HTTPS および SSH リモートが同じホストと同じパスに名前を付ける場合（GitHub、GitLab、Bitbucket Cloud の場合と同様）、両方とも同じ値を生成します。

属性	値
`vcs.repository.url.full`	リポジトリのブラウザ URL（`.git` なし）。例：`https://github.com/example-org/example-repo`
`vcs.owner.name`	オーナーまたはグループパス。例：`example-org`。リモートパスが単一セグメントの場合は省略
`vcs.repository.name`	裸のリポジトリ名。例：`example-repo`
`vcs.provider.name`	Claude Code がリモートのホストまたは URL 形状を `github`、`gitlab`、`bitbucket`、`gitea` のいずれかとして認識する場合、その値。それ以外の場合は省略

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

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

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

1 つのリポジトリの HTTPS および SSH クローンが異なる値を報告する場合（例：HTTPS クローン URL がパスプレフィックスを持つ自己ホスト型インストール）、OTEL_RESOURCE_ATTRIBUTES で vcs.repository.url.full と、報告したい他のすべての vcs.* キーを宣言します。すべてのクローンは、宣言したアイデンティティを報告します。

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

メトリクス

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

メトリクス名	説明	ユニット
`claude_code.session.count`	開始された CLI セッションのカウント	なし
`claude_code.lines_of_code.count`	変更されたコード行のカウント	なし
`claude_code.pull_request.count`	作成されたプルリクエストの数	なし
`claude_code.commit.count`	作成された git コミットの数	なし
`claude_code.cost.usage`	Claude Code セッションのコスト	USD
`claude_code.token.usage`	使用されたトークン数	tokens
`claude_code.code_edit_tool.decision`	コード編集ツール権限決定のカウント	なし
`claude_code.active_time.total`	総アクティブ時間	s

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

メトリクスの詳細

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

セッションカウンター

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

属性:

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

コード行カウンター

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

属性:

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

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

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

属性:

すべての標準属性

コミットカウンター

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

属性:

すべての標準属性

コストカウンター

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

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

属性:

すべての標準属性
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 ツール結果を消費しなかった場合は不在。

トークンカウンター

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

属性:

すべての標準属性
type: （"input"、"output"、"cacheRead"、"cacheCreation"）
model: モデル識別子（例：「claude-sonnet-5」）
query_source: リクエストを発行したサブシステムのカテゴリ。"main"、"subagent"、または "auxiliary" のいずれか
speed: リクエストが高速モードを使用した場合は "fast"。それ以外の場合は不在
effort: リクエストに適用された努力レベル。詳細はコストカウンターを参照。
agent.name、skill.name、plugin.name、marketplace.name、mcp_server.name、mcp_tool.name: リクエストのスキル、プラグイン、エージェント、MCP 属性。定義と難読化動作についてはコストカウンターを参照。

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

ユーザーが Edit、Write、または NotebookEdit ツール使用を受け入れるか拒否するとインクリメントされます。

属性:

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

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

Claude Code を積極的に使用している実際の時間を追跡します。アイドル時間は除外されます。このメトリクスは、入力やレスポンス読み取りなどのユーザーインタラクション中、およびツール実行や AI レスポンス生成などの CLI 処理中にインクリメントされます。

属性:

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

イベント

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

イベント相関属性

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

属性	説明
`prompt.id`	単一のユーザープロンプト処理中に生成されたすべてのイベントをリンクする UUID v4 識別子
`event.sequence`	イベントを順序付けするための 0 ベースのカウンター。セッションごとではなく Claude Code プロセスごとにカウント
`message.uuid`	セッショントランスクリプト（`~/.claude/projects//.jsonl` ファイル）に保持されるメッセージの UUID。`assistant_response`、`api_response_body`、およびコマンドディスパッチを除く `user_prompt` に存在します。コマンドディスパッチは 0 個以上のメッセージを生成できます。`assistant_response` および `api_response_body` では、これはレスポンスの最終トランスクリプトエントリで、次のターンの `parentUuid` がこれからチェーンされます。Claude Code v2.1.214 以降が必要。または `api_response_body` では v2.1.274 以降
`request_id`	API リクエストのサーバー割り当て ID。`request-id` レスポンスヘッダーから読み取られます。例：`req_011...`。Amazon Bedrock のようにレスポンスに `request-id` ヘッダーがない場合、値は `x-amzn-requestid` ヘッダーから代わりに取得されます。`api_request`、`api_error`、`api_refusal`、`assistant_response`、`api_response_body` に存在します。レスポンスがいずれかのヘッダーを保持する場合。`llm_request` トレーススパンの同じ属性と一致します。`x-amzn-requestid` ソースには Claude Code v2.1.282 以降が必要
`client_request_id`	`x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。ファーストパーティ API 接続の `api_request` および `api_error` に存在します。サードパーティプロバイダーバックエンドおよびリクエストが非ストリーミングフォールバック経由で再試行された場合は不在。リクエストをレスポンスとペアリングし、タイムアウトなどのサーバー `request_id` を生成しなかった障害に対して利用可能なままです。`llm_request` トレーススパンの同じ属性と一致します。Claude Code v2.1.214 以降が必要

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

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

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

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

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

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

イベント名: claude_code.user_prompt

属性:

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

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

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

イベント名: claude_code.assistant_response

属性:

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

ツール結果イベント

ツールが実行を完了するとログされます。ツール呼び出しが拒否された場合は発行されません。ツール決定イベントで拒否を参照。

イベント名: claude_code.tool_result

属性:

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

API リクエストイベント

Claude への各 API リクエストに対してログされます。

イベント名: claude_code.api_request

属性:

すべての標準属性
event.name: "api_request"
event.timestamp: ISO 8601 タイムスタンプ
event.sequence: イベント順序付けのプロセスごとカウンター。イベント相関属性で説明
model: 使用されたモデル（例：「claude-sonnet-5」）
cost_usd: USD での推定コスト
cost_usd_micros: 米ドルの百万分の一での推定コスト。整数として発行
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 エラーイベント

Claude への API リクエストが失敗するとログされます。

イベント名: claude_code.api_error

属性:

すべての標準属性
event.name: "api_error"
event.timestamp: ISO 8601 タイムスタンプ
event.sequence: イベント順序付けのプロセスごとカウンター。イベント相関属性で説明
model: 使用されたモデル（例：「claude-sonnet-5」）
error: エラーメッセージ
status_code: HTTP ステータスコード（数値）。接続障害などの非 HTTP エラーの場合は不在。
duration_ms: ミリ秒単位のリクエスト期間
attempt: 実行された試行の総数。初期リクエストを含む（1 は再試行が発生しなかったことを意味します）
request_id: API リクエスト ID。"req_011..." など。イベント相関属性で説明。
client_request_id: x-client-request-id リクエストヘッダーとして送信されるクライアント生成 UUID。タイムアウトや接続エラーなどの障害がサーバー request_id を生成しなかった場合でも利用可能。存在する場合についてはイベント相関属性テーブルを参照。Claude Code v2.1.214 以降が必要
speed: 高速モードがアクティブであったかどうかを示す "fast" または "normal"
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 拒否イベント

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"、またはそれ以外の場合は "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 リクエストボディイベント

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

イベント名: claude_code.api_request_body

属性:

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

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

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

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

イベント名: claude_code.api_response_body

属性:

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

ツール決定イベント

ツール権限決定が行われるとログされます（受け入れ/拒否）。

イベント名: claude_code.tool_decision

属性:

すべての標準属性
event.name: "tool_decision"
event.timestamp: ISO 8601 タイムスタンプ
event.sequence: イベント順序付けのプロセスごとカウンター。イベント相関属性で説明
tool_name: ツールの名前（例：「Read」、「Edit」、「Write」、「NotebookEdit」）
tool_use_id: このツール呼び出しの一意の識別子。フックに渡された tool_use_id と一致し、OTel イベントとフック取得データ間の相関を可能にします。
decision: "accept" または "reject"
tool_source: 常に存在します。ツールの出所。CLI 作成値の閉じたセット。Claude Code v2.1.214 以降が必要
- "builtin": CLI 自体のツール
- "mcp": 一般的に MCP サーバー
- "sdk_host_builtin_mcp": Claude Desktop 自体に組み込まれたインプロセスサーバー。Claude Desktop が所有するセッション。Claude Desktop は独自のエントリポイント claude-desktop、claude-desktop-3p、または local-agent から開始したセッションを所有します。ネストされたセッション（Claude Code 自体が生成するセッションを含む）は、これらのサーバーを "mcp" として報告します
source: 決定の出所。
- "config": プロンプトなしで自動的に決定。プロジェクト設定、ユーザーの個人設定の許可または拒否ルール、エンタープライズ管理ポリシー、--allowedTools または --disallowedTools フラグ、アクティブな権限モード、同じインタラクティブ CLI セッション内の前のプロンプトからのセッションスコープ付与、またはツールが本質的に安全であるため。イベントはこれらのソースのどれが一致したかを示しません。Claude Code は、権限プロンプトリクエスト自体が失敗した場合（例：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 を含みます

権限モード変更イベント

権限モードが変更されるとログされます。例：Shift+Tab サイクリング、プランモード終了、自動モードゲートチェック。

イベント名: claude_code.permission_mode_changed

属性:

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

認証イベント

/login または /logout が完了するとログされます。

イベント名: claude_code.auth

属性:

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

MCP サーバー接続イベント

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

イベント名: claude_code.mcp_server_connection

属性:

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

内部エラーイベント

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

イベント名: claude_code.internal_error

属性:

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

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

プラグインがインストール完了するとログされます。claude plugin install CLI コマンドとインタラクティブ /plugin UI の両方から。

イベント名: claude_code.plugin_installed

属性:

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

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

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

イベント名: claude_code.plugin_loaded

属性:

すべての標準属性
event.name: "plugin_loaded"
event.timestamp: ISO 8601 タイムスタンプ
event.sequence: イベント順序付けのプロセスごとカウンター。イベント相関属性で説明
plugin.name: プラグインの名前。公式マーケットプレイスおよび組み込みバンドル外のプラグインの場合、OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り値は "third-party"
marketplace.name: プラグインがインストールされたマーケットプレイス（既知の場合）。plugin.name と同じ条件で "third-party" に難読化
plugin.version: プラグインマニフェストからのバージョン。名前が難読化されておらず、マニフェストがバージョンを宣言する場合のみ含まれます
plugin.scope: プラグインの出所カテゴリ。"official"、"community"、"org"、"user-local"、または "default-bundle"
enabled_via: プラグインが有効になった方法。"default-enable"、"org-policy"、"admin-install"、"seed-mount"、または "user-install"。"admin-install" 値は、プラグインが 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 以降が必要

スキル有効化イベント

スキルが呼び出されるとログされます。Claude が Skill ツール経由で呼び出すか、/ コマンドとして実行するかに関わらず。

イベント名: claude_code.skill_activated

属性:

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

@ メンションイベント

Claude Code がプロンプト内の @ メンションを解決するとログされます。すべてのメンションがイベントを発行するわけではありません。権限拒否、ファイルサイズ超過、PDF 参照添付、ディレクトリリスト障害などの早期終了パスはログなしで返されます。

イベント名: claude_code.at_mention

属性:

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

API 再試行枯渇イベント

API リクエストが複数回の試行後に失敗した場合、1 回ログされます。最終 api_error イベントと一緒に発行されます。

イベント名: claude_code.api_retries_exhausted

属性:

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

フック登録イベント

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

イベント名: claude_code.hook_registered

属性:

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

フック実行開始イベント

1 つ以上のフックがフックイベントの実行を開始するとログされます。

イベント名: claude_code.hook_execution_start

属性:

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

フック実行完了イベント

フックイベントのすべてのフックが完了するとログされます。

イベント名: claude_code.hook_execution_complete

属性:

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

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

公式マーケットプレイスプラグインフックが呼び出しごとのメトリクスを発行するとログされます。公式 Anthropic マーケットプレイスからインストールされたプラグインのみがこれを発行できます。サードパーティマーケットプレイスプラグインおよびユーザー設定フックはこのイベントに発行しません。このイベントを使用して、独自の可観測性スタックからプラグイン動作（検出率、コスト、期間など）を監視します。

イベント名: claude_code.hook_plugin_metrics

属性:

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

圧縮イベント

会話圧縮が完了するとログされます。

イベント名: claude_code.compaction

属性:

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

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

サブエージェントが完了し、結果をそれを開始した会話に返すとログされます。ツール使用と実行時をサブエージェントタイプ別にロールアップするために使用します。トークンまたはコストロールアップの場合、トークンカウンターおよびコストカウンターを query_source "subagent" でフィルタリングして使用します。このイベントの total_tokens は最終リクエストのみをカバーするため。"subagent" カテゴリはエージェントベースのフックからのリクエストもカウントします。これはサブエージェントイベントを発行しません。

イベント名: claude_code.subagent_completed

属性:

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

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

セッション品質調査が表示または回答されるとログされます。調査が収集する内容と制御方法についてはセッション品質調査を参照。

イベント名: claude_code.feedback_survey

属性:

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

保持スイープイベント

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

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

Claude Code が保持期間を安全に決定できない場合、スイープを一時停止し、result を "skipped" に設定し、skip_reason を含むイベントを発行します。管理設定が cleanupPeriodDays を設定する場合、管理値は保持期間をピンで留め、スイープは下位優先度スコープの設定ファイルが破損または無効な場合でも実行されます。管理層が cleanupPeriodDays をサーバー管理設定などの他の場所から供給する場合、managed-settings.json 自体が読み取れない場合でも Claude Code はスイープを一時停止します。削除カウンター属性は result が "complete" の場合のみ存在します。

イベント名: claude_code.retention_sweep

属性:

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

管理設定解決イベント

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

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

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

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

イベント名: claude_code.managed_settings_resolved

属性:

すべての標準属性
event.name: "managed_settings_resolved"
event.timestamp: ISO 8601 タイムスタンプ
event.sequence: イベント順序付けのプロセスごとカウンター。イベント相関属性で説明
managed_settings.trigger: セッション開始イベントの場合は "startup"。管理設定またはポリシーヘルパーの状態がセッション後半で変わった場合は "change"。管理設定ポリシーがセッションを停止した場合は "refused"。Claude Code は、属性が前のイベントから異なる場合のみ change イベントを送信し、変更された設定値は OTEL_LOG_MANAGED_SETTINGS がオフの場合でもカウントされます
error.type: Claude Code がセッションを停止した理由。refused イベントでのみ存在。
- "helper_failed": ポリシーヘルパー実行が失敗
- "policy_invalid": 管理設定に Claude Code が開始するのを停止するエラーが含まれるか、管理ソースが読み込みに失敗したため、Claude Code は組織ログイン強制を確認できません
- "consent_rejected": ユーザーがサーバー管理設定のセキュリティ承認ダイアログを拒否
- "force_refresh_failed": forceRemoteSettingsRefresh が必要とする設定フェッチが失敗
- "gateway_rejected": Claude アプリゲートウェイが管理設定ロードに HTTP 403 で応答
- "version_below_minimum": この Claude Code バージョンが requiredMinimumVersion より下または requiredMaximumVersion より上
- "_OTHER": Claude アプリゲートウェイ管理設定ロードが別の理由で失敗
managed_settings.sources: 少なくとも 1 つのポリシーキーを配信するすべての管理ソース。優先度が最も高い順。first-wins の下で効果を持たないソースを含む。値は "remote"、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。ブール値として発行。文字列ではなく

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

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

使用状況監視

メトリクス	分析の機会
`claude_code.token.usage`	`type` (入力/出力)、ユーザー、チーム、モデル、`skill.name`、`plugin.name`、または `agent.name` 別に分類
`claude_code.session.count`	時間経過に伴う採用と関与を追跡
`claude_code.lines_of_code.count`	コード追加と削除を追跡して生産性を測定し、モデル別に分類
`claude_code.commit.count` & `claude_code.pull_request.count`	開発ワークフローへの影響を理解

コスト監視

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

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

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

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

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

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

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

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

再試行枯渇の検出

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

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

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

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

イベント分析

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

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

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

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

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

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

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

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

開発者が開始したセッションでは、MCP ツール呼び出し、Bash コマンド、ファイル編集はその開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または Claude apps gateway セッションでの開発者の IdP ID です。Claude 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 セッションはこれを必要としません：CLI は標準属性で説明されているように、IdP ID を自動的にスタンプします。

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

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

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

イベント	MCP に対して記録するもの
`mcp_server_connection`	`server_name`、`transport_type`、`server_scope`、およびエラー詳細を含むサーバー接続、切断、接続失敗
`tool_result`	`tool_name` および `mcp_server_scope` を含む各 MCP ツール呼び出し、`mcp_server_name` および `mcp_tool_name` を含む `tool_parameters` ペイロード、および呼び出し引数を含む `tool_input` ペイロード
`tool_decision`	呼び出しが許可されたか拒否されたか、および決定が設定、フック、またはユーザーから来たかどうか、および `mcp_server_name` と `mcp_tool_name` を含む `tool_parameters` ペイロード

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

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

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

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

シグナル	イベント	キー属性
ツール呼び出しが許可または拒否され、何によって	`tool_decision`	`decision`、`source`、`tool_name`、`tool_parameters`
権限モードのエスカレーション	`permission_mode_changed`	`from_mode`、`to_mode`、`trigger`
ポリシーフックがアクションをブロック	`hook_execution_complete`	`hook_event`、`num_blocking`
ログイン、ログアウト、認証失敗	`auth`	`action`、`success`、`error_category`
MCP サーバー接続または失敗	`mcp_server_connection`	`status`、`server_name`、`is_plugin`、`error_code`
プラグインがインストールされ、そのソース	`plugin_installed`	`plugin.name`、`marketplace.name`、`marketplace.is_official`
実行されたコマンドとタッチされたファイル	`tool_result`（実行）または `tool_decision`（拒否）（`OTEL_LOG_TOOL_DETAILS=1` の場合）	`tool_parameters`；`tool_input`（`tool_result` のみ）
マシンが実行する管理設定ソース、そのポリシーヘルパーが正常かどうか、およびマシンが起動を拒否した理由	`managed_settings_resolved`	`managed_settings.trigger`、`managed_settings.sources`、`managed_settings.source_behavior`、`managed_settings.helper.state`、`error.type`；`managed_settings.settings` および `managed_settings.resolved_sha256`（`OTEL_LOG_MANAGED_SETTINGS=1` の場合）

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

SIEM にイベントを送信する

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

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

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

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

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

メトリクスの場合

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

イベント/ログの場合

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

トレースの場合

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

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

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

サービス情報

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

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

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

ROI 測定リソース

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

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

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

Amazon Bedrock での Claude Code の監視

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

monitoring-usage.md +483 −435

39 39

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

41 41

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

43 43

44完全な設定オプションについては、[OpenTelemetry 仕様](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options)を参照してください。44完全な設定オプションについては、[OpenTelemetry 仕様](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options)を参照してください。

45 45

49 49

50管理者は、[管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms)を通じてすべてのユーザーの OpenTelemetry 設定を設定できます。設定がどのように適用されるかについては、[設定の優先順位](/docs/ja/settings#settings-precedence)を参照してください。50管理者は、[管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms)を通じてすべてのユーザーの OpenTelemetry 設定を設定できます。設定がどのように適用されるかについては、[設定の優先順位](/docs/ja/settings#settings-precedence)を参照してください。

51 51

~~52管理設定の設定例:~~52管理設定の設定例：

53 53

54```json theme={null}54```json theme={null}

55{55{

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

73</h3>73</h3>

74 74

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

76 76

77* **エンドポイント**：`OTEL_EXPORTER_OTLP_ENDPOINT` を設定すると、Claude Code はすべての開発者設定のシグナル別エンドポイントを削除します。開発者は 1 つのシグナルを別のコレクターにポイントできないため、管理設定でシグナル別エンドポイント変数も設定する必要はありません。77* **エンドポイント**：`OTEL_EXPORTER_OTLP_ENDPOINT` を設定すると、Claude Code はすべての開発者設定のシグナル別エンドポイントを削除します。開発者は 1 つのシグナルを別のコレクターにポイントできないため、管理設定でシグナル別エンドポイント変数も設定する必要はありません。

78* **プロトコル**：`OTEL_EXPORTER_OTLP_PROTOCOL` を設定すると、Claude Code はすべての開発者設定のシグナル別プロトコルを削除します。78* **プロトコル**：`OTEL_EXPORTER_OTLP_PROTOCOL` を設定すると、Claude Code はすべての開発者設定のシグナル別プロトコルを削除します。

103 一般的な設定変数103 一般的な設定変数

104</h3>104</h3>

105 105

106これらの変数は、すべてのデプロイメントのエクスポーター、エンドポイント、エクスポート動作を設定します。`OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` などのシグナルごとのエンドポイントまたはプロトコル変数を設定した場合、Claude Code はそのシグナルの汎用変数の代わりにそれを使用します。`OTEL_EXPORTER_OTLP_METRICS_HEADERS` などのシグナルごとのヘッダー変数を設定した場合、Claude Code はそのシグナルの汎用 `OTEL_EXPORTER_OTLP_HEADERS` とマージします。管理設定を持つマシンでは、[管理設定が OTLP 宛先をロックする方法](#how-managed-settings-lock-the-otlp-destination)を参照して、Claude Code が削除するものを確認してください。106これらの変数は、すべてのデプロイメント向けにエクスポーター、エンドポイント、およびエクスポート動作を設定します。

107

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

109

110管理設定を持つマシンでは、[管理設定が OTLP 宛先をロックする方法](#how-managed-settings-lock-the-otlp-destination)を参照して、Claude Code が削除するものを確認してください。

107 111

108| 環境変数 | 説明 | 例の値 |112| 環境変数 | 説明 | 例の値 |

109| - | - | - |113| - | - | - |

110| `CLAUDE_CODE_ENABLE_TELEMETRY` | テレメトリ収集を有効にする (必須) | `1` |114| `CLAUDE_CODE_ENABLE_TELEMETRY` | テレメトリ収集を有効にします（必須） | `1` |

113| `OTEL_EXPORTER_OTLP_PROTOCOL` | OTLP エクスポーターのプロトコル (すべてのシグナルに適用)。Claude Code にはデフォルトプロトコルがないため、有効にする各 `otlp` エクスポーターについて、これまたはシグナル固有のプロトコル変数を設定してください | `grpc`、`http/json`、`http/protobuf` |117| `OTEL_EXPORTER_OTLP_PROTOCOL` | OTLP エクスポーター用のプロトコル。すべてのシグナルに適用されます。Claude Code にはデフォルトプロトコルがないため、有効にする各 `otlp` エクスポーター用にこれまたはシグナル固有のプロトコル変数を設定してください | `grpc`、`http/json`、`http/protobuf` |

122| `OTEL_METRIC_EXPORT_INTERVAL` | エクスポート間隔 (ミリ秒単位、デフォルト: 60000) | `5000`、`60000` |126| `OTEL_METRIC_EXPORT_INTERVAL` | エクスポート間隔（ミリ秒単位）（デフォルト：60000） | `5000`、`60000` |

123| `OTEL_LOGS_EXPORT_INTERVAL` | ログエクスポート間隔 (ミリ秒単位、デフォルト: 5000) | `1000`、`10000` |127| `OTEL_LOGS_EXPORT_INTERVAL` | ログエクスポート間隔（ミリ秒単位）（デフォルト：5000） | `1000`、`10000` |

125| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` イベントでアシスタント応答テキストのログを有効にする (デフォルト: 無効)。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値にフォールバックします。Claude Code v2.1.193 以降が必要です | `1` で有効化、`0` でマスク状態を保持 |129| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` イベント上でアシスタント応答テキストのログを有効にします（デフォルト：無効）。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値にフォールバックします。Claude Code v2.1.193 以降が必要 | `1` で有効、`0` でマスク状態を保持 |

126| `OTEL_LOG_TOOL_DETAILS` | ツールイベントおよびトレーススパン属性でツールパラメーターと入力引数のログを有効にする: Bash コマンド、MCP サーバーとツール名、スキル名、ユーザー作成ワークフロー名、ツール入力。また、`user_prompt` イベントでカスタム、プラグイン、MCP コマンド名を有効にします (デフォルト: 無効)。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、フラグがオフでも `mcp_server_name`/`mcp_tool_name` は `tool_decision`/`tool_result` で出力されます。この例外には Claude Code v2.1.214 以降が必要です | `1` で有効化 |130| `OTEL_LOG_TOOL_DETAILS` | ツールイベントおよびトレーススパン属性でのツールパラメーターおよび入力引数のログを有効にします：Bash コマンド、MCP サーバーおよびツール名、スキル名、ユーザー作成ワークフロー名、およびツール入力。また、`user_prompt` イベント上でカスタム、プラグイン、および MCP コマンド名を有効にし、[コストおよびトークンカウンター](#cost-counter)上で実際のエージェント、スキル、プラグイン、および MCP サーバーおよびツール名を有効にします（デフォルト：無効）。Claude Desktop が所有するセッション内の Claude Desktop の組み込みサーバーの場合、フラグがオフでも `mcp_server_name`/`mcp_tool_name` は `tool_decision`/`tool_result` で出力されます。例外には Claude Code v2.1.214 以降が必要 | `1` で有効 |

127| `OTEL_LOG_TOOL_CONTENT` | [`tool.output` スパンイベント](#tool-output-span-event)でツールコンテンツのログを有効にする (デフォルト: 無効)。スパン属性は[独自のゲート](#new-context-gates)の下でツールコンテンツを含みます。[トレース](#traces-beta)が必要です。コンテンツはコンテンツ制限で切り詰められます (デフォルト: 60 KB) | `1` で有効化 |131| `OTEL_LOG_TOOL_CONTENT` | [`tool.output` スパンイベント](#tool-output-span-event)でのツールコンテンツのログを有効にします（デフォルト：無効）。スパン属性は[独自のゲート](#new-context-gates)の下でツールコンテンツを保持します。[トレース](#traces-beta)が必要です。コンテンツはコンテンツ制限（デフォルト 60 KB）で切り詰められます | `1` で有効 |

128| `OTEL_LOG_MANAGED_SETTINGS` | マスク処理された管理設定と、マスク処理前の設定の SHA-256 ダイジェストを [管理設定解決](#managed-settings-resolved-event)イベントに追加します (デフォルト: 無効)。プロジェクトまたはローカル設定の値はそれをオンにしません。Claude Code v2.1.274 以降が必要です | `1` で有効化 |132| `OTEL_LOG_MANAGED_SETTINGS` | マスク済み管理設定と、マスク前の設定の SHA-256 ダイジェストを[管理設定解決](#managed-settings-resolved-event)イベントに追加します（デフォルト：無効）。プロジェクトまたはローカル設定の値はそれをオンにしません。Claude Code v2.1.274 以降が必要 | `1` で有効 |

129| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストとレスポンス JSON 全体を `api_request_body` / `api_response_body` ログイベントとして出力します (デフォルト: 無効)。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、および `OTEL_LOG_TOOL_CONTENT` が明かすすべてのものに同意することを意味します | `1` でコンテンツ制限で切り詰められたインラインボディ (デフォルト: 60 KB)、または `file:<dir>` でディスク上の切り詰められていないボディと、イベント内の `body_ref` ポインター |133| `OTEL_LOG_RAW_API_BODIES` | 完全な Anthropic Messages API リクエストおよびレスポンス JSON を `api_request_body` / `api_response_body` ログイベントとして出力します（デフォルト：無効）。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、および `OTEL_LOG_TOOL_CONTENT` が明かすすべてのものへの同意を意味します | `1` でコンテンツ制限（デフォルト 60 KB）で切り詰められたインラインボディ、または `file:<dir>` でディスク上の切り詰められていないボディと、イベント内の `body_ref` ポインター |

130| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツ制限: モデルレスポンス、ツールコンテンツ、システムプロンプト、生 API ボディなどのコンテンツを含む属性の最大長 (UTF-16 コード単位、デフォルト: 61440、つまり 60 KB)。デフォルトは 64 KB で属性値をキャップするバックエンド向けにサイズ設定されています。バックエンドがより大きな値を受け入れる場合はそれを上げるか、テレメトリ量を削減するために下げてください。OpenTelemetry SDK 属性制限 `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` またはそのログレコードおよびスパンバリアントがより低い値に設定されている場合、Claude Code はその小さい値で切り詰めるため、`[TRUNCATED ...]` マーカーは SDK 制限内に留まります。Claude Code v2.1.214 以降が必要です | `262144` |134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツ制限：モデル応答、ツールコンテンツ、システムプロンプト、および生 API ボディなどのコンテンツを含む属性の最大長。切り詰めマーカーを含む UTF-16 コード単位（デフォルト：61440、つまり 60 KB）。デフォルトは属性値を 64 KB でキャップするバックエンド向けにサイズ設定されています。バックエンドがより大きな値を受け入れる場合はそれを上げるか、テレメトリ量を削減するために下げてください。OpenTelemetry SDK 属性制限 `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` またはそのログレコードおよびスパン変数がより低い値に設定されている場合、Claude Code はその小さい値で切り詰めるため、`[TRUNCATED ...]` マーカーは SDK 制限内に留まります。Claude Code v2.1.214 以降が必要 | `262144` |

132| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的ヘッダーを更新するための間隔 (デフォルト: 1740000ms / 29 分) | `900000` |136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的ヘッダーをリフレッシュする間隔（デフォルト：1740000ms / 29 分） | `900000` |

~~133~~ 137

134`http/protobuf` および `http/json` プロトコルの場合、Claude Code は各エクスポートリクエストを `Content-Length` ヘッダーで送信します。v2.1.212 より前では、v2.1.191 以降の Claude Code バージョンはこれらのリクエストをチャンク転送エンコーディングで送信していました。Azure Monitor およびその他の宣言された長さを必要とするエンドポイントは、`411 Length Required` または `400` エラーでこれらを拒否していました。138`http/protobuf` および `http/json` プロトコルの場合、Claude Code は各エクスポートリクエストを `Content-Length` ヘッダーで送信します。v2.1.212 より前では、v2.1.191 以降の Claude Code バージョンはこれらのリクエストをチャンク転送エンコーディングで送信していました。Azure Monitor およびその他の宣言された長さを必要とするエンドポイントは、`411 Length Required` または `400` エラーでそれらを拒否しました。

135 139

136<h3 id="mtls-authentication">140<h3 id="mtls-authentication">

137 mTLS 認証141 mTLS 認証

138</h3>142</h3>

139 143

140OTLP エクスポーターのクライアント証明書を設定する方法は、そのシグナルに使用されている OTLP プロトコルに依存し、`OTEL_EXPORTER_OTLP_PROTOCOL` またはシグナルごとのオーバーライドで設定されます。同じ設定がメトリクス、ログ、トレースに適用されます。144OTLP エクスポーター用のクライアント証明書を設定する方法は、そのシグナル用に使用されている OTLP プロトコルに依存し、`OTEL_EXPORTER_OTLP_PROTOCOL` またはシグナル固有のオーバーライドで設定されます。同じ設定がメトリクス、ログ、およびトレースに適用されます。

141 145

143| :- | :- | :- |147| :- | :- | :- |

144| `http/protobuf`、`http/json` | `CLAUDE_CODE_CLIENT_CERT`、`CLAUDE_CODE_CLIENT_KEY`、およびオプションで `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`。[ネットワーク設定](/docs/ja/network-config#mtls-authentication)を参照 | `NODE_EXTRA_CA_CERTS` |148| `http/protobuf`、`http/json` | `CLAUDE_CODE_CLIENT_CERT`、`CLAUDE_CODE_CLIENT_KEY`、およびオプションで `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`。[ネットワーク設定](/docs/ja/network-config#mtls-authentication)を参照 | `NODE_EXTRA_CA_CERTS` |

145| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` および `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`、またはシグナルごとに異なる証明書を使用するための `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` などのシグナルごとのバリアント | `OTEL_EXPORTER_OTLP_CERTIFICATE` |149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` および `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`、またはシグナルごとに異なる証明書を使用するための `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` などのシグナル固有の変数 | `OTEL_EXPORTER_OTLP_CERTIFICATE` |

146 150

147`grpc` の場合、OpenTelemetry SDK は標準 OTLP 変数を直接読み取るため、シグナルごとのメトリクス変数を設定する既存の設定は引き続き機能します。管理設定を持つマシンでは、Claude Code は[スタートアップ時に開発者が設定したシグナルごとの認証情報とエンドポイントを削除する](#how-managed-settings-lock-the-otlp-destination)可能性があります。151`grpc` の場合、OpenTelemetry SDK は標準 OTLP 変数を直接読み取るため、シグナルごとのメトリクス変数を設定する既存の設定は引き続き機能します。管理設定を持つマシンでは、Claude Code は起動時に開発者が設定したシグナルごとの認証情報とエンドポイントを[削除する可能性があります](#how-managed-settings-lock-the-otlp-destination)。

148 152

149<h3 id="metrics-cardinality-control">153<h3 id="metrics-cardinality-control">

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

151</h3>155</h3>

152 156

153以下の環境変数は、カーディナリティを管理するためにメトリクスに含まれる属性を制御します:157次の環境変数は、カーディナリティを管理するためにメトリクスに含まれる属性を制御します：

154 158

155| 環境変数 | 説明 | デフォルト値 | 無効化する例 |159| 環境変数 | 説明 | デフォルト値 | 無効にする例 |

156| - | - | - | - |160| - | - | - | - |

163 167

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

165 169

166<h3 id="traces-beta">170<h3 id="traces-beta">

167 トレース (ベータ)171 トレース（ベータ）

168</h3>172</h3>

169 173

170分散トレースは、各ユーザープロンプトをそれがトリガーする API リクエストとツール実行にリンクするスパンをエクスポートします。これにより、トレーシングバックエンドで完全なリクエストを単一のトレースとして表示できます。174分散トレースは、各ユーザープロンプトをそれがトリガーする API リクエストおよびツール実行にリンクするスパンをエクスポートするため、トレーシングバックエンドで完全なリクエストを単一のトレースとして表示できます。

171 175

172トレースはデフォルトでオフです。有効にするには、`CLAUDE_CODE_ENABLE_TELEMETRY=1` と `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1` の両方を設定してから、`OTEL_TRACES_EXPORTER` を設定してスパンの送信先を選択します。トレースは、エンドポイント、プロトコル、ヘッダー、および [mTLS](#mtls-authentication)について [一般的な OTLP 設定](#common-configuration-variables)を再利用します。管理設定を持つマシンでは、Claude Code は[スタートアップ時に開発者が設定したシグナルごとの認証情報とエンドポイントを削除する](#how-managed-settings-lock-the-otlp-destination)可能性があります。176トレースはデフォルトでオフです。有効にするには、`CLAUDE_CODE_ENABLE_TELEMETRY=1` と `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1` の両方を設定してから、`OTEL_TRACES_EXPORTER` を設定してスパンの送信先を選択します。トレースは、エンドポイント、プロトコル、ヘッダー、および[mTLS](#mtls-authentication)用の[一般的な OTLP 設定](#common-configuration-variables)を再利用します。管理設定を持つマシンでは、Claude Code は起動時に開発者が設定したシグナルごとの認証情報とエンドポイントを[削除する可能性があります](#how-managed-settings-lock-the-otlp-destination)。

173 177

174| 環境変数 | 説明 | 例の値 |178| 環境変数 | 説明 | 例の値 |

175| - | - | - |179| - | - | - |

176| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | スパントレースを有効にする (必須)。`ENABLE_ENHANCED_TELEMETRY_BETA` も受け入れられます | `1` |180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | スパントレースを有効にします（必須）。`ENABLE_ENHANCED_TELEMETRY_BETA` も受け入れられます | `1` |

181| `OTEL_TRACES_EXPORT_INTERVAL` | スパンバッチエクスポート間隔 (ミリ秒単位、デフォルト: 5000) | `1000`、`10000` |185| `OTEL_TRACES_EXPORT_INTERVAL` | スパンバッチエクスポート間隔（ミリ秒単位）（デフォルト：5000） | `1000`、`10000` |

182 186

183スパンはデフォルトでユーザープロンプトテキスト、ツール入力詳細、ツールコンテンツをマスクします。これらを含めるには、`OTEL_LOG_USER_PROMPTS=1`、`OTEL_LOG_TOOL_DETAILS=1`、および `OTEL_LOG_TOOL_CONTENT=1` を設定します。187スパンはデフォルトでユーザープロンプトテキスト、ツール入力詳細、およびツールコンテンツをマスクします。`OTEL_LOG_USER_PROMPTS=1`、`OTEL_LOG_TOOL_DETAILS=1`、および `OTEL_LOG_TOOL_CONTENT=1` を設定してそれらを含めます。

184 188

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

186 190

187トレースがアクティブで Claude Code が Anthropic API に直接接続されている場合、各モデルリクエストは W3C `traceparent` ヘッダーを含み、これは `claude_code.llm_request` スパンのコンテキストに設定され、API の `traceresponse` ヘッダーはスパンリンクとして記録されます。これらは、Claude Code のクライアント側スパンをサーバー側トレースに接続し、準拠した仲介者を通じて接続します。アウトバウンド HTTP MCP リクエストは同じ方法で `traceparent` を含みます。ヘッダーはサードパーティプロバイダーには送信されません。191トレースがアクティブで Claude Code が Anthropic API に直接接続されている場合、各モデルリクエストは、`claude_code.llm_request` スパンのコンテキストに設定された W3C `traceparent` ヘッダーを含み、API の `traceresponse` ヘッダーはスパンリンクとして記録されます。これらは、Claude Code のクライアント側スパンをサーバー側トレースに接続し、準拠した仲介者を通じます。アウトバウンド HTTP MCP リクエストは同じ方法で `traceparent` を含みます。ヘッダーはサードパーティプロバイダーに送信されません。

188 192

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

190 194

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

192 196

193インバウンドトレースコンテキストは [イベント](#events)にも適用されます。`TRACEPARENT` が設定されている Agent SDK および `-p` セッションでは、各 OTLP イベントログレコードは `trace_id` および `span_id` 値を含み、トレースエクスポーターが設定されていない場合でも、これをアプリケーションのトレースに結合するため、ログバックエンドはイベントをトレースの残りの部分と相関させることができます。197インバウンドトレースコンテキストは[イベント](#events)にも適用されます。`TRACEPARENT` が設定された Agent SDK および `-p` セッションでは、各 OTLP イベントログレコードは `trace_id` および `span_id` 値を含み、トレースエクスポーターが設定されていない場合でも、ログバックエンドがイベントをトレースの残りの部分と相関させることができるため、アプリケーションのトレースに参加します。

194 198

195インタラクションがアクティブな間に出力されたレコードは、インタラクションスパンの ID を含み、Claude Code がそれをスパンの非同期コンテキスト外で出力する場合でも、例えば権限プロンプトコールバックまたはスタートアップ中にバッファリングされ、後で出力されたレコードの場合でも同様です。アクティブなインタラクションスパンなしで出力されたレコードは、インバウンド `TRACEPARENT` ID を直接含みます。v2.1.214 より前では、スパンの非同期コンテキスト外で出力されたレコードは、スパンの ID の代わりにインバウンド `TRACEPARENT` ID を含んでいました。v2.1.212 より前では、アクティブなスパン外で出力されたイベントレコードは `trace_id` または `span_id` を含んでいませんでした。199アクティブなインタラクション中に出力されたレコードは、インタラクションスパンの非同期コンテキスト外で出力される場合（許可プロンプトコールバックなど）でも、またはスタートアップ中にバッファリングされ後で出力されるレコードの場合でも、インタラクションスパンの ID を含みます。アクティブなインタラクションスパンなしで出力されたレコードは、インバウンド `TRACEPARENT` ID を直接含みます。v2.1.214 より前では、スパンの非同期コンテキスト外で出力されたレコードはインバウンド `TRACEPARENT` ID の代わりにスパンの ID を含みました。v2.1.212 より前では、アクティブなスパン外で出力されたイベントレコードは `trace_id` または `span_id` を含みませんでした。

196 200

197<h4 id="span-hierarchy">201<h4 id="span-hierarchy">

198 スパン階層202 スパン階層

199</h4>203</h4>

200 204

201各ユーザープロンプトは `claude_code.interaction` ルートスパンを開始します。API 呼び出し、ツール呼び出し、フック実行はその子として記録されます。ツールスパンには 2 つの子スパンがあります: 1 つは権限決定の待機に費やされた時間用、もう 1 つは実行自体用です。Agent ツール、またはレガシー Task ツールがサブエージェントを生成する場合、サブエージェントの API とツールスパンは親の `claude_code.tool` スパンの下にネストされます。205各ユーザープロンプトは `claude_code.interaction` ルートスパンを開始します。API 呼び出し、ツール呼び出し、およびフック実行はその子として記録されます。ツールスパンは 2 つの子スパンを持ちます：1 つは許可決定を待つ時間用で、もう 1 つは実行自体用です。Agent ツール、またはレガシー Task ツールがサブエージェントを生成する場合、サブエージェントの API およびツールスパンは親の `claude_code.tool` スパンの下にネストされます。

202 206

203```text theme={null}207```text theme={null}

204claude_code.interaction208claude_code.interaction

210 └── (Agent ツール) サブエージェント claude_code.llm_request / claude_code.tool スパン214 └── (Agent ツール) サブエージェント claude_code.llm_request / claude_code.tool スパン

211```215```

212 216

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

214 218

215`PreToolUse` フックが[ツール呼び出しを後で実行するために延期](/docs/ja/hooks#defer-a-tool-call-for-later)する場合、Claude Code はそれを延期したターンのトレースコンテキストを保存します。セッションを再開してツールが再実行されると、ツールのスパンはそれより前のターンのトレースに結合され、ターンの `claude_code.interaction` スパンの子になります。219`PreToolUse` フックが[ツール呼び出しを延期](/docs/ja/hooks#defer-a-tool-call-for-later)する場合、Claude Code はそれを延期したターンのトレースコンテキストを保存します。セッションを再開してツールが再実行される場合、ツールのスパンはそれより前のターンのトレースに参加し、ターンの `claude_code.interaction` スパンの子になります。

216 220

217<h4 id="span-attributes">221<h4 id="span-attributes">

218 スパン属性222 スパン属性

219</h4>223</h4>

220 224

221すべてのスパンは [標準属性](#standard-attributes)と、その名前に一致する `span.type` 属性を持ちます。以下の表は、各スパンに設定される追加属性をリストしています。`llm_request`、`tool.execution`、および `hook` スパンは、失敗を記録するときに OpenTelemetry ステータス `ERROR` を設定します。他のスパンは常にステータス `UNSET` で終了します。225すべてのスパンは[標準属性](#standard-attributes)と、その名前に一致する `span.type` 属性を含みます。以下の表は、各スパンに設定される追加属性をリストします。`llm_request`、`tool.execution`、および `hook` スパンは失敗を記録するときに OpenTelemetry ステータス `ERROR` を設定します。他のスパンは常にステータス `UNSET` で終了します。

222 226

223**`claude_code.interaction`**227**`claude_code.interaction`**

224 228

225| 属性 | 説明 | ゲート |229| 属性 | 説明 | ゲート対象 |

226| - | - | - |230| - | - | - |

229| `interaction.sequence` | インタラクションの 1 ベースカウンター。セッションごとではなく Claude Code プロセスごとにカウントされます。[`event.sequence`](#event-correlation-attributes)で説明されているとおり | |233| `interaction.sequence` | インタラクションの 1 ベースカウンター。Claude Code プロセスごとにカウントされ、セッションごとではなく、[`event.sequence`](#event-correlation-attributes)で説明されているように | |

230| `parent.source` | スパンがトレース親を取得した方法: インバウンド `TRACEPARENT` の下で親になった場合は `env`、独自のトレースを開始した場合は `none`。Claude Code v2.1.268 以降が必要です | |234| `parent.source` | スパンがトレース親を取得した方法：環境の `TRACEPARENT` から親になった場合は `env`、独自のトレースを開始した場合は `none`。Claude Code v2.1.268 以降が必要 | |

232 236

233**`claude_code.llm_request`**237**`claude_code.llm_request`**

234 238

235| 属性 | 説明 | ゲート |239| 属性 | 説明 | ゲート対象 |

236| - | - | - |240| - | - | - |

241| `query_source_safe` | `query_source` の制限された形式。詳細なベータトレースがアクティブかどうかに関わらず出力されます。`repl_main_thread` または `agent.builtin.general-purpose` などの値を持ちます。`:` は `.` になり、ユーザー名のエージェントは `agent.custom` として表示されます。Claude Code v2.1.268 以降が必要です | |245| `query_source_safe` | `query_source` の制限された形式。詳細なベータトレースがアクティブかどうかに関わらず出力され、`repl_main_thread` または `agent.builtin.general-purpose` などの値を持ちます。`:` は `.` になり、ユーザー名のエージェントは `agent.custom` として表示されます。Claude Code v2.1.268 以降が必要 | |

247| `effort` | [リクエストに適用される努力レベル](/docs/ja/model-config#adjust-effort-level): `low`、`medium`、`high`、`xhigh`、または `max`。Claude Code が努力レベルを送信しない場合は存在しません。例えば、努力をサポートしていないモデルの場合。Claude Code v2.1.274 以降が必要です | |251| `effort` | リクエストに適用される[努力レベル](/docs/ja/model-config#adjust-effort-level)：`low`、`medium`、`high`、`xhigh`、または `max`。Claude Code が努力レベルを送信しない場合（例えば、努力をサポートしないモデル）は不在。Claude Code v2.1.274 以降が必要 | |

251| `first_content_ms` | リクエスト開始から成功した試行の最初のコンテンツブロックまでの時間 (ミリ秒単位)。ストリーミング以外のパスにフォールバックしたリクエストでは存在しません。Claude Code v2.1.268 以降が必要です | |255| `first_content_ms` | リクエスト開始から成功した試行の最初のコンテンツブロックまでの時間（ミリ秒単位）。ストリーミングパスにフォールバックしたリクエストでは不在。Claude Code v2.1.268 以降が必要 | |

265| `stop_reason` | API レスポンス `stop_reason`。例: `end_turn`、`tool_use`、`max_tokens`、`stop_sequence`、`pause_turn`、または `refusal` | |269| `stop_reason` | API レスポンス `stop_reason`（`end_turn`、`tool_use`、`max_tokens`、`stop_sequence`、`pause_turn`、または `refusal` など） | |

267 271

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

269 273

270**`claude_code.tool`**274**`claude_code.tool`**

271 275

272| 属性 | 説明 | ゲート |276| 属性 | 説明 | ゲート対象 |

273| - | - | - |277| - | - | - |

275| `tool_name_safe` | ユーザーが選択した名前を含まない `tool_name` の形式。組み込みツール名はそのまま渡されます。MCP ツール名は `mcp_other` として表示されます。ただし、`playwright` ツールの `browser_*` など、固定の形状に一致するツール名は、そのまま渡されます。Claude Code v2.1.268 以降が必要です | |279| `tool_name_safe` | ユーザー選択の名前を含まない `tool_name` の形式。組み込みツール名はそのまま渡されます。MCP ツール名は `mcp_other` として表示されます。ただし、`playwright` ツール（`browser_*` という名前）など、固定の形状に一致するツール名は例外です。Claude Code v2.1.268 以降が必要 | |

276| `bash_command_class` | Bash ツールの場合: 固定リストからのコマンドの最初のプログラムのカテゴリ。例: `vcs` または `package_manager`。リスト外のプログラムの場合は `other`、行を解析できない場合は `unparsed`。Claude Code v2.1.268 以降が必要です | |280| `bash_command_class` | Bash ツール用：固定リストからのコマンドの最初のプログラムのカテゴリ（`vcs` または `package_manager` など）。リスト外のプログラムの場合は `other`、行を解析できない場合は `unparsed`。Claude Code v2.1.268 以降が必要 | |

277| `bash_argv0` | Bash ツールの場合: 同じ固定リスト上にあるコマンドの最初のプログラム。例: `git` または `npm`。リスト外のプログラムの場合は `other`。Claude Code v2.1.268 以降が必要です | |281| `bash_argv0` | Bash ツール用：同じ固定リスト上にあるコマンドの最初のプログラム（`git` または `npm` など）。リスト外のプログラムの場合は `other`。Claude Code v2.1.268 以降が必要 | |

284| `tool_use_id` | このコールのモデルの `tool_use` ブロック ID。[tool\_result](#tool-result-event) および [tool\_decision](#tool-decision-event) イベントおよびフックペイロード内の `tool_use_id` と一致するため、スパンをこれらのレコードに結合できます | |288| `tool_use_id` | このコールのモデルの `tool_use` ブロック ID。[tool\_result](#tool-result-event) および [tool\_decision](#tool-decision-event) イベント上の `tool_use_id` およびフックペイロード内と一致するため、スパンをそれらのレコードに参加させることができます | |

294

295<span id="tool-output-span-event" />**`claude_code.tool` 上の `tool.output` スパンイベント**

290 296

~~291<span id="tool-output-span-event" />**`tool.output` スパンイベント (`claude_code.tool` 上)**~~297`OTEL_LOG_TOOL_CONTENT=1` を設定した場合、Read および Bash 呼び出しは `claude_code.tool` スパン上に `tool.output` スパンイベントを記録できます。Edit および Write 呼び出しは、`OTEL_LOG_TOOL_DETAILS=1` も設定した場合にのみ 1 つを記録します。その変数はそれら 2 つのツールにスコープされていないため、設定テーブルの[その行](#common-configuration-variables)で追加される引数を確認してください。

292 298

293`OTEL_LOG_TOOL_CONTENT=1` を設定した場合、Read および Bash 呼び出しは `claude_code.tool` スパン上に `tool.output` スパンイベントを記録できます。Edit および Write 呼び出しは、`OTEL_LOG_TOOL_DETAILS=1` も設定した場合にのみ記録します。その変数はこれら 2 つのツールにスコープされていないため、設定テーブルの[その行](#common-configuration-variables)で、それが他の場所に追加する引数を確認してください。299MCP ツール、WebFetch、および WebSearch も Claude Code v2.1.283 以降でこのイベントを記録します。

294 300

295Claude Code はツール呼び出しの成功した戻りからこのイベントを書き込むため、エラーを発生させる呼び出しは何も記録しません。戻りを行う呼び出しの中で、以下の場合は `tool.output` イベントを記録しません:301Claude Code はツール呼び出しの成功した戻りからこのイベントを書き込むため、エラーを発生させる呼び出しは何も記録しません。戻りを行う呼び出しの中で、以下の場合は `tool.output` イベントを記録しません：

296 302

297* Read、Edit、Write、Bash 以外のツール (MCP ツールおよび WebFetch を含む) への呼び出し303* Read、Edit、Write、Bash、WebFetch、WebSearch、および MCP ツール以外のツールへの呼び出し

298* 画像、PDF、または内容が変更されていないファイルの再読み込みなど、ファイルテキスト以外のものを返す Read304* ファイルテキスト以外を返す Read（画像、PDF、または内容が変更されていないファイルの再読み込みなど）

299* `OTEL_LOG_TOOL_DETAILS=1` も設定しない限り、Edit または Write 呼び出し305* `OTEL_LOG_TOOL_DETAILS=1` も設定していない限り、Edit または Write 呼び出し

306* Claude Code がターンを中断して[キューに入れたメッセージをすぐに送信](/docs/ja/interactive-mode#when-claude-code-sends-what-you-queued)している間に実行していた WebFetch または WebSearch 呼び出し。Claude はその結果をツールスパンが終了した後に受け取ります

300 307

301イベントはこれらの属性を含み、各属性はコンテンツ制限で切り詰められます (デフォルト: 60 KB)。`Gated by` は、属性が必要とする変数を名前付けます。Edit および Write の場合、その変数は属性ではなくイベント自体をゲートします。308イベントはこれらの属性を含み、各属性はコンテンツ制限（デフォルト 60 KB）で切り詰められます。`ゲート対象` は、属性が `OTEL_LOG_TOOL_CONTENT=1` の上に必要とする変数を名前付けし、Edit および Write の場合、その変数は属性ではなくイベント自体をゲートします。

302 309

303| 属性 | 説明 | ゲート |310| 属性 | 説明 | ゲート対象 |

304| - | - | - |311| - | - | - |

310 317

311親スパンの `tool_name` 属性は、イベントがどのツールから来たかを示します。コンテンツ制限で切り詰められた属性には、`<attribute>_truncated` および `<attribute>_original_length` が付属します。318親スパンの `tool_name` 属性は、イベントがどのツールから来たかを示します。コンテンツ制限で切り詰められた属性には、`<attribute>_truncated` および `<attribute>_original_length` が付属しています。

312 319

313**`claude_code.tool.blocked_on_user`**320**`claude_code.tool.blocked_on_user`**

314 321

315| 属性 | 説明 | ゲート |322| 属性 | 説明 | ゲート対象 |

316| - | - | - |323| - | - | - |

320 327

321**`claude_code.tool.execution`**328**`claude_code.tool.execution`**

322 329

323| 属性 | 説明 | ゲート |330| 属性 | 説明 | ゲート対象 |

324| - | - | - |331| - | - | - |

330| `error_class` | 文字、数字、アンダースコア以外の文字を `_` に置き換えた識別子形式のエラーカテゴリ。例: `Error_ENOENT` または `ShellError`。`error` が完全なメッセージを含む場合でもカテゴリを含みます。Claude Code v2.1.268 以降が必要です | |337| `error_class` | 識別子形式のエラーカテゴリ。文字、数字、アンダースコア以外の文字は `_` に置き換えられます（`Error_ENOENT` または `ShellError` など）。`error` が完全なメッセージを含む場合でもカテゴリを含みます。Claude Code v2.1.268 以降が必要 | |

331 338

332**`claude_code.hook`**339**`claude_code.hook`**

333 340

334このスパンは、詳細なベータトレースがアクティブな場合にのみ出力されます。これには `ENABLE_BETA_TRACING_DETAILED=1` と `BETA_TRACING_ENDPOINT` が必要です。このペアは、[ログとトレースの送信先を変更](/docs/ja/env-vars#variables)します。ペアをシェル、ユーザー設定、または管理設定で設定します。両方の変数は [プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。`CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` のみでは出力されません。341このスパンは、詳細なベータトレースがアクティブな場合にのみ表示されます。これには `ENABLE_BETA_TRACING_DETAILED=1` と `BETA_TRACING_ENDPOINT` が必要です。このペアは、ログとトレースの送信先も[変更](/docs/ja/env-vars#variables)します。シェル、ユーザー設定、または管理設定でペアを設定します。両方の変数は[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。`CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` だけではそれを生成しません。

335 342

336対話型 CLI セッションでは、詳細なベータトレースは、組織がこの機能のホワイトリストに登録されていることも必要です。Agent SDK および非対話型 `-p` セッションはホワイトリストを必要としません。343対話型 CLI セッションでは、詳細なベータトレースは、組織がこの機能のホワイトリストに登録されていることも必要です。Agent SDK および非対話型 `-p` セッションはホワイトリスト登録を必要としません。

337 344

338| 属性 | 説明 | ゲート |345| 属性 | 説明 | ゲート対象 |

339| - | - | - |346| - | - | - |

349 356

350<span id="new-context-gates" />357<span id="new-context-gates" />

351 358

352<Note>359<Note>

353 `new_context`、`system_prompt_preview`、`user_system_prompt`、`tool_input`、`response.model_output` などの追加のコンテンツを含む属性は、詳細なベータトレースがアクティブな場合にのみ出力されます。これらは安定したスパンスキーマの一部ではありません。360 `new_context`、`system_prompt_preview`、`user_system_prompt`、`tool_input`、および `response.model_output` などの追加のコンテンツを含む属性は、詳細なベータトレースがアクティブな場合にのみ出力されます。これらは安定したスパンスキーマの一部ではありません。

354 361

355 `new_context` のゲートは、どのスパンがそれを含むかに依存し、各コピーはコンテンツ制限で切り詰められます (デフォルト: 60 KB)。`claude_code.tool` スパン上では、そのツール呼び出しの結果を含み、ツールに関わらず、`OTEL_LOG_TOOL_CONTENT=1` が必要です。`claude_code.interaction` スパン上では、ユーザープロンプトを含み、`claude_code.llm_request` スパン上ではそのリクエストの新しいユーザーメッセージとツール結果を含みます。どちらも `OTEL_LOG_USER_PROMPTS=1` が必要です。362 `new_context` 上のゲートは、それを含むスパンに依存し、各コピーはコンテンツ制限（デフォルト 60 KB）で切り詰められます。`claude_code.tool` スパン上では、ツールに関わらずそのツール呼び出しの結果を含み、`OTEL_LOG_TOOL_CONTENT=1` が必要です。`claude_code.interaction` スパン上ではユーザープロンプトを含み、`claude_code.llm_request` スパン上ではそのリクエストの新しいユーザーメッセージとツール結果を含みます。どちらも `OTEL_LOG_USER_PROMPTS=1` が必要です。

356 363

357 `user_system_prompt` はさらに `OTEL_LOG_USER_PROMPTS=1` が必要です。これは `systemPrompt` SDK オプションまたは `--system-prompt` および `--append-system-prompt` フラグを通じて提供するシステムプロンプトテキストのみを含み、コンテンツ制限で切り詰められ (デフォルト: 60 KB)、リクエストごとではなくセッションごとに 1 回出力されます。364 `user_system_prompt` はさらに `OTEL_LOG_USER_PROMPTS=1` が必要です。`systemPrompt` SDK オプションまたは `--system-prompt` および `--append-system-prompt` フラグを通じて提供するシステムプロンプトテキストのみを含み、コンテンツ制限（デフォルト 60 KB）で切り詰められ、リクエストごとではなくセッションごとに 1 回出力されます。

358</Note>365</Note>

359 366

360<h3 id="dynamic-headers">367<h3 id="dynamic-headers">

361 動的ヘッダー368 動的ヘッダー

362</h3>369</h3>

363 370

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

365 372

366<h4 id="settings-configuration">373<h4 id="settings-configuration">

367 設定ファイルの設定374 設定の設定

368</h4>375</h4>

369 376

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

371 378

372```json theme={null}379```json theme={null}

373{380{

375}382}

376```383```

377 384

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

379 386

380<h4 id="script-requirements">387<h4 id="script-requirements">

381 スクリプト要件388 スクリプト要件

382</h4>389</h4>

383 390

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

385 392

386```bash theme={null}393```bash theme={null}

387#!/bin/bash394#!/bin/bash

388# 例: 複数のヘッダー395# 例：複数のヘッダー

389echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"396echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

390```397```

391 398

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

393 400

394* 対話型セッションの警告通知。[`otelHeadersHelper failed; telemetry is not being exported`](/docs/ja/errors#otelheadershelper-failed)。ヘルパーが最初に失敗したときにセッションごとに 1 回表示されます401* 対話型セッションの警告通知。[`otelHeadersHelper failed; telemetry is not being exported`](/docs/ja/errors#otelheadershelper-failed)。ヘルパーが最初に失敗したときにセッションごとに 1 回表示されます

395* `/status` 出力402* `/status` 出力

396* [`--debug`](/docs/ja/cli-reference#cli-flags) で実行するか、セッション内で `/debug` を実行した後のデバッグログ403* [`--debug`](/docs/ja/cli-reference#cli-flags) で実行するか、セッション内で `/debug` を実行した後のデバッグログ

397* stderr、`-p` で開始された非対話型セッション内404* `-p` で開始された非対話型セッションの stderr

398 405

399<h4 id="refresh-behavior">406<h4 id="refresh-behavior">

400 リフレッシュ動作407 リフレッシュ動作

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

407</h3>414</h3>

408 415

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

410 417

411```bash theme={null}418```bash theme={null}

412# チーム識別用のカスタム属性を追加する419# チーム識別用のカスタム属性を追加

413export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"420export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

414```421```

415 422

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

417 424

418* チームまたは部門別にメトリクスをフィルタリングする425* チームまたは部門別にメトリクスをフィルタリング

419* コストセンターごとのコストを追跡する426* コストセンターごとのコストを追跡

420* チーム固有のダッシュボードを作成する427* チーム固有のダッシュボードを作成

421* 特定のチームのアラートを設定する428* 特定のチーム向けのアラートを設定

422 429

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

424 431

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

426 433

427<Warning>434<Warning>

428 `OTEL_RESOURCE_ATTRIBUTES` 環境変数はカンマ区切りのキー=値ペアを使用し、厳密なフォーマット要件があります:435 `OTEL_RESOURCE_ATTRIBUTES` 環境変数は、厳密なフォーマット要件を持つカンマ区切りのキー=値ペアを使用します：

429 436

430 * **スペースは許可されません**: 値にスペースを含めることはできません。例えば、`user.organizationName=My Company` は無効です437 * **スペースは許可されません**：値にはスペースを含めることはできません。例えば、`user.organizationName=My Company` は無効です

431 * **フォーマット**: カンマ区切りのキー=値ペアである必要があります: `key1=value1,key2=value2`438 * **形式**：カンマ区切りのキー=値ペアである必要があります：`key1=value1,key2=value2`

432 * **許可される文字**: 制御文字、空白、ダブルクォート、カンマ、セミコロン、バックスラッシュを除く US-ASCII 文字のみ439 * **許可される文字**：制御文字、空白、二重引用符、カンマ、セミコロン、およびバックスラッシュを除く US-ASCII 文字のみ

433 * **特殊文字**: 許可された範囲外の文字はパーセントエンコードする必要があります440 * **特殊文字**：許可された範囲外の文字は、パーセントエンコードされる必要があります

434 441

435 スペースが必要な値の場合は、代わりにアンダースコアまたはキャメルケースを使用します。以下の例は、各形式で `org.name` を設定します:442 スペースが必要な値の場合は、アンダースコアまたは camelCase を代わりに使用します。次の例は、各形式で `org.name` を設定します：

436 443

437 ```bash theme={null}444 ```bash theme={null}

438 export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"445 export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"

439 export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"446 export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

440 ```447 ```

441 448

442 許可された範囲外の文字だけでなく、任意の文字をパーセントエンコードできます。この例は、スペースとアポストロフィの両方をエンコードします:449 許可された文字のみでなく、任意の文字をパーセントエンコードできます。この例は、スペースとアポストロフィの両方をエンコードします：

443 450

444 ```bash theme={null}451 ```bash theme={null}

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

446 ```453 ```

447 454

448 値をクォートで囲むことはスペースをエスケープしません。例えば、`org.name="My Company"` は `My Company` ではなく、リテラル値 `"My Company"` (クォート付き) になります。455 値を引用符で囲むことはスペースをエスケープしません。例えば、`org.name="My Company"` は、`My Company` ではなく、引用符を含む `"My Company"` というリテラル値になります。

449</Warning>456</Warning>

450 457

451<h3 id="example-configurations">458<h3 id="example-configurations">

452 設定例459 設定例

453</h3>460</h3>

454 461

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

456 463

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

458 465

459```bash theme={null}466```bash theme={null}

460export CLAUDE_CODE_ENABLE_TELEMETRY=1467export CLAUDE_CODE_ENABLE_TELEMETRY=1

462export OTEL_METRIC_EXPORT_INTERVAL=1000469export OTEL_METRIC_EXPORT_INTERVAL=1000

463```470```

464 471

465OTLP over gRPC:472OTLP over gRPC の場合：

466 473

467```bash theme={null}474```bash theme={null}

468export CLAUDE_CODE_ENABLE_TELEMETRY=1475export CLAUDE_CODE_ENABLE_TELEMETRY=1

471export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317478export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

472```479```

473 480

474Prometheus (`http://localhost:9464/metrics` からスクレイプ):481Prometheus の場合。`http://localhost:9464/metrics` からスクレイプ：

475 482

476```bash theme={null}483```bash theme={null}

477export CLAUDE_CODE_ENABLE_TELEMETRY=1484export CLAUDE_CODE_ENABLE_TELEMETRY=1

478export OTEL_METRICS_EXPORTER=prometheus485export OTEL_METRICS_EXPORTER=prometheus

479```486```

480 487

481[自己ホスト環境](/docs/ja/self-hosted-environments-reference#pass-through-session-child-metrics)では、セッションはランナーのデフォルト容量である 1 でのみポート 9464 をバインドします。より高い容量では、ランナーは代わりに独自の `/metrics` エンドポイントでセッションカウンターとゲージを再公開します。488[自己ホスト環境](/docs/ja/self-hosted-environments-reference#pass-through-session-child-metrics)では、セッションはランナーのデフォルト容量 1 でのみポート 9464 をバインドします。容量が高い場合、ランナーは代わりに独自の `/metrics` エンドポイント上でセッションカウンターとゲージを再公開します。

482 489

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

484 491

485```bash theme={null}492```bash theme={null}

486export CLAUDE_CODE_ENABLE_TELEMETRY=1493export CLAUDE_CODE_ENABLE_TELEMETRY=1

488export OTEL_EXPORTER_OTLP_PROTOCOL=http/json495export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

489```496```

490 497

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

492 499

493```bash theme={null}500```bash theme={null}

494export CLAUDE_CODE_ENABLE_TELEMETRY=1501export CLAUDE_CODE_ENABLE_TELEMETRY=1

500export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317507export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

501```508```

502 509

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

504 511

505```bash theme={null}512```bash theme={null}

506export CLAUDE_CODE_ENABLE_TELEMETRY=1513export CLAUDE_CODE_ENABLE_TELEMETRY=1

509export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317516export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

510```517```

511 518

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

513 520

514```bash theme={null}521```bash theme={null}

515export CLAUDE_CODE_ENABLE_TELEMETRY=1522export CLAUDE_CODE_ENABLE_TELEMETRY=1

518export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317525export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

519```526```

520 527

528<h2 id="telemetry-from-cloud-sessions-and-claude-tag">

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

530</h2>

531

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

533

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

535

536* **サーバー管理設定**: 組織の [サーバー管理設定](/docs/ja/server-managed-settings) の `env` ブロックに追加します。Claude Code は [サーバー管理設定が適用される](/docs/ja/model-config#surface-coverage) 場所（ユーザーのマシンと Claude Tag チャネルセッション以外のクラウドセッションを含む）で起動時にこれらの設定を取得します。Claude Tag セッションはサーバー管理設定を受け取らないため、このルートではそれらを設定できません。

537* **環境の変数**: クラウド環境の [環境変数](/docs/ja/cloud-environments#set-environment-variables) に追加して、その環境で実行されるセッションのみを設定します。これは Claude Tag セッションに到達するルートです。

538

539環境を使用する誰もがその変数を読み取ることができるため、`OTEL_EXPORTER_OTLP_HEADERS` のコレクタートークンなどの認証情報をそこに配置しないでください。環境の [API 認証情報](/docs/ja/cloud-environments#add-api-credentials) も役に立ちません。Claude Code 独自のテレメトリエクスポートは、[認証情報を取得しないリクエスト](/docs/ja/cloud-environments#requests-that-never-get-the-credential) の 1 つだからです。コレクターが認証情報を必要とする場合は、代わりにサーバー管理設定を通じてエクスポート全体を設定してください。認証情報をそこに設定すると、[Claude Code は管理設定外で設定されたエンドポイント変数を削除します](#how-managed-settings-lock-the-otlp-destination)。

540

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

542

543* **セッションがコレクターに到達できるようにする**: Claude Code はセッションのネットワークを通じてエクスポートを送信するため、`OTEL_EXPORTER_OTLP_ENDPOINT` のホストに到達できるかどうかは、環境の [ネットワークアクセスレベル](/docs/ja/cloud-environments#access-levels) によって異なります。セッションが選択したレベルでコレクターのドメインに到達できない場合は、[ドメインを環境のアローリストに追加してください](/docs/ja/cloud-environments#allow-specific-domains)。サーバー管理設定はドメインを環境のネットワークアローリストに追加しないためです。

544* **Claude Tag チャネルは組織レベルの環境を使用します**: チャネルセッションはメンバーの個人環境ではなく組織レベルの環境で実行されるため、[共有環境](/docs/ja/cloud-environments#organization-shared-environments) でアローリストと環境変数の変更を行い、組織のデフォルトとして設定するか、チャネルにピン留めしてください。

545* **Cowork は個別に設定されます**: [サーフェスカバレッジテーブル](/docs/ja/model-config#surface-coverage) に示されているように、Cowork セッションはサーバー管理設定を受け取らないため、サーバー管理 `env` ブロックはそれらのテレメトリを設定しません。

546

547<h3 id="attribute-telemetry-to-cloud-sessions">

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

549</h3>

550

551デフォルトでは、クラウドセッションからのメトリクスとイベントは、`session.id`、`ccr.session.id`、`organization.id` を含む [標準属性](#standard-attributes) を含むため、追加の設定なしでセッションまたは組織でフィルタリングできます。`ccr.session.id` の値はセッションの `CLAUDE_CODE_REMOTE_SESSION_ID` です。これをセッションのトランスクリプト URL に変換するには、[出力をセッションにリンク戻す](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください。

552

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

554

555* **Claude Tag セッションを識別する**: [メトリクスカーディナリティ制御](#metrics-cardinality-control) で説明されているように、`OTEL_METRICS_INCLUDE_ENTRYPOINT=true` を設定します。メトリクスは `app.entrypoint` を含むようになり、Claude Tag セッションの値は `claude-in-slack` です。

556* **カスタム属性を追加する**: これらのセッションの他の `OTEL_*` 変数を設定する場所と同じ場所に [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) を設定します。代わりに環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) でそれを `export` する場合、値は Claude Code に到達しません。セットアップスクリプトは Claude Code が起動する前に実行される別の Bash スクリプトであり、それがエクスポートする変数はそれで終わります。

557

558Claude Tag チャネルセッションでは、Claude はメンバーではなく組織の [共有 ID](/docs/ja/cloud-environments#set-the-environment-a-claude-tag-channel-uses) として機能するため、`user.*` 属性に依存して Claude にタグを付けたユーザーを識別しないでください。

559

521<h2 id="available-metrics-and-events">560<h2 id="available-metrics-and-events">

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

523</h2>562</h2>

531| 属性 | 説明 | 制御対象 |570| 属性 | 説明 | 制御対象 |

532| - | - | - |571| - | - | - |

573| `ccr.session.id` | クラウドセッション識別子。[クラウド環境](/docs/ja/cloud-environments)で実行されるセッションの `CLAUDE_CODE_REMOTE_SESSION_ID` の値 | `OTEL_METRICS_INCLUDE_SESSION_ID`（デフォルト: true） |

542| `OTEL_RESOURCE_ATTRIBUTES` からのキー | `department` や `team.id` など、設定したカスタム属性。[マルチチーム組織サポート](#multi-team-organization-support) を参照 | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`（デフォルト: true） |582| `OTEL_RESOURCE_ATTRIBUTES` からのキー | `department` や `team.id` など、設定したカスタム属性。[マルチチーム組織サポート](#multi-team-organization-support)を参照 | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`（デフォルト: true） |

543| `vcs.repository.url.full`、`vcs.owner.name`、`vcs.repository.name`、`vcs.provider.name` | セッションリポジトリの ID。`origin` リモートから派生。[リポジトリ属性](#repository-attributes) を参照 | `OTEL_METRICS_INCLUDE_REPOSITORY`（デフォルト: false）。Claude Code v2.1.269 以降が必要 |583| `vcs.repository.url.full`、`vcs.owner.name`、`vcs.repository.name`、`vcs.provider.name` | セッションリポジトリの ID。`origin` リモートから派生。[リポジトリ属性](#repository-attributes)を参照 | `OTEL_METRICS_INCLUDE_REPOSITORY`（デフォルト: false）。Claude Code v2.1.269 以降が必要 |

544 584

545Claude Code が [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway) にサインインしている場合、CLI はゲートウェイセッションの認証済みアイデンティティでエクスポートをスタンプします。`user.id` は匿名インストール識別子ではなく IdP サブジェクト、`user.email` はサインイン済みメール、`user.groups` は IdP グループメンバーシップをコンマ区切り文字列として保持します。各エクスポートは `identity.source: gateway-oidc` も保持します。ゲートウェイアイデンティティは最後に適用されるため、`OTEL_RESOURCE_ATTRIBUTES` を通じて設定された `user.*` および `identity.*` キーはゲートウェイセッションで無視されます。585Claude Code が[Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway)にサインインしている場合、CLI はゲートウェイセッションの認証済みアイデンティティでエクスポートをスタンプします。`user.id` は匿名インストール識別子ではなく IdP サブジェクト、`user.email` はサインイン済みメール、`user.groups` は IdP グループメンバーシップをカンマ区切り文字列として保持します。各エクスポートは `identity.source: gateway-oidc` も保持します。ゲートウェイアイデンティティは最後に適用されるため、`OTEL_RESOURCE_ATTRIBUTES` を通じて設定された `user.*` および `identity.*` キーはゲートウェイセッションで無視されます。

546 586

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

548 588

549* `prompt.id`: ユーザープロンプトと、次のプロンプトまでのすべての後続イベントを相関させる UUID。[イベント相関属性](#event-correlation-attributes) を参照。589* `prompt.id`: ユーザープロンプトと、次のプロンプトまでのすべての後続イベントを相関させる UUID。[イベント相関属性](#event-correlation-attributes)を参照。

550* `workspace.host_paths`: デスクトップアプリで選択されたホストワークスペースディレクトリ。文字列配列として590* `workspace.host_paths`: デスクトップアプリで選択されたホストワークスペースディレクトリ。文字列配列として

551* `workflow.run_id`: [Workflow](/docs/ja/workflows) ツール実行に属するエージェントが発行する API およびツールイベントのプレフィックス `wf_` の実行識別子。イベントを 1 つの `workflow.run_id` でフィルタリングすると、その実行の API リクエストとツール結果が再構成されます。識別子は、ワークフロースクリプトが生成するエージェントと、それらが順番に生成するエージェント（スキル呼び出しなど）をカバーします。Workflow ツール結果で報告される実行識別子と一致します。他のすべてのイベントには存在しません。Claude Code v2.1.202 以降が必要591* `workflow.run_id`: [Workflow](/docs/ja/workflows) ツール実行に属するエージェントが発行する API およびツールイベントの実行識別子。プレフィックス `wf_` 付き。1 つの `workflow.run_id` でイベントをフィルタリングすると、その実行の API リクエストとツール結果が再構成されます。識別子は、ワークフロースクリプトが生成するエージェントと、それらが順番に生成するエージェント（スキル呼び出しなど）をカバーします。Workflow ツール結果で報告される実行識別子と一致します。他のすべてのイベントでは不在。Claude Code v2.1.202 以降が必要

552* `workflow.name`: ワークフローの名前。スクリプトの `meta.name`。`workflow.run_id` と一緒に発行されます。実行が未修正の組み込みスクリプトを実行する場合、組み込みワークフロー名はそのまま表示されます。ユーザー作成の名前（組み込みスクリプトの編集済みコピーを含む）は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` に置き換えられます。Claude Code v2.1.202 以降が必要592* `workflow.name`: ワークフロー名。スクリプトの `meta.name`。`workflow.run_id` と一緒に発行されます。実行が未修正の組み込みスクリプトを実行する場合、組み込みワークフロー名はそのまま表示されます。ユーザー作成の名前（組み込みスクリプトの編集済みコピーを含む）は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` に置き換えられます。Claude Code v2.1.202 以降が必要

553 593

554<h4 id="repository-attributes">594<h4 id="repository-attributes">

555 リポジトリ属性595 リポジトリ属性

556</h4>596</h4>

557 597

558`OTEL_METRICS_INCLUDE_REPOSITORY=true` を設定して、メトリクスとイベントをセッションのリポジトリの ID でタグ付けします。共有コレクターが使用状況をリポジトリごとに属性付けできるようにします。Claude Code v2.1.269 以降が必要です。598`OTEL_METRICS_INCLUDE_REPOSITORY=true` を設定して、セッションのリポジトリの ID でメトリクスとイベントにタグを付けます。共有コレクターがリポジトリごとに使用状況を属性付けできるようにします。Claude Code v2.1.269 以降が必要。

559 599

560Claude Code はセッションごとに 1 回、リポジトリの `origin` リモートからこれらの属性を派生させます。1 つのリポジトリの HTTPS および SSH リモートは同じ値を生成します。600Claude Code はセッションごとに 1 回、リポジトリの `origin` リモートからこれらの属性を派生させます。リポジトリの HTTPS および SSH リモートが同じホストと同じパスに名前を付ける場合（GitHub、GitLab、Bitbucket Cloud の場合と同様）、両方とも同じ値を生成します。

561 601

562| 属性 | 値 |602| 属性 | 値 |

563| - | - |603| - | - |

567| `vcs.provider.name` | Claude Code がリモートのホストまたは URL 形状を `github`、`gitlab`、`bitbucket`、`gitea` のいずれかとして認識する場合はそのプロバイダー。それ以外の場合は省略 |607| `vcs.provider.name` | Claude Code がリモートのホストまたは URL 形状を `github`、`gitlab`、`bitbucket`、`gitea` のいずれかとして認識する場合、その値。それ以外の場合は省略 |

568 608

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

570 610

571[`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) で宣言した `vcs.*` キーは、そのキーの派生値を置き換えます。`vcs.repository.url.full` を宣言した場合、Claude Code はリモートを読み取らず、宣言したキーのみを報告します。611[クラウドセッション](/docs/ja/claude-code-on-the-web)からこれらの属性を取得するには、`OTEL_METRICS_INCLUDE_REPOSITORY` を含むテレメトリ変数を[クラウド環境](/docs/ja/cloud-environments#set-environment-variables)に設定します。また、環境の[ネットワークアクセス](/docs/ja/cloud-environments#network-access)でコレクターのドメインを許可します。

612

613[`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) で宣言した `vcs.*` キーは、そのキーの派生値を置き換えます。`vcs.repository.url.full` を宣言する場合、Claude Code はリモートを読み取らず、宣言したキーのみを報告します。

572 614

573属性は独自のエクスポーターにのみフローします。Anthropic のテレメトリはすべての `vcs.*` キーをドロップします。6151 つのリポジトリの HTTPS および SSH クローンが異なる値を報告する場合（例：HTTPS クローン URL がパスプレフィックスを持つ自己ホスト型インストール）、`OTEL_RESOURCE_ATTRIBUTES` で `vcs.repository.url.full` と、報告したい他のすべての `vcs.*` キーを宣言します。すべてのクローンは、宣言したアイデンティティを報告します。

616

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

574 618

575<h3 id="metrics">619<h3 id="metrics">

576 メトリクス620 メトリクス

589| `claude_code.code_edit_tool.decision` | コード編集ツール権限決定のカウント | なし |633| `claude_code.code_edit_tool.decision` | コード編集ツール権限決定のカウント | なし |

590| `claude_code.active_time.total` | 総アクティブ時間 | s |634| `claude_code.active_time.total` | 総アクティブ時間 | s |

591 635

592`prometheus` が `OTEL_METRICS_EXPORTER` にリストされた唯一のエクスポーターである場合、Claude Code はエクスポートされたメトリクスから `USD`、`tokens`、`s` ユニットを省略して、スクレイプが有効な Prometheus テキスト形式のままになるようにします。メトリクス名は変わらず、`otlp,prometheus` などのエクスポーターを組み合わせた設定はユニットを保持します。v2.1.216 より前では、Prometheus スクレイプには OpenMetrics のみの `# UNIT` 行が含まれていて、一部のスクレイパーが拒否していました。636`prometheus` が `OTEL_METRICS_EXPORTER` にリストされた唯一のエクスポーターである場合、Claude Code はエクスポートされたメトリクスから `USD`、`tokens`、`s` ユニットを省略して、スクレイプが有効な Prometheus テキスト形式のままになるようにします。メトリクス名は変わらず、`otlp,prometheus` などのエクスポーターを組み合わせる設定はユニットを保持します。v2.1.216 より前では、Prometheus スクレイプには OpenMetrics のみの `# UNIT` 行が含まれていて、一部のスクレイパーが拒否していました。

593 637

594<h3 id="metric-details">638<h3 id="metric-details">

595 メトリクスの詳細639 メトリクスの詳細

605 649

606**属性**:650**属性**:

607 651

608* すべての [標準属性](#standard-attributes)652* すべての[標準属性](#standard-attributes)

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

610 654

611<h4 id="lines-of-code-counter">655<h4 id="lines-of-code-counter">

612 コード行カウンター656 コード行カウンター

616 660

617**属性**:661**属性**:

618 662

619* すべての [標準属性](#standard-attributes)663* すべての[標準属性](#standard-attributes)

620* `type`: （`"added"`、`"removed"`）664* `type`: （`"added"`、`"removed"`）

621* `model`: 変更を加えたモデルのモデル識別子（例：「claude-sonnet-5」）665* `model`: 変更を加えたモデルのモデル識別子（例：「claude-sonnet-5」）

622 666

628 672

629**属性**:673**属性**:

630 674

631* すべての [標準属性](#standard-attributes)675* すべての[標準属性](#standard-attributes)

632 676

633<h4 id="commit-counter">677<h4 id="commit-counter">

634 コミットカウンター678 コミットカウンター

638 682

639**属性**:683**属性**:

640 684

641* すべての [標準属性](#standard-attributes)685* すべての[標準属性](#standard-attributes)

642 686

643<h4 id="cost-counter">687<h4 id="cost-counter">

644 コストカウンター688 コストカウンター

646 690

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

648 692

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

694

649**属性**:695**属性**:

650 696

651* すべての [標準属性](#standard-attributes)697* すべての[標準属性](#standard-attributes)

652* `model`: モデル識別子（例：「claude-sonnet-5」）698* `model`: モデル識別子（例：「claude-sonnet-5」）

653* `query_source`: リクエストを発行したサブシステムのカテゴリ。`"main"`、`"subagent"`、または `"auxiliary"` のいずれか699* `query_source`: リクエストを発行したサブシステムのカテゴリ。`"main"`、`"subagent"`、または `"auxiliary"` のいずれか

654* `speed`: リクエストが高速モードを使用した場合は `"fast"`。それ以外の場合は存在しません700* `speed`: リクエストが高速モードを使用した場合は `"fast"`。それ以外の場合は不在

655* `effort`: リクエストに適用された [努力レベル](/docs/ja/model-config#adjust-effort-level)。`"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"`。モデルが努力をサポートしていない場合は存在しません。701* `effort`: リクエストに適用された[努力レベル](/docs/ja/model-config#adjust-effort-level)。`"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"`。Claude Code が努力レベルを送信しない場合（例：努力をサポートしないモデル）は不在。

656* `agent.name`: リクエストを発行したサブエージェントタイプ。組み込みエージェント名と公式マーケットプレイスプラグインのエージェントはそのまま表示されます。その他のユーザー定義エージェント名は `"custom"` に置き換えられます。`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り。リクエストが名前付きサブエージェントタイプによって発行されなかった場合は存在しません。702* `agent.name`: リクエストを発行したサブエージェントタイプ。組み込みエージェント名と公式マーケットプレイスプラグインのエージェントはそのまま表示されます。その他のユーザー定義エージェント名は `"custom"` に置き換えられます。名前付きサブエージェントタイプによってリクエストが発行されなかった場合は不在。

657* `skill.name`: リクエストに対してアクティブなスキル。Skill ツール、`/` コマンド、または生成されたサブエージェントによって継承されて設定されます。組み込み、バンドル、ユーザー定義、および公式マーケットプレイスプラグインスキル名はそのまま表示されます。サードパーティプラグインスキル名は `"third-party"` に置き換えられます。`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り。アクティブなスキルがない場合は存在しません。703* `skill.name`: リクエストに対してアクティブなスキル。Skill ツールまたは `/` コマンドで設定、または生成されたサブエージェントによって継承されます。組み込み、バンドル、ユーザー定義、公式マーケットプレイスプラグインスキル名はそのまま表示されます。サードパーティプラグインスキル名は `"third-party"` に置き換えられます。アクティブなスキルがない場合は不在。

658* `plugin.name`: アクティブなスキルまたはサブエージェントを提供するプラグインの所有者。公式マーケットプレイスプラグイン名はそのまま表示されます。サードパーティプラグイン名は `"third-party"` に置き換えられます。`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り。スキルもサブエージェントも所有プラグインを持たない場合は存在しません。704* `plugin.name`: アクティブなスキルまたはサブエージェントが提供されるプラグイン。公式マーケットプレイスプラグイン名はそのまま表示されます。サードパーティプラグイン名は `"third-party"` に置き換えられます。スキルもサブエージェントも所有プラグインを持たない場合は不在。

659* `marketplace.name`: 所有プラグインがインストールされたマーケットプレイス。公式マーケットプレイスプラグインに対してのみ発行されます。それ以外の場合は存在しません。705* `marketplace.name`: 所有プラグインがインストールされたマーケットプレイス。`OTEL_LOG_TOOL_DETAILS=1` が設定されていても、公式マーケットプレイスプラグインに対してのみ発行されます。それ以外の場合は不在。

660* `mcp_server.name`: このリクエストがツール結果を使用した MCP サーバー。組み込み、claude.ai プロキシ、および公式レジストリサーバー名はそのまま表示されます。ユーザー設定サーバー名は `"custom"` に置き換えられます。`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り。リクエストが MCP ツール結果を使用しなかった場合は存在しません。v2.1.222 より前では、Claude Code は MCP ツール呼び出し後のすべてのリクエストにこの属性を設定していました。ツール結果を使用したリクエストのみではなく、アップグレード後のダッシュボードがこれを集計すると段階的に低下します。706* `mcp_server.name`: このリクエストが消費したツール結果の MCP サーバー。組み込み、claude.ai プロキシ、公式レジストリサーバー名はそのまま表示されます。ユーザー設定サーバー名は `"custom"` に置き換えられます。リクエストが MCP ツール結果を消費しなかった場合は不在。v2.1.222 より前では、Claude Code は MCP ツール呼び出し後のすべてのリクエストにこの属性を設定していて、ツール結果を消費したリクエストのみではなかったため、アップグレード後にこれを集計するダッシュボードは段階的に低下します。

661* `mcp_tool.name`: このリクエストがツール結果を使用した MCP ツール。`mcp_server.name` と同じ削除およびバージョン動作を持ちます。リクエストが MCP ツール結果を使用しなかった場合は存在しません。707* `mcp_tool.name`: このリクエストが消費したツール結果の MCP ツール。`mcp_server.name` と同じ難読化およびバージョン動作。リクエストが MCP ツール結果を消費しなかった場合は不在。

662 708

663<h4 id="token-counter">709<h4 id="token-counter">

664 トークンカウンター710 トークンカウンター

668 714

669**属性**:715**属性**:

670 716

671* すべての [標準属性](#standard-attributes)717* すべての[標準属性](#standard-attributes)

672* `type`: （`"input"`、`"output"`、`"cacheRead"`、`"cacheCreation"`）718* `type`: （`"input"`、`"output"`、`"cacheRead"`、`"cacheCreation"`）

673* `model`: モデル識別子（例：「claude-sonnet-5」）719* `model`: モデル識別子（例：「claude-sonnet-5」）

674* `query_source`: リクエストを発行したサブシステムのカテゴリ。`"main"`、`"subagent"`、または `"auxiliary"` のいずれか720* `query_source`: リクエストを発行したサブシステムのカテゴリ。`"main"`、`"subagent"`、または `"auxiliary"` のいずれか

675* `speed`: リクエストが高速モードを使用した場合は `"fast"`。それ以外の場合は存在しません721* `speed`: リクエストが高速モードを使用した場合は `"fast"`。それ以外の場合は不在

676* `effort`: リクエストに適用された [努力レベル](/docs/ja/model-config#adjust-effort-level)。詳細は [コストカウンター](#cost-counter) を参照。722* `effort`: リクエストに適用された[努力レベル](/docs/ja/model-config#adjust-effort-level)。詳細は[コストカウンター](#cost-counter)を参照。

677* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、および MCP 属性。定義と削除動作については [コストカウンター](#cost-counter) を参照。723* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、MCP 属性。定義と難読化動作については[コストカウンター](#cost-counter)を参照。

678 724

679<h4 id="code-edit-tool-decision-counter">725<h4 id="code-edit-tool-decision-counter">

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

684 730

685**属性**:731**属性**:

686 732

687* すべての [標準属性](#standard-attributes)733* すべての[標準属性](#standard-attributes)

688* `tool_name`: ツール名（`"Edit"`、`"Write"`、`"NotebookEdit"`）734* `tool_name`: ツール名（`"Edit"`、`"Write"`、`"NotebookEdit"`）

689* `decision`: ユーザーの決定（`"accept"`、`"reject"`）735* `decision`: ユーザーの決定（`"accept"`、`"reject"`）

690* `source`: 決定の出所。`"config"`、`"hook"`、`"user_permanent"`、`"user_temporary"`、`"user_abort"`、または `"user_reject"` のいずれか。各値の意味については [ツール決定イベント](#tool-decision-event) を参照。736* `source`: 決定の出所。`"config"`、`"hook"`、`"user_permanent"`、`"user_temporary"`、`"user_abort"`、または `"user_reject"` のいずれか。各値の意味については[ツール決定イベント](#tool-decision-event)を参照。

691* `language`: 編集されたファイルのプログラミング言語。`"TypeScript"`、`"Python"`、`"JavaScript"`、`"Markdown"` など。認識されないファイル拡張子の場合は `"unknown"` を返します。737* `language`: 編集されたファイルのプログラミング言語。`"TypeScript"`、`"Python"`、`"JavaScript"`、`"Markdown"` など。認識されないファイル拡張子の場合は `"unknown"` を返します。

692 738

693<h4 id="active-time-counter">739<h4 id="active-time-counter">

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

695</h4>741</h4>

696 742

697Claude Code の実際の使用時間を追跡し、アイドル時間を除外します。このメトリクスは、入力や応答の読み取りなどのユーザーインタラクション中、およびツール実行や AI 応答生成などの CLI 処理中にインクリメントされます。743Claude Code を積極的に使用している実際の時間を追跡します。アイドル時間は除外されます。このメトリクスは、入力やレスポンス読み取りなどのユーザーインタラクション中、およびツール実行や AI レスポンス生成などの CLI 処理中にインクリメントされます。

698 744

699**属性**:745**属性**:

700 746

701* すべての [標準属性](#standard-attributes)747* すべての[標準属性](#standard-attributes)

702* `type`: キーボードインタラクションの場合は `"user"`、ツール実行と AI 応答の場合は `"cli"`748* `type`: キーボードインタラクションの場合は `"user"`、ツール実行と AI レスポンスの場合は `"cli"`

703 749

704<h3 id="events">750<h3 id="events">

705 イベント751 イベント

711 イベント相関属性757 イベント相関属性

712</h4>758</h4>

713 759

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

715 761

716| 属性 | 説明 |762| 属性 | 説明 |

717| - | - |763| - | - |

720| `message.uuid` | セッショントランスクリプト（`~/.claude/projects/*/*.jsonl` ファイル）に保持されるメッセージの UUID。`assistant_response`、`api_response_body` に存在し、コマンドディスパッチを除く `user_prompt` に存在します。コマンドディスパッチはゼロまたは多くのメッセージを生成できます。`assistant_response` および `api_response_body` では、これは応答の最終トランスクリプトエントリであり、次のターンの `parentUuid` がこれからチェーンされます。Claude Code v2.1.214 以降が必要。または `api_response_body` では v2.1.274 以降 |766| `message.uuid` | セッショントランスクリプト（`~/.claude/projects/*/*.jsonl` ファイル）に保持されるメッセージの UUID。`assistant_response`、`api_response_body`、およびコマンドディスパッチを除く `user_prompt` に存在します。コマンドディスパッチは 0 個以上のメッセージを生成できます。`assistant_response` および `api_response_body` では、これはレスポンスの最終トランスクリプトエントリで、次のターンの `parentUuid` がこれからチェーンされます。Claude Code v2.1.214 以降が必要。または `api_response_body` では v2.1.274 以降 |

721| `client_request_id` | `x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。ファーストパーティ API 接続の `api_request` および `api_error` に存在します。サードパーティプロバイダーバックエンドおよびリクエストが非ストリーミングフォールバック経由で再試行された場合は存在しません。リクエストをその応答とペアリングし、サーバー `request_id` を生成しなかったタイムアウトなどの障害に対して利用可能なままです。`llm_request` トレーススパンの同じ属性と一致します。Claude Code v2.1.214 以降が必要 |767| `request_id` | API リクエストのサーバー割り当て ID。`request-id` レスポンスヘッダーから読み取られます。例：`req_011...`。[Amazon Bedrock](/docs/ja/amazon-bedrock) のようにレスポンスに `request-id` ヘッダーがない場合、値は `x-amzn-requestid` ヘッダーから代わりに取得されます。`api_request`、`api_error`、`api_refusal`、`assistant_response`、`api_response_body` に存在します。レスポンスがいずれかのヘッダーを保持する場合。`llm_request` トレーススパンの同じ属性と一致します。`x-amzn-requestid` ソースには Claude Code v2.1.282 以降が必要 |

768| `client_request_id` | `x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。ファーストパーティ API 接続の `api_request` および `api_error` に存在します。サードパーティプロバイダーバックエンドおよびリクエストが非ストリーミングフォールバック経由で再試行された場合は不在。リクエストをレスポンスとペアリングし、タイムアウトなどのサーバー `request_id` を生成しなかった障害に対して利用可能なままです。`llm_request` トレーススパンの同じ属性と一致します。Claude Code v2.1.214 以降が必要 |

722 769

723単一のプロンプトによってトリガーされたすべてのアクティビティをトレースするには、特定の `prompt.id` 値でイベントをフィルタリングします。これにより、user\_prompt イベント、すべての api\_request イベント、およびそのプロンプト処理中に発生したすべての tool\_result イベントが返されます。770単一のプロンプトによってトリガーされたすべてのアクティビティをトレースするには、特定の `prompt.id` 値でイベントをフィルタリングします。これにより、user\_prompt イベント、任意の api\_request イベント、およびそのプロンプト処理中に発生した任意の tool\_result イベントが返されます。

724 771

725`event.sequence` は Claude Code プロセスが開始されるたびに 0 から始まり、そのプロセスの生涯にわたってカウントアップされます。`/clear` を横切ってカウントを続けます。これは新しい `session.id` を割り当てます。[セッションをフォークせずに再開](/docs/ja/how-claude-code-works#resume-or-fork-sessions) する場合、セッションは `session.id` を保持しますが、それを再開したプロセスから `event.sequence` 値を取得するため、1 つのセッション内で、後のイベントが前のイベントより低い値を持つか、1 つを繰り返す可能性があります。セッションのイベントを順序付けするには、`event.timestamp` でソートし、タイムスタンプを共有するイベントを順序付けするために `event.sequence` を使用します。772`event.sequence` は Claude Code プロセスが開始されるたびに 0 から開始され、そのプロセスの生涯にわたってカウントアップされます。`/clear` を横切ってカウントを続けます。これは新しい `session.id` を割り当てます。[セッションをフォークせずに再開](/docs/ja/how-claude-code-works#resume-or-fork-sessions)する場合、セッションは `session.id` を保持しますが、それを再開したプロセスから `event.sequence` 値を取得するため、1 つのセッション内で、後のイベントは前のイベントより低い値を保持したり、1 つを繰り返したりできます。セッションのイベントを順序付けするには、`event.timestamp` でソートし、タイムスタンプを共有するイベントを順序付けするために `event.sequence` を使用します。

726 773

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

728 775

729* `message.uuid` on `user_prompt`、`assistant_response`、および `api_response_body`776* `user_prompt`、`assistant_response`、`api_response_body` の `message.uuid`

730* `request_id` on the API events、persisted as `requestId` on the transcript's assistant entries777* API イベントの `request_id`。トランスクリプトのアシスタントエントリに `requestId` として保持

731* `tool_use_id` on `tool_result` and `tool_decision` events778* `tool_result` および `tool_decision` イベントの `tool_use_id`

732 779

733<h4 id="user-prompt-event">780<h4 id="user-prompt-event">

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

740 787

741**属性**:788**属性**:

742 789

743* すべての [標準属性](#standard-attributes)790* すべての[標準属性](#standard-attributes)

744* `event.name`: `"user_prompt"`791* `event.name`: `"user_prompt"`

745* `event.timestamp`: ISO 8601 タイムスタンプ792* `event.timestamp`: ISO 8601 タイムスタンプ

746* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明793* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

747* `prompt_length`: プロンプトの長さ794* `prompt_length`: プロンプトの長さ

748* `prompt`: プロンプトコンテンツ。デフォルトではリダクションされます。`OTEL_LOG_USER_PROMPTS=1` を設定して含めます795* `prompt`: プロンプトコンテンツ。デフォルトで難読化されます。`OTEL_LOG_USER_PROMPTS=1` を設定して含めます

749* `message.uuid`: 結果のユーザーメッセージの UUID。保持されたトランスクリプトエントリと一致します。コマンドディスパッチには存在しません。ゼロまたは多くのメッセージを生成できます。Claude Code v2.1.214 以降が必要796* `message.uuid`: 結果のユーザーメッセージの UUID。保持されたトランスクリプトエントリと一致します。コマンドディスパッチでは不在。0 個以上のメッセージを生成できます。Claude Code v2.1.214 以降が必要

750* `command_name`: プロンプトがコマンドを呼び出す場合のコマンド名。`compact` や `debug` などの組み込みおよびバンドルコマンド名はそのまま発行されます。`reset` などのエイリアスは、入力されたとおりに発行されます。正規名ではなく。カスタム、プラグイン、および MCP コマンド名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` または `mcp` に折りたたまれます797* `command_name`: プロンプトがコマンドを呼び出す場合のコマンド名。`compact` や `debug` などの組み込みおよびバンドルコマンド名はそのまま発行されます。`reset` などのエイリアスは正規名ではなく入力されたとおりに発行されます。カスタム、プラグイン、MCP コマンド名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` または `mcp` に折りたたまれます

751* `command_source`: コマンドが存在する場合のコマンドの出所。`builtin`、`custom`、または `mcp`。プラグイン提供コマンドは `custom` として報告されます798* `command_source`: コマンドが存在する場合のコマンドの出所。`builtin`、`custom`、または `mcp`。プラグイン提供コマンドは `custom` として報告されます

752 799

753<h4 id="assistant-response-event">800<h4 id="assistant-response-event">

754 アシスタント応答イベント801 アシスタントレスポンスイベント

755</h4>802</h4>

756 803

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

758 805

759**イベント名**: `claude_code.assistant_response`806**イベント名**: `claude_code.assistant_response`

760 807

761**属性**:808**属性**:

762 809

763* すべての [標準属性](#standard-attributes)810* すべての[標準属性](#standard-attributes)

764* `event.name`: `"assistant_response"`811* `event.name`: `"assistant_response"`

765* `event.timestamp`: ISO 8601 タイムスタンプ812* `event.timestamp`: ISO 8601 タイムスタンプ

766* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明813* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

767* `response_length`: 応答テキストの長さ（文字数）814* `response_length`: レスポンステキストの長さ（文字数）

768* `response`: 応答テキスト。コンテンツ制限（デフォルト 60 KB）で切り詰められます。デフォルトでは `<REDACTED>` にリダクションされます。`OTEL_LOG_ASSISTANT_RESPONSES=1` を設定して含めます。`OTEL_LOG_ASSISTANT_RESPONSES` が設定されていない場合、`OTEL_LOG_USER_PROMPTS` が代わりに制御するため、プロンプトログが有効な場合は応答をリダクションされたままにするために `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定します815* `response`: レスポンステキスト。コンテンツ制限（デフォルト 60 KB）で切り詰められます。デフォルトで `<REDACTED>` に難読化されます。`OTEL_LOG_ASSISTANT_RESPONSES=1` を設定して含めます。`OTEL_LOG_ASSISTANT_RESPONSES` が設定されていない場合、`OTEL_LOG_USER_PROMPTS` が代わりに制御するため、プロンプトログが有効な場合はレスポンスを難読化したままにするために `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定します

769* `model`: モデル識別子（例：「claude-sonnet-5」）816* `model`: モデル識別子（例：「claude-sonnet-5」）

770* `request_id`: 応答の `request-id` ヘッダーからの Anthropic API リクエスト ID。API が返す場合のみ存在817* `request_id`: API リクエスト ID。[イベント相関属性](#event-correlation-attributes)で説明

771* `message.uuid`: 応答の最終トランスクリプトエントリの UUID。API 応答はコンテンツブロックごとに 1 つのトランスクリプトエントリとして保持されます。これは最後のもので、次のターンの `parentUuid` がこれからチェーンされます。Claude Code v2.1.214 以降が必要818* `message.uuid`: レスポンスの最終トランスクリプトエントリの UUID。API レスポンスはコンテンツブロックごとに 1 つのトランスクリプトエントリとして保持されます。これは最後のもので、次のターンの `parentUuid` がこれからチェーンされます。Claude Code v2.1.214 以降が必要

772* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など819* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など

773 820

774<h4 id="tool-result-event">821<h4 id="tool-result-event">

775 ツール結果イベント822 ツール結果イベント

776</h4>823</h4>

777 824

778ツールが実行を完了するとログされます。ツール呼び出しが拒否された場合は発行されません。[ツール決定イベント](#tool-decision-event) で拒否を参照してください。825ツールが実行を完了するとログされます。ツール呼び出しが拒否された場合は発行されません。[ツール決定イベント](#tool-decision-event)で拒否を参照。

779 826

780**イベント名**: `claude_code.tool_result`827**イベント名**: `claude_code.tool_result`

781 828

782**属性**:829**属性**:

783 830

784* すべての [標準属性](#standard-attributes)831* すべての[標準属性](#standard-attributes)

785* `event.name`: `"tool_result"`832* `event.name`: `"tool_result"`

786* `event.timestamp`: ISO 8601 タイムスタンプ833* `event.timestamp`: ISO 8601 タイムスタンプ

787* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明834* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

788* `tool_name`: ツールの名前835* `tool_name`: ツールの名前

789* `tool_use_id`: このツール呼び出しの一意の識別子。フックに渡される `tool_use_id` と一致し、OTel イベントとフック取得データ間の相関を可能にします。836* `tool_use_id`: このツール呼び出しの一意の識別子。フックに渡された `tool_use_id` と一致し、OTel イベントとフック取得データ間の相関を可能にします。

790* `success`: `"true"` または `"false"`837* `success`: `"true"` または `"false"`

791* `duration_ms`: 実行時間（ミリ秒）838* `duration_ms`: ミリ秒単位の実行時間

792* `error_type`: ツールが失敗した場合のエラーカテゴリ文字列。`"Error:ENOENT"` または `"ShellError"` など839* `error_type`: ツールが失敗した場合のエラーカテゴリ文字列。`"Error:ENOENT"` または `"ShellError"` など

793* `error`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: ツールが失敗した場合の完全なエラーメッセージ840* `error`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: ツールが失敗した場合の完全なエラーメッセージ

794* `decision_type`: 常に `"accept"`。このイベントはツール実行後にのみ発行されるため。拒否された呼び出しはツール結果を生成しません841* `decision_type`: 常に `"accept"`。このイベントはツール実行後にのみ発行されるため。拒否された呼び出しはツール結果を生成しません

795* `decision_source`: 権限決定の出所。`"config"`、`"hook"`、`"user_permanent"`、または `"user_temporary"` のいずれか。各値の意味については [ツール決定イベント](#tool-decision-event) を参照。拒否のみのソース `"user_abort"` および `"user_reject"` はこのイベントに表示されません。842* `decision_source`: 権限決定の出所。`"config"`、`"hook"`、`"user_permanent"`、または `"user_temporary"` のいずれか。各値の意味については[ツール決定イベント](#tool-decision-event)を参照。拒否のみのソース `"user_abort"` および `"user_reject"` はこのイベントに表示されません。

796* `tool_input_size_bytes`: JSON シリアル化されたツール入力のサイズ（バイト）843* `tool_input_size_bytes`: JSON シリアル化されたツール入力のサイズ（バイト）

797* `tool_result_size_bytes`: ツール結果のサイズ（バイト）844* `tool_result_size_bytes`: ツール結果のサイズ（バイト）

798* `mcp_server_scope`: MCP サーバースコープ識別子（MCP ツール用）845* `mcp_server_scope`: MCP サーバースコープ識別子（MCP ツール用）

799* `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 以降が必要846* `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 以降が必要

800* `tool_parameters`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: ツール固有のパラメーターを含む JSON 文字列。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、フラグがオフの場合でも `mcp_server_name`/`mcp_tool_name` ペアが含まれます。[ツール決定イベント](#tool-decision-event) と同じホスト作成例外。Claude Code v2.1.214 以降が必要。パラメーターはツールによって異なります。847* `tool_parameters`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: ツール固有のパラメーターを含む JSON 文字列。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、フラグがオフでも `mcp_server_name`/`mcp_tool_name` ペアが含まれます。[ツール決定イベント](#tool-decision-event)と同じホスト作成例外。Claude Code v2.1.214 以降が必要。パラメーターはツールによって異なります。

801 * 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 では省略848 * 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 では省略

802 * デスクトップアプリのワークスペース Bash ツール（`tool_name` も `Bash` として報告）用: `bash_command`、`full_command`、`timeout` のみを含みます849 * デスクトップアプリのワークスペース Bash ツール（`tool_name` も `Bash` として報告）: `bash_command`、`full_command`、`timeout` のみを含みます

803 * MCP ツール用: `mcp_server_name`、`mcp_tool_name` を含みます850 * MCP ツール用: `mcp_server_name`、`mcp_tool_name` を含みます

804 * Skill ツール用: `skill_name` を含みます851 * Skill ツール用: `skill_name` を含みます

805 * Agent ツールまたはレガシー Task ツール用: `subagent_type` を含みます852 * Agent ツールまたはレガシー Task ツール用: `subagent_type` を含みます

806* `tool_input`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: JSON シリアル化されたツール引数。512 文字を超える個別の値は切り詰められ、完全なペイロードは約 4 K 文字に制限されます。MCP ツールを含むすべてのツールに適用されます。853* `tool_input`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: JSON シリアル化されたツール引数。512 文字を超える個別値は切り詰められ、完全なペイロードは約 4 K 文字に制限されます。MCP ツールを含むすべてのツールに適用されます。

807 854

808<h4 id="api-request-event">855<h4 id="api-request-event">

809 API リクエストイベント856 API リクエストイベント

815 862

816**属性**:863**属性**:

817 864

818* すべての [標準属性](#standard-attributes)865* すべての[標準属性](#standard-attributes)

819* `event.name`: `"api_request"`866* `event.name`: `"api_request"`

820* `event.timestamp`: ISO 8601 タイムスタンプ867* `event.timestamp`: ISO 8601 タイムスタンプ

821* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明868* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

822* `model`: 使用されたモデル（例：「claude-sonnet-5」）869* `model`: 使用されたモデル（例：「claude-sonnet-5」）

823* `cost_usd`: 推定コスト（USD）870* `cost_usd`: USD での推定コスト

824* `cost_usd_micros`: 推定コスト（米ドルの百万分の一）。整数として発行871* `cost_usd_micros`: 米ドルの百万分の一での推定コスト。整数として発行

825* `duration_ms`: リクエスト期間（ミリ秒）872* `duration_ms`: ミリ秒単位のリクエスト期間

826* `input_tokens`: 入力トークン数873* `input_tokens`: 入力トークン数

827* `output_tokens`: 出力トークン数874* `output_tokens`: 出力トークン数

828* `cache_read_tokens`: キャッシュから読み取られたトークン数875* `cache_read_tokens`: キャッシュから読み取られたトークン数

829* `cache_creation_tokens`: キャッシュ作成に使用されたトークン数876* `cache_creation_tokens`: キャッシュ作成に使用されたトークン数

830* `request_id`: 応答の `request-id` ヘッダーからの Anthropic API リクエスト ID。`"req_011..."` など。API が返す場合のみ存在。877* `request_id`: API リクエスト ID。`"req_011..."` など。[イベント相関属性](#event-correlation-attributes)で説明。

831* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。存在する場合については [イベント相関属性](#event-correlation-attributes) テーブルを参照。Claude Code v2.1.214 以降が必要878* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。存在する場合については[イベント相関属性](#event-correlation-attributes)テーブルを参照。Claude Code v2.1.214 以降が必要

832* `speed`: 高速モードがアクティブであったかどうかを示す `"fast"` または `"normal"`879* `speed`: 高速モードがアクティブであったかどうかを示す `"fast"` または `"normal"`

833* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など880* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など

834* `effort`: リクエストに適用された [努力レベル](/docs/ja/model-config#adjust-effort-level)。`"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"`。モデルが努力をサポートしていない場合は存在しません。881* `effort`: リクエストに適用された[努力レベル](/docs/ja/model-config#adjust-effort-level)。`"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"`。Claude Code が努力レベルを送信しない場合（例：努力をサポートしないモデル）は不在。

835* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、および MCP 属性。定義と削除動作については [コストカウンター](#cost-counter) を参照。882* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、MCP 属性。定義と難読化動作については[コストカウンター](#cost-counter)を参照。

836 883

837<h4 id="api-error-event">884<h4 id="api-error-event">

838 API エラーイベント885 API エラーイベント

844 891

845**属性**:892**属性**:

846 893

847* すべての [標準属性](#standard-attributes)894* すべての[標準属性](#standard-attributes)

848* `event.name`: `"api_error"`895* `event.name`: `"api_error"`

849* `event.timestamp`: ISO 8601 タイムスタンプ896* `event.timestamp`: ISO 8601 タイムスタンプ

850* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明897* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

851* `model`: 使用されたモデル（例：「claude-sonnet-5」）898* `model`: 使用されたモデル（例：「claude-sonnet-5」）

852* `error`: エラーメッセージ899* `error`: エラーメッセージ

853* `status_code`: HTTP ステータスコード（数値）。接続障害などの非 HTTP エラーの場合は存在しません。900* `status_code`: HTTP ステータスコード（数値）。接続障害などの非 HTTP エラーの場合は不在。

854* `duration_ms`: リクエスト期間（ミリ秒）901* `duration_ms`: ミリ秒単位のリクエスト期間

855* `attempt`: 実行された試行の総数。初期リクエストを含む（`1` は再試行が発生しなかったことを意味します）902* `attempt`: 実行された試行の総数。初期リクエストを含む（`1` は再試行が発生しなかったことを意味します）

856* `request_id`: 応答の `request-id` ヘッダーからの Anthropic API リクエスト ID。`"req_011..."` など。API が返す場合のみ存在。903* `request_id`: API リクエスト ID。`"req_011..."` など。[イベント相関属性](#event-correlation-attributes)で説明。

857* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。タイムアウトや接続エラーなどの障害がサーバー `request_id` を生成しなかった場合でも利用可能です。存在する場合については [イベント相関属性](#event-correlation-attributes) テーブルを参照。Claude Code v2.1.214 以降が必要904* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。タイムアウトや接続エラーなどの障害がサーバー `request_id` を生成しなかった場合でも利用可能。存在する場合については[イベント相関属性](#event-correlation-attributes)テーブルを参照。Claude Code v2.1.214 以降が必要

858* `speed`: 高速モードがアクティブであったかどうかを示す `"fast"` または `"normal"`905* `speed`: 高速モードがアクティブであったかどうかを示す `"fast"` または `"normal"`

859* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など906* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など

860* `effort`: リクエストに適用された [努力レベル](/docs/ja/model-config#adjust-effort-level)。モデルが努力をサポートしていない場合は存在しません。907* `effort`: リクエストに適用された[努力レベル](/docs/ja/model-config#adjust-effort-level)。Claude Code が努力レベルを送信しない場合（例：努力をサポートしないモデル）は不在。

861* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、および MCP 属性。定義と削除動作については [コストカウンター](#cost-counter) を参照。908* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、MCP 属性。定義と難読化動作については[コストカウンター](#cost-counter)を参照。

862 909

863<h4 id="api-refusal-event">910<h4 id="api-refusal-event">

864 API 拒否イベント911 API 拒否イベント

865</h4>912</h4>

866 913

867API リクエストが `stop_reason: "refusal"` を返すとログされます。拒否は HTTP エラーではなく成功した応答ストリームで到着するため、`api_error` イベントは発火しません。このイベントにより、拒否頻度を追跡し、拒否を `api_request` および `api_error` と同じ属性でグループ化できます。914API リクエストが `stop_reason: "refusal"` を返すとログされます。拒否は HTTP エラーではなく成功したレスポンスストリームで到着するため、`api_error` イベントは発火しません。このイベントにより、拒否頻度を追跡し、拒否を `api_request` および `api_error` と同じ属性でグループ化できます。

868 915

869**イベント名**: `claude_code.api_refusal`916**イベント名**: `claude_code.api_refusal`

870 917

871**属性**:918**属性**:

872 919

873* すべての [標準属性](#standard-attributes)920* すべての[標準属性](#standard-attributes)

874* `event.name`: `"api_refusal"`921* `event.name`: `"api_refusal"`

875* `event.timestamp`: ISO 8601 タイムスタンプ922* `event.timestamp`: ISO 8601 タイムスタンプ

876* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明923* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

877* `model`: リクエストからのモデル識別子924* `model`: リクエストのモデル識別子

878* `request_id`: 応答の `request-id` ヘッダーからの Anthropic API リクエスト ID。`"req_011..."` など。API が返す場合のみ存在。925* `request_id`: API リクエスト ID。`"req_011..."` など。[イベント相関属性](#event-correlation-attributes)で説明。

879* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など。定義については [`api_request`](#api-request-event) を参照。926* `query_source`: リクエストを発行したサブシステム。`"repl_main_thread"`、`"compact"`、またはサブエージェント名など。定義については [`api_request`](#api-request-event) を参照。

880* `speed`: [高速モード](/docs/ja/fast-mode) がアクティブな場合は `"fast"`、またはそれ以外の場合は `"normal"`927* `speed`: [高速モード](/docs/ja/fast-mode)がアクティブな場合は `"fast"`、またはそれ以外の場合は `"normal"`

881* `attempt`: 再試行試行番号。最初の試行は `1`。928* `attempt`: 再試行試行番号。最初の試行は `1`。

882* `effort`: リクエストに適用された [努力レベル](/docs/ja/model-config#adjust-effort-level)。モデルが努力をサポートしていない場合は存在しません。929* `effort`: リクエストに適用された[努力レベル](/docs/ja/model-config#adjust-effort-level)。Claude Code が努力レベルを送信しない場合（例：努力をサポートしないモデル）は不在。

883* `server_fallback_hop`: API のサーバー側モデルフォールバックがこの拒否を別のモデルで既に再試行した場合は `true`。ユーザーはこの特定の拒否を見ませんでした。リクエストが拒否で終了した場合は `false`。単一のターンは、フォールバックモデルも拒否する場合、`true` ホップイベントと後の `false` 最終イベントの両方を発行できます。930* `server_fallback_hop`: API のサーバー側モデルフォールバックがこの拒否を別のモデルで既に再試行した場合は `true`。ユーザーはこの特定の拒否を見ませんでした。リクエストが拒否で終了した場合は `false`。フォールバックモデルも拒否する場合、1 つのターンは `true` ホップイベントと後の `false` 最終イベントの両方を発行できます。

884* `has_category`: API 応答が `stop_details.category` の `"cyber"`、`"bio"`、`"frontier_llm"`、または `"reasoning_extraction"` を持つ場合は `true`。応答がカテゴリを持たないか、そのセット外の値を持つ場合は `false`。`server_fallback_hop` が `true` の場合は存在しません。ホップブロックは `stop_details` を持たないため。931* `has_category`: API レスポンスが `stop_details.category` の `"cyber"`、`"bio"`、`"frontier_llm"`、または `"reasoning_extraction"` を保持した場合は `true`。レスポンスがカテゴリを保持しなかったか、そのセット外の値を保持した場合は `false`。`server_fallback_hop` が `true` の場合は不在。ホップブロックは `stop_details` を保持しないため。

885* `has_explanation`: API 応答が `stop_details.explanation` を持つ場合は `true`。それ以外の場合は `false`。`server_fallback_hop` が `true` の場合は存在しません。932* `has_explanation`: API レスポンスが `stop_details.explanation` を保持した場合は `true`。それ以外の場合は `false`。`server_fallback_hop` が `true` の場合は不在。

886* `category`: API 応答からの `stop_details.category` 値。`"cyber"`、`"bio"`、`"frontier_llm"`、または `"reasoning_extraction"` のいずれか。`OTEL_LOG_TOOL_DETAILS=1` が設定され、`has_category` が `true` の場合のみ存在。933* `category`: API レスポンスの `stop_details.category` 値。`"cyber"`、`"bio"`、`"frontier_llm"`、または `"reasoning_extraction"` のいずれか。`OTEL_LOG_TOOL_DETAILS=1` が設定され、`has_category` が `true` の場合のみ存在。

887* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、および MCP 属性。定義と削除動作については [コストカウンター](#cost-counter) を参照。934* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、MCP 属性。定義と難読化動作については[コストカウンター](#cost-counter)を参照。

888 935

889<h4 id="api-request-body-event">936<h4 id="api-request-body-event">

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

891</h4>938</h4>

892 939

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

894 941

895**イベント名**: `claude_code.api_request_body`942**イベント名**: `claude_code.api_request_body`

896 943

897**属性**:944**属性**:

898 945

899* すべての [標準属性](#standard-attributes)946* すべての[標準属性](#standard-attributes)

900* `event.name`: `"api_request_body"`947* `event.name`: `"api_request_body"`

901* `event.timestamp`: ISO 8601 タイムスタンプ948* `event.timestamp`: ISO 8601 タイムスタンプ

902* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明949* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

903* `body`: JSON シリアル化された Messages API リクエストパラメーター。システムプロンプト、メッセージ、ツールなど。コンテンツ制限（デフォルト 60 KB）で切り詰められます。前のアシスタントターンの拡張思考コンテンツはリダクションされます。インラインモード（`OTEL_LOG_RAW_API_BODIES=1`）でのみ発行。950* `body`: JSON シリアル化された Messages API リクエストパラメーター。システムプロンプト、メッセージ、ツールなど。コンテンツ制限（デフォルト 60 KB）で切り詰められます。前のアシスタントターンの拡張思考コンテンツは難読化されます。インラインモード（`OTEL_LOG_RAW_API_BODIES=1`）でのみ発行。

904* `body_ref`: 切り詰められていないボディを含む `<dir>/<uuid>.request.json` ファイルへの絶対パス。ファイルモード（`OTEL_LOG_RAW_API_BODIES=file:<dir>`）でのみ発行。951* `body_ref`: 切り詰められていないボディを含む `<dir>/<uuid>.request.json` ファイルへの絶対パス。ファイルモード（`OTEL_LOG_RAW_API_BODIES=file:<dir>`）でのみ発行。

905* `body_length`: 切り詰められていないボディの長さ。`OTEL_LOG_RAW_API_BODIES=file:<dir>` の場合は UTF-8 バイト。`=1` の場合は UTF-16 コードユニット952* `body_length`: 切り詰められていないボディの長さ。`OTEL_LOG_RAW_API_BODIES=file:<dir>` の場合は UTF-8 バイト。`=1` の場合は UTF-16 コードユニット

906* `body_truncated`: インラインの切り詰めが発生した場合は `"true"`。ファイルモードおよび切り詰めが発生しなかった場合は存在しません。953* `body_truncated`: インライン切り詰めが発生した場合は `"true"`。ファイルモードおよび切り詰めが発生しなかった場合は不在。

907* `model`: リクエストパラメーターからのモデル識別子954* `model`: リクエストパラメーターのモデル識別子

908* `query_source`: リクエストを発行したサブシステム（例：`"compact"`）955* `query_source`: リクエストを発行したサブシステム（例：`"compact"`）

909* `request_body_id`: この試行のリクエストボディを識別する UUID。成功した試行の [`api_response_body` イベント](#api-response-body-event) は同じ値を持つため、応答をそれを生成した正確なリクエストとペアリングできます。Claude Code v2.1.274 以降が必要956* `request_body_id`: この試行のリクエストボディを識別する UUID。成功した試行の [`api_response_body` イベント](#api-response-body-event) は同じ値を保持するため、レスポンスをそれを生成した正確なリクエストとペアリングできます。Claude Code v2.1.274 以降が必要

910 957

911<h4 id="api-response-body-event">958<h4 id="api-response-body-event">

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

914 961

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

916 963

917ファイルモード（`OTEL_LOG_RAW_API_BODIES=file:<dir>`）では、Claude Code は成功した応答ごとに 1 つの JSON 行を `<dir>/index.jsonl` に追加します。フィールド `timestamp`、`session_id`、`query_source`、`model`、`request_id`、`message_id`、`message_uuid`、`request_file`、`response_file` を持ちます。これを読んで、テレメトリバックエンドをクエリせずに、特定のトランスクリプトメッセージの背後にあるリクエストおよびレスポンスファイルを見つけます。インデックスファイルは Claude Code v2.1.274 以降が必要です。964ファイルモード（`OTEL_LOG_RAW_API_BODIES=file:<dir>`）では、Claude Code は成功したレスポンスごとに 1 つの JSON 行を `<dir>/index.jsonl` に追加します。フィールド `timestamp`、`session_id`、`query_source`、`model`、`request_id`、`message_id`、`message_uuid`、`request_file`、`response_file` を含みます。テレメトリバックエンドをクエリせずに、特定のトランスクリプトメッセージの背後にあるリクエストおよびレスポンスファイルを見つけるために読み取ります。インデックスファイルには Claude Code v2.1.274 以降が必要。

918 965

919**イベント名**: `claude_code.api_response_body`966**イベント名**: `claude_code.api_response_body`

920 967

921**属性**:968**属性**:

922 969

923* すべての [標準属性](#standard-attributes)970* すべての[標準属性](#standard-attributes)

924* `event.name`: `"api_response_body"`971* `event.name`: `"api_response_body"`

925* `event.timestamp`: ISO 8601 タイムスタンプ972* `event.timestamp`: ISO 8601 タイムスタンプ

926* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明973* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

927* `body`: JSON シリアル化された Messages API レスポンス。ID、コンテンツブロック、使用状況、停止理由を含みます。コンテンツ制限（デフォルト 60 KB）で切り詰められます。拡張思考コンテンツはリダクションされます。インラインモード（`OTEL_LOG_RAW_API_BODIES=1`）でのみ発行。974* `body`: JSON シリアル化された Messages API レスポンス。ID、コンテンツブロック、使用状況、停止理由を含みます。コンテンツ制限（デフォルト 60 KB）で切り詰められます。拡張思考コンテンツは難読化されます。インラインモード（`OTEL_LOG_RAW_API_BODIES=1`）でのみ発行。

928* `body_ref`: 切り詰められていないボディを含む `<dir>/<request_id>.response.json` ファイルへの絶対パス。ファイルモード（`OTEL_LOG_RAW_API_BODIES=file:<dir>`）でのみ発行。975* `body_ref`: 切り詰められていないボディを含む `<dir>/<request_id>.response.json` ファイルへの絶対パス。ファイルモード（`OTEL_LOG_RAW_API_BODIES=file:<dir>`）でのみ発行。

929* `body_length`: 切り詰められていないボディの長さ。`OTEL_LOG_RAW_API_BODIES=file:<dir>` の場合は UTF-8 バイト。`=1` の場合は UTF-16 コードユニット976* `body_length`: 切り詰められていないボディの長さ。`OTEL_LOG_RAW_API_BODIES=file:<dir>` の場合は UTF-8 バイト。`=1` の場合は UTF-16 コードユニット

930* `body_truncated`: インラインの切り詰めが発生した場合は `"true"`。ファイルモードおよび切り詰めが発生しなかった場合は存在しません。977* `body_truncated`: インライン切り詰めが発生した場合は `"true"`。ファイルモードおよび切り詰めが発生しなかった場合は不在。

931* `model`: モデル識別子978* `model`: モデル識別子

932* `query_source`: リクエストを発行したサブシステム979* `query_source`: リクエストを発行したサブシステム

933* `request_id`: 応答の `request-id` ヘッダーからの Anthropic API リクエスト ID。`"req_011..."` など。API が返す場合のみ存在。980* `request_id`: API リクエスト ID。`"req_011..."` など。[イベント相関属性](#event-correlation-attributes)で説明。

934* `request_body_id`: この応答が答える [`api_request_body` イベント](#api-request-body-event) の `request_body_id`。Claude Code v2.1.274 以降が必要981* `request_body_id`: このレスポンスが応答する [`api_request_body` イベント](#api-request-body-event) の `request_body_id`。Claude Code v2.1.274 以降が必要

935* `message.id`: API がレスポンスに割り当てたメッセージ ID。レスポンスボディの `id` フィールド。Claude Code v2.1.274 以降が必要982* `message.id`: API がレスポンスに割り当てたメッセージ ID。レスポンスボディの `id` フィールド。Claude Code v2.1.274 以降が必要

936* `message.uuid`: レスポンスの最終トランスクリプトエントリの UUID。`request_body_id` と一緒に、トランスクリプトメッセージをそれの背後にあるリクエストおよびレスポンスボディにリンクします。Claude Code v2.1.274 以降が必要983* `message.uuid`: レスポンスの最終トランスクリプトエントリの UUID。`request_body_id` と一緒に、トランスクリプトメッセージをそれの背後にあるリクエストおよびレスポンスボディにリンクします。Claude Code v2.1.274 以降が必要

937 984

945 992

946**属性**:993**属性**:

947 994

948* すべての [標準属性](#standard-attributes)995* すべての[標準属性](#standard-attributes)

949* `event.name`: `"tool_decision"`996* `event.name`: `"tool_decision"`

950* `event.timestamp`: ISO 8601 タイムスタンプ997* `event.timestamp`: ISO 8601 タイムスタンプ

951* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明998* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

952* `tool_name`: ツールの名前（例：「Read」、「Edit」、「Write」、「NotebookEdit」）999* `tool_name`: ツールの名前（例：「Read」、「Edit」、「Write」、「NotebookEdit」）

953* `tool_use_id`: このツール呼び出しの一意の識別子。フックに渡される `tool_use_id` と一致し、OTel イベントとフック取得データ間の相関を可能にします。1000* `tool_use_id`: このツール呼び出しの一意の識別子。フックに渡された `tool_use_id` と一致し、OTel イベントとフック取得データ間の相関を可能にします。

954* `decision`: `"accept"` または `"reject"`1001* `decision`: `"accept"` または `"reject"`

955* `tool_source`: 常に存在します。ツールの出所。CLI 作成値の閉じたセット。Claude Code v2.1.214 以降が必要1002* `tool_source`: 常に存在します。ツールの出所。CLI 作成値の閉じたセット。Claude Code v2.1.214 以降が必要

956 * `"builtin"`: CLI 自体のツール1003 * `"builtin"`: CLI 自体のツール

957 * `"mcp"`: 一般的に MCP サーバー1004 * `"mcp"`: 一般的に MCP サーバー

958 * `"sdk_host_builtin_mcp"`: Claude Desktop 自体に組み込まれたプロセス内サーバー。Claude Desktop が所有するセッション。Claude Desktop が独自のエントリポイント `claude-desktop`、`claude-desktop-3p`、または `local-agent` から開始したセッション。そのセッションがネストされた子ではない場合。ネストされたセッション（Claude Code 自体が生成するセッションを含む）は、これらのサーバーを `"mcp"` として報告します1005 * `"sdk_host_builtin_mcp"`: Claude Desktop 自体に組み込まれたインプロセスサーバー。Claude Desktop が所有するセッション。Claude Desktop は独自のエントリポイント `claude-desktop`、`claude-desktop-3p`、または `local-agent` から開始したセッションを所有します。ネストされたセッション（Claude Code 自体が生成するセッションを含む）は、これらのサーバーを `"mcp"` として報告します

959* `source`: 決定の出所:1006* `source`: 決定の出所。

960 * `"config"`: プロンプトなしで自動的に決定。プロジェクト設定、ユーザーの個人設定の許可または拒否ルール、エンタープライズ管理ポリシー、`--allowedTools` または `--disallowedTools` フラグ、アクティブな権限モード、同じインタラクティブ CLI セッション内の前のプロンプトからのセッションスコープ付与、またはツールが本質的に安全であるため。イベントはこれらのソースのどれが一致したかを示しません。Claude Code は、権限プロンプトリクエスト自体が失敗した場合も `"config"` を報告します。例えば、Agent SDK の [`canUseTool`](/docs/ja/agent-sdk/typescript#canusetool) コールバックまたは [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) ツールが無効な結果を返す場合、またはリクエストが保留中に入力ストリームが閉じる場合。v2.1.216 より前では、Claude Code はこれらの障害を `"user_reject"` として報告していました。1007 * `"config"`: プロンプトなしで自動的に決定。プロジェクト設定、ユーザーの個人設定の許可または拒否ルール、エンタープライズ管理ポリシー、`--allowedTools` または `--disallowedTools` フラグ、アクティブな権限モード、同じインタラクティブ CLI セッション内の前のプロンプトからのセッションスコープ付与、またはツールが本質的に安全であるため。イベントはこれらのソースのどれが一致したかを示しません。Claude Code は、権限プロンプトリクエスト自体が失敗した場合（例：Agent SDK の [`canUseTool`](/docs/ja/agent-sdk/typescript#canusetool) コールバックまたは [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) ツールが無効な結果を返す場合、または入力ストリームがリクエスト保留中に閉じる場合）も `"config"` を報告します。v2.1.216 より前では、Claude Code はこれらの障害を `"user_reject"` として報告していました。

961 * `"hook"`: `PreToolUse` または `PermissionRequest` フックが決定を返しました。1008 * `"hook"`: `PreToolUse` または `PermissionRequest` フックが決定を返しました。

962 * `"user_permanent"`: ユーザーが権限プロンプトで「はい、今後このツールについて聞かないでください」を選択した場合に発行されます。これにより、許可ルールが個人設定に保存されます。インタラクティブ CLI では、その選択自体に対してのみ発行されます。後の呼び出しが保存されたルールと一致する場合は、代わりに `"config"` を発行します。Agent SDK または非インタラクティブ `-p` セッションでは、初期選択と後のルール一致の両方が `"user_permanent"` を発行します。受け入れとして扱われます。1009 * `"user_permanent"`: ユーザーが権限プロンプトで「はい、今後このツールについて聞かないでください」を選択した場合に発行されます。これにより、許可ルールが個人設定に保存されます。インタラクティブ CLI では、その選択自体に対してのみ発行されます。後の呼び出しが保存されたルールと一致する場合は `"config"` を発行します。Agent SDK または非インタラクティブ `-p` セッションでは、初期選択と後のルール一致の両方が `"user_permanent"` を発行します。受け入れとして扱われます。

963 * `"user_temporary"`: ユーザーが権限プロンプトで「はい」を選択した場合、またはファイル編集または読み取りプロンプトでセッションの残りの間アクセスを許可するオプションを選択した場合に発行されます。インタラクティブ CLI では、その選択自体に対してのみ発行されます。後の呼び出しがそのセッションスコープ付与によって許可される場合は、代わりに `"config"` を発行します。Agent SDK または非インタラクティブ `-p` セッションでは、選択と後の一致の両方が `"user_temporary"` を発行します。受け入れとして扱われます。1010 * `"user_temporary"`: ユーザーが権限プロンプトで「はい」を選択した場合、またはファイル編集または読み取りプロンプトでセッションの残りの間アクセスを許可するオプションを選択した場合に発行されます。インタラクティブ CLI では、その選択自体に対してのみ発行されます。後の呼び出しがそのセッションスコープ付与と一致する場合は `"config"` を発行します。Agent SDK または非インタラクティブ `-p` セッションでは、選択と後のマッチの両方が `"user_temporary"` を発行します。受け入れとして扱われます。

964 * `"user_abort"`: ユーザーが権限プロンプトを回答なしで却下した場合に発行されます。Agent SDK および非インタラクティブ `-p` セッションでは、`canUseTool` または `--permission-prompt-tool` 権限リクエストが保留中にターンを中断することを含みます。v2.1.216 より前では、Claude Code はその中断を `"user_reject"` として報告していました。拒否として扱われます。1011 * `"user_abort"`: ユーザーが権限プロンプトを回答なしで却下した場合に発行されます。Agent SDK および非インタラクティブ `-p` セッションでは、`canUseTool` または `--permission-prompt-tool` 権限リクエスト保留中にターンを中断することを含みます。v2.1.216 より前では、Claude Code はその中断を `"user_reject"` として報告していました。拒否として扱われます。

965 * `"user_reject"`: ユーザーがプロンプトで「いいえ」を選択した場合に発行されます。インタラクティブ CLI では、その選択自体に対してのみ発行されます。ユーザーの個人設定の拒否ルールと一致する呼び出しは、代わりに `"config"` を発行します。Agent SDK または非インタラクティブ `-p` セッションでは、個人設定の拒否ルールと一致する呼び出しは `"user_reject"` を発行します。拒否として扱われます。1012 * `"user_reject"`: ユーザーがプロンプトで「いいえ」を選択した場合に発行されます。インタラクティブ CLI では、その選択自体に対してのみ発行されます。ユーザーの個人設定の拒否ルールと一致する呼び出しは `"config"` を発行します。Agent SDK または非インタラクティブ `-p` セッションでは、個人設定の拒否ルールと一致する呼び出しは `"user_reject"` を発行します。拒否として扱われます。

966* `tool_parameters`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: ツール固有のパラメーターを含む JSON 文字列。[ツール結果イベント](#tool-result-event) と同じ形状。`updatedInput` を介した権限決定がツール入力を書き直す場合、受け入れられた呼び出しの値は異なる可能性があります。`decision` が `"reject"` の場合、どのコマンドが拒否されたかを確認するには、この属性を使用します。1013* `tool_parameters`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: ツール固有のパラメーターを含む JSON 文字列。[ツール結果イベント](#tool-result-event) と同じ形状。`git_commit_id` などの実行後フィールドを除きます。受け入れられた呼び出しの場合、権限決定が `updatedInput` を通じてツール入力を書き直す場合、値は `tool_result` と異なる可能性があります。`decision` が `"reject"` の場合、どのコマンドが拒否されたかを確認するにはこの属性を使用します。

967 * `"sdk_host_builtin_mcp"` ツール用: `OTEL_LOG_TOOL_DETAILS` がオフの場合でも、ホストアプリケーションがこれらの名前を定義するため、`mcp_server_name` と `mcp_tool_name` が含まれます。これらなしでは、これらの組み込みサーバーのいずれかへの拒否された呼び出しはデフォルトストリームで属性付けできません。ユーザー設定 MCP サーバーの場合、イベントの `tool_name` は常にリテラル `"mcp_tool"`。サーバーとツール名は `tool_parameters` にのみ表示されます。フラグがオンの場合。引数コンテンツはどこでもフラグが必要です。Claude Code v2.1.214 以降が必要1014 * `"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 以降が必要

968 * Bash ツール用: `bash_command`、`full_command`、`timeout`、`description`、`dangerouslyDisableSandbox` を含みます。デスクトップアプリのワークスペース bash ツール（`tool_name` も `Bash` として報告）は、`bash_command`、`full_command`、`timeout` のみを含みます1015 * Bash ツール用: `bash_command`、`full_command`、`timeout`、`description`、`dangerouslyDisableSandbox` を含みます。デスクトップアプリのワークスペース bash ツールも `tool_name` を `Bash` として報告しますが、`bash_command`、`full_command`、`timeout` のみを含みます

969 * MCP ツール用: `mcp_server_name`、`mcp_tool_name` を含みます1016 * MCP ツール用: `mcp_server_name`、`mcp_tool_name` を含みます

970 * Skill ツール用: `skill_name` を含みます1017 * Skill ツール用: `skill_name` を含みます

971 * Agent ツールまたはレガシー Task ツール用: `subagent_type` を含みます1018 * Agent ツールまたはレガシー Task ツール用: `subagent_type` を含みます

974 権限モード変更イベント1021 権限モード変更イベント

975</h4>1022</h4>

976 1023

977権限モードが変更されるとログされます。例えば、`Shift+Tab` サイクリング、プランモード終了、または自動モードゲートチェックから。1024権限モードが変更されるとログされます。例：`Shift+Tab` サイクリング、プランモード終了、自動モードゲートチェック。

978 1025

979**イベント名**: `claude_code.permission_mode_changed`1026**イベント名**: `claude_code.permission_mode_changed`

980 1027

981**属性**:1028**属性**:

982 1029

983* すべての [標準属性](#standard-attributes)1030* すべての[標準属性](#standard-attributes)

984* `event.name`: `"permission_mode_changed"`1031* `event.name`: `"permission_mode_changed"`

985* `event.timestamp`: ISO 8601 タイムスタンプ1032* `event.timestamp`: ISO 8601 タイムスタンプ

986* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1033* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

987* `from_mode`: 前の権限モード。例：`"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、または `"bypassPermissions"`1034* `from_mode`: 前の権限モード。例：`"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"bypassPermissions"`

988* `to_mode`: 新しい権限モード1035* `to_mode`: 新しい権限モード

989* `trigger`: 変更の原因。`"shift_tab"`、`"exit_plan_mode"`、`"auto_gate_denied"`、または `"auto_opt_in"` のいずれか。SDK またはブリッジから発生する遷移の場合は存在しません1036* `trigger`: 変更の原因。`"shift_tab"`、`"exit_plan_mode"`、`"auto_gate_denied"`、または `"auto_opt_in"` のいずれか。SDK またはブリッジから遷移が発生する場合は不在。

990 1037

991<h4 id="auth-event">1038<h4 id="auth-event">

992 認証イベント1039 認証イベント

998 1045

999**属性**:1046**属性**:

1000 1047

1001* すべての [標準属性](#standard-attributes)1048* すべての[標準属性](#standard-attributes)

1002* `event.name`: `"auth"`1049* `event.name`: `"auth"`

1003* `event.timestamp`: ISO 8601 タイムスタンプ1050* `event.timestamp`: ISO 8601 タイムスタンプ

1004* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1051* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1005* `action`: `"login"` または `"logout"`1052* `action`: `"login"` または `"logout"`

1006* `success`: `"true"` または `"false"`1053* `success`: `"true"` または `"false"`

1007* `auth_method`: 認証方法。`"oauth"` など1054* `auth_method`: 認証方法。`"oauth"` など

1008* `error_category`: アクションが失敗した場合のカテゴリエラー種別。生のエラーメッセージは決して含まれません1055* `error_category`: アクションが失敗した場合のカテゴリエラー種別。生のエラーメッセージは含まれません

1009* `status_code`: アクションが HTTP エラーで失敗した場合の HTTP ステータスコード（文字列）1056* `status_code`: アクションが HTTP エラーで失敗した場合の HTTP ステータスコード（文字列）

1010 1057

1011<h4 id="mcp-server-connection-event">1058<h4 id="mcp-server-connection-event">

1018 1065

1019**属性**:1066**属性**:

1020 1067

1021* すべての [標準属性](#standard-attributes)1068* すべての[標準属性](#standard-attributes)

1022* `event.name`: `"mcp_server_connection"`1069* `event.name`: `"mcp_server_connection"`

1023* `event.timestamp`: ISO 8601 タイムスタンプ1070* `event.timestamp`: ISO 8601 タイムスタンプ

1024* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1071* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1025* `status`: `"connected"`、`"failed"`、または `"disconnected"`1072* `status`: `"connected"`、`"failed"`、または `"disconnected"`

1026* `transport_type`: サーバートランスポート。`"stdio"`、`"sse"`、`"http"` など1073* `transport_type`: サーバートランスポート。`"stdio"`、`"sse"`、`"http"` など

1027* `server_scope`: サーバーが設定されているスコープ。`"user"`、`"project"`、`"local"` など1074* `server_scope`: サーバーが設定されているスコープ。`"user"`、`"project"`、`"local"` など

1028* `duration_ms`: 接続試行期間（ミリ秒）1075* `duration_ms`: ミリ秒単位の接続試行期間

1029* `error_code`: 接続が失敗した場合のエラーコード1076* `error_code`: 接続が失敗した場合のエラーコード

1030* `is_plugin`: サーバーがプラグインによって提供される場合は `true`。それ以外の場合は `false`1077* `is_plugin`: サーバーがプラグインによって提供される場合は `true`。それ以外の場合は `false`

1031* `plugin_id_hash`（`is_plugin` が `true` の場合）: プラグイン名とマーケットプレイスの安定ハッシュ。名前を公開せずにプラグインでイベントをグループ化します。Claude Code は [プラグイン読み込みイベント](#plugin-loaded-event) で説明されているように計算します1078* `plugin_id_hash`（`is_plugin` が `true` の場合）: プラグイン名とマーケットプレイスの安定ハッシュ。名前を公開せずにプラグインでイベントをグループ化するため。Claude Code は[プラグインロードイベント](#plugin-loaded-event)で説明されているように計算します

1032* `plugin.name`（`is_plugin` が `true` の場合）: サーバーを提供するプラグインの名前。サードパーティプラグインの場合、この値は `OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り、リテラル文字列 `"third-party"`。公式 Anthropic ソースのプラグインは常に名前で識別されます。`plugin_id_hash` と `plugin.name` 属性は独自の監視バックエンドにフローし、Anthropic に送信されません1079* `plugin.name`（`is_plugin` が `true` の場合）: サーバーを提供するプラグインの名前。サードパーティプラグインの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り、リテラル文字列 `"third-party"`。これはサードパーティプラグイン名がデフォルトでログに表示されるのを防ぎます。公式 Anthropic ソースのプラグインは常に名前で識別されます。`plugin_id_hash` および `plugin.name` 属性は独自の監視バックエンドにフローし、Anthropic に送信されません

1033* `server_name`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: 設定されたサーバー名1080* `server_name`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: 設定されたサーバー名

1034* `error`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: 接続が失敗した場合の完全なエラーメッセージ1081* `error`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: 接続が失敗した場合の完全なエラーメッセージ

1035 1082

1037 内部エラーイベント1084 内部エラーイベント

1038</h4>1085</h4>

1039 1086

1040Claude Code が予期しない内部エラーをキャッチするとログされます。エラークラス名と errno スタイルコードのみが記録されます。エラーメッセージとスタックトレースは決して含まれません。このイベントは Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry に対して実行する場合、または `DISABLE_ERROR_REPORTING` が設定されている場合は発行されません。1087Claude Code が予期しない内部エラーをキャッチするとログされます。エラークラス名と errno スタイルコードのみが記録されます。エラーメッセージとスタックトレースは含まれません。このイベントは Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry に対して実行する場合、または `DISABLE_ERROR_REPORTING` が設定されている場合は発行されません。

1041 1088

1042**イベント名**: `claude_code.internal_error`1089**イベント名**: `claude_code.internal_error`

1043 1090

1044**属性**:1091**属性**:

1045 1092

1046* すべての [標準属性](#standard-attributes)1093* すべての[標準属性](#standard-attributes)

1047* `event.name`: `"internal_error"`1094* `event.name`: `"internal_error"`

1048* `event.timestamp`: ISO 8601 タイムスタンプ1095* `event.timestamp`: ISO 8601 タイムスタンプ

1049* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1096* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1050* `error_name`: エラークラス名。`"TypeError"` または `"SyntaxError"` など1097* `error_name`: エラークラス名。`"TypeError"` または `"SyntaxError"` など

1051* `error_code`: エラーに存在する場合の Node.js errno コード。`"ENOENT"` など1098* `error_code`: エラーに存在する場合、Node.js errno コード。`"ENOENT"` など

1052 1099

1053<h4 id="plugin-installed-event">1100<h4 id="plugin-installed-event">

1054 プラグインインストール済みイベント1101 プラグインインストールイベント

1055</h4>1102</h4>

1056 1103

1057プラグインがインストール完了するとログされます。`claude plugin install` CLI コマンドとインタラクティブ `/plugin` UI の両方から。1104プラグインがインストール完了するとログされます。`claude plugin install` CLI コマンドとインタラクティブ `/plugin` UI の両方から。

1060 1107

1061**属性**:1108**属性**:

1062 1109

1063* すべての [標準属性](#standard-attributes)1110* すべての[標準属性](#standard-attributes)

1064* `event.name`: `"plugin_installed"`1111* `event.name`: `"plugin_installed"`

1065* `event.timestamp`: ISO 8601 タイムスタンプ1112* `event.timestamp`: ISO 8601 タイムスタンプ

1066* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1113* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1067* `marketplace.is_official`: マーケットプレイスが公式 Anthropic マーケットプレイスの場合は `"true"`。それ以外の場合は `"false"`1114* `marketplace.is_official`: マーケットプレイスが公式 Anthropic マーケットプレイスの場合は `"true"`。それ以外の場合は `"false"`

1068* `install.trigger`: `"cli"` または `"ui"`1115* `install.trigger`: `"cli"` または `"ui"`

1069* `plugin.name`: インストールされたプラグインの名前。サードパーティマーケットプレイスの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されている場合のみ含まれます1116* `plugin.name`: インストールされたプラグインの名前。サードパーティマーケットプレイスの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されている場合のみ含まれます

1071* `marketplace.name`: プラグインがインストールされたマーケットプレイス。サードパーティマーケットプレイスの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されている場合のみ含まれます1118* `marketplace.name`: プラグインがインストールされたマーケットプレイス。サードパーティマーケットプレイスの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されている場合のみ含まれます

1072 1119

1073<h4 id="plugin-loaded-event">1120<h4 id="plugin-loaded-event">

1074 プラグイン読み込みイベント1121 プラグインロードイベント

1075</h4>1122</h4>

1076 1123

1077セッション開始時に有効なプラグインごとに 1 回ログされます。このイベントを使用して、フロート全体でアクティブなプラグインをインベントリします。`plugin_installed` はインストールアクション自体を記録するため、補完として。1124セッション開始時に有効なプラグインごとに 1 回ログされます。このイベントを使用して、フロート全体でアクティブなプラグインをインベントリします。`plugin_installed` はインストールアクション自体を記録するため、補完として。

1080 1127

1081**属性**:1128**属性**:

1082 1129

1083* すべての [標準属性](#standard-attributes)1130* すべての[標準属性](#standard-attributes)

1084* `event.name`: `"plugin_loaded"`1131* `event.name`: `"plugin_loaded"`

1085* `event.timestamp`: ISO 8601 タイムスタンプ1132* `event.timestamp`: ISO 8601 タイムスタンプ

1086* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1133* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1087* `plugin.name`: プラグインの名前。公式マーケットプレイスと組み込みバンドルの外のプラグインの場合、値は `OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `"third-party"`1134* `plugin.name`: プラグインの名前。公式マーケットプレイスおよび組み込みバンドル外のプラグインの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り値は `"third-party"`

1088* `marketplace.name`: プラグインがインストールされたマーケットプレイス（既知の場合）。`plugin.name` と同じ条件で `"third-party"` にリダクションされます1135* `marketplace.name`: プラグインがインストールされたマーケットプレイス（既知の場合）。`plugin.name` と同じ条件で `"third-party"` に難読化

1089* `plugin.version`: プラグインマニフェストからのバージョン。名前がリダクションされず、マニフェストがバージョンを宣言する場合のみ含まれます1136* `plugin.version`: プラグインマニフェストからのバージョン。名前が難読化されておらず、マニフェストがバージョンを宣言する場合のみ含まれます

1090* `plugin.scope`: プラグインの出所カテゴリ。`"official"`、`"community"`、`"org"`、`"user-local"`、または `"default-bundle"`1137* `plugin.scope`: プラグインの出所カテゴリ。`"official"`、`"community"`、`"org"`、`"user-local"`、または `"default-bundle"`

1091* `enabled_via`: プラグインが有効になった方法。`"default-enable"`、`"org-policy"`、`"admin-install"`、`"seed-mount"`、または `"user-install"`。`"admin-install"` 値は、プラグインが [**組織設定 > プラグイン**](https://claude.ai/admin-settings/plugins) で組織に対して必須またはオートインストールに設定されていることを意味します。v2.1.246 より前では、Claude Code はこれらのプラグインを `"user-install"` または `"seed-mount"` として報告していました1138* `enabled_via`: プラグインが有効になった方法。`"default-enable"`、`"org-policy"`、`"admin-install"`、`"seed-mount"`、または `"user-install"`。`"admin-install"` 値は、プラグインが [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory) で組織に対して必須またはオートインストールに設定されていることを意味します。v2.1.246 より前では、Claude Code はこれらのプラグインを `"user-install"` または `"seed-mount"` として報告していました

1092* `plugin_id_hash`: プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。フロート全体でロードされた異なるサードパーティプラグインをカウントできます。名前を記録せずに。[claude.ai から同期されたプラグイン](/docs/ja/plugins/loading#synced-plugins) の場合、Claude Code はプラグイン名を claude.ai が報告するマーケットプレイス名、またはそれ以外の場合は `synced` でハッシュします。v2.1.246 より前では、Claude Code はハッシュで claude.ai が報告するマーケットプレイス名を使用していませんでした1139* `plugin_id_hash`: プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。フロート全体で読み込まれた異なるサードパーティプラグインをカウントできます。名前を記録せずに。[claude.ai から同期されたプラグイン](/docs/ja/plugins/loading#synced-plugins)の場合、Claude Code はプラグイン名を claude.ai が報告するマーケットプレイス名、またはそれ以外の場合は `synced` でハッシュします。v2.1.246 より前では、Claude Code はハッシュで claude.ai が報告するマーケットプレイス名を使用していませんでした

1093* `has_hooks`: プラグインがフックに貢献するかどうか1140* `has_hooks`: プラグインがフックに貢献するかどうか

1094* `has_mcp`: プラグインが MCP サーバーに貢献するかどうか1141* `has_mcp`: プラグインが MCP サーバーに貢献するかどうか

1095* `host_owned_mcp`: SDK ホストがこのプラグインの MCP 接続を管理し、Claude Code がプラグインの MCP サーバー設定の読み取りをスキップした場合は `true`。それ以外の場合は `false`。Claude Code v2.1.172 以降が必要1142* `host_owned_mcp`: SDK ホストがこのプラグインの MCP 接続を管理し、Claude Code がプラグインの MCP サーバー設定の読み取りをスキップした場合は `true`。それ以外の場合は `false`。Claude Code v2.1.172 以降が必要

1102 スキル有効化イベント1149 スキル有効化イベント

1103</h4>1150</h4>

1104 1151

1105スキルが呼び出されるとログされます。Claude が Skill ツールを通じて呼び出すか、`/` コマンドとして実行するかどうか。1152スキルが呼び出されるとログされます。Claude が Skill ツール経由で呼び出すか、`/` コマンドとして実行するかに関わらず。

1106 1153

1107**イベント名**: `claude_code.skill_activated`1154**イベント名**: `claude_code.skill_activated`

1108 1155

1109**属性**:1156**属性**:

1110 1157

1111* すべての [標準属性](#standard-attributes)1158* すべての[標準属性](#standard-attributes)

1112* `event.name`: `"skill_activated"`1159* `event.name`: `"skill_activated"`

1113* `event.timestamp`: ISO 8601 タイムスタンプ1160* `event.timestamp`: ISO 8601 タイムスタンプ

1114* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1161* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1115* `skill.name`: スキルの名前。ユーザー定義およびサードパーティプラグインスキルの場合、値は `OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り、プレースホルダー `"custom_skill"`1162* `skill.name`: スキルの名前。ユーザー定義およびサードパーティプラグインスキルの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り値はプレースホルダー `"custom_skill"`

1116* `invocation_trigger`: スキルがトリガーされた方法（`"user-slash"`、`"claude-proactive"`、または `"nested-skill"`）1163* `invocation_trigger`: スキルがどのようにトリガーされたか（`"user-slash"`、`"claude-proactive"`、または `"nested-skill"`）

1117* `skill.source`: スキルが読み込まれた場所（例：`"bundled"`、`"userSettings"`、`"projectSettings"`、`"plugin"`）1164* `skill.source`: スキルがどこから読み込まれたか（例：`"bundled"`、`"userSettings"`、`"projectSettings"`、`"plugin"`）

1118* `skill.kind`: スキルがワークフロースキルの場合は `"workflow"`。それ以外の場合は存在しません1165* `skill.kind`: スキルがワークフロースキルの場合は `"workflow"`。それ以外の場合は不在

1119* `plugin.name`（`OTEL_LOG_TOOL_DETAILS=1` の場合、またはプラグインが公式マーケットプレイスからの場合）: スキルがプラグインによって提供される場合の所有プラグインの名前1166* `plugin.name`（`OTEL_LOG_TOOL_DETAILS=1` の場合またはプラグインが公式マーケットプレイスから）: スキルがプラグインによって提供される場合の所有プラグインの名前

1120* `marketplace.name`（`OTEL_LOG_TOOL_DETAILS=1` の場合、またはプラグインが公式マーケットプレイスからの場合）: スキルがプラグインによって提供される場合、所有プラグインがインストールされたマーケットプレイス1167* `marketplace.name`（`OTEL_LOG_TOOL_DETAILS=1` の場合またはプラグインが公式マーケットプレイスから）: スキルがプラグインによって提供される場合、所有プラグインがインストールされたマーケットプレイス

1121 1168

1122<h4 id="at-mention-event">1169<h4 id="at-mention-event">

1123 @ メンションイベント1170 @ メンションイベント

1124</h4>1171</h4>

1125 1172

1126Claude Code がプロンプト内の `@` メンションを解決するとログされます。すべてのメンションがイベントを発行するわけではありません。権限拒否、サイズ超過ファイル、PDF 参照添付、ディレクトリリスト障害などの早期終了パスはログなしで返されます。1173Claude Code がプロンプト内の `@` メンションを解決するとログされます。すべてのメンションがイベントを発行するわけではありません。権限拒否、ファイルサイズ超過、PDF 参照添付、ディレクトリリスト障害などの早期終了パスはログなしで返されます。

1127 1174

1128**イベント名**: `claude_code.at_mention`1175**イベント名**: `claude_code.at_mention`

1129 1176

1130**属性**:1177**属性**:

1131 1178

1132* すべての [標準属性](#standard-attributes)1179* すべての[標準属性](#standard-attributes)

1133* `event.name`: `"at_mention"`1180* `event.name`: `"at_mention"`

1134* `event.timestamp`: ISO 8601 タイムスタンプ1181* `event.timestamp`: ISO 8601 タイムスタンプ

1135* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1182* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1136* `mention_type`: メンションのタイプ（`"file"`、`"directory"`、`"agent"`、`"mcp_resource"`、`"peer"`）。`"peer"` 値は、[他の Claude Code セッション](/docs/ja/cross-session-messaging) のいずれかをメンションしたことを意味します。Claude Code v2.1.232 以降が必要1183* `mention_type`: メンションのタイプ（`"file"`、`"directory"`、`"agent"`、`"mcp_resource"`、`"peer"`）。`"peer"` 値は [他の Claude Code セッションの 1 つ](/docs/ja/cross-session-messaging)をメンションしたことを意味します。Claude Code v2.1.232 以降が必要

1137* `success`: メンションが正常に解決されたかどうか（`"true"` または `"false"`）1184* `success`: メンションが正常に解決されたかどうか（`"true"` または `"false"`）

1138 1185

1139<h4 id="api-retries-exhausted-event">1186<h4 id="api-retries-exhausted-event">

1140 API 再試行枯渇イベント1187 API 再試行枯渇イベント

1141</h4>1188</h4>

1142 1189

1143API リクエストが複数の試行後に失敗した場合、1 回ログされます。最終 `api_error` イベントと一緒に発行されます。1190API リクエストが複数回の試行後に失敗した場合、1 回ログされます。最終 `api_error` イベントと一緒に発行されます。

1144 1191

1145**イベント名**: `claude_code.api_retries_exhausted`1192**イベント名**: `claude_code.api_retries_exhausted`

1146 1193

1147**属性**:1194**属性**:

1148 1195

1149* すべての [標準属性](#standard-attributes)1196* すべての[標準属性](#standard-attributes)

1150* `event.name`: `"api_retries_exhausted"`1197* `event.name`: `"api_retries_exhausted"`

1151* `event.timestamp`: ISO 8601 タイムスタンプ1198* `event.timestamp`: ISO 8601 タイムスタンプ

1152* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1199* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1153* `model`: 使用されたモデル1200* `model`: 使用されたモデル

1154* `error`: 最終エラーメッセージ1201* `error`: 最終エラーメッセージ

1155* `status_code`: HTTP ステータスコード（数値）。非 HTTP エラーの場合は存在しません。1202* `status_code`: HTTP ステータスコード（数値）。非 HTTP エラーの場合は不在。

1156* `total_attempts`: 実行された試行の総数1203* `total_attempts`: 実行された試行の総数

1157* `total_retry_duration_ms`: すべての試行にわたる総ウォールクロック時間1204* `total_retry_duration_ms`: すべての試行にわたる総ウォールクロック時間

1158* `speed`: `"fast"` または `"normal"`1205* `speed`: `"fast"` または `"normal"`

1161 フック登録イベント1208 フック登録イベント

1162</h4>1209</h4>

1163 1210

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

1165 1212

1166**イベント名**: `claude_code.hook_registered`1213**イベント名**: `claude_code.hook_registered`

1167 1214

1168**属性**:1215**属性**:

1169 1216

1170* すべての [標準属性](#standard-attributes)1217* すべての[標準属性](#standard-attributes)

1171* `event.name`: `"hook_registered"`1218* `event.name`: `"hook_registered"`

1172* `event.timestamp`: ISO 8601 タイムスタンプ1219* `event.timestamp`: ISO 8601 タイムスタンプ

1173* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1220* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1174* `hook_event`: フックイベントタイプ。`"PreToolUse"` または `"PostToolUse"` など1221* `hook_event`: フックイベントタイプ。`"PreToolUse"` または `"PostToolUse"` など

1175* `hook_type`: フック実装タイプ。`"command"`、`"prompt"`、`"mcp_tool"`、`"http"`、または `"agent"`1222* `hook_type`: フック実装タイプ。`"command"`、`"prompt"`、`"mcp_tool"`、`"http"`、または `"agent"`

1176* `hook_source`: フックが定義されている場所。`"userSettings"`、`"projectSettings"`、`"localSettings"`、`"flagSettings"`、`"policySettings"`、または `"pluginHook"`1223* `hook_source`: フックが定義されている場所。`"userSettings"`、`"projectSettings"`、`"localSettings"`、`"flagSettings"`、`"policySettings"`、または `"pluginHook"`

1177* `safe_mode`: セッションが [`--safe-mode`](/docs/ja/cli-reference) で開始された場合は `"true"`。それ以外の場合は `"false"`。Claude Code v2.1.169 以降が必要1224* `safe_mode`: セッションが [`--safe-mode`](/docs/ja/cli-reference) で開始された場合は `"true"`。それ以外の場合は `"false"`。Claude Code v2.1.169 以降が必要

1178* `hook_matcher`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: フック設定が設定されている場合のマッチャー文字列1225* `hook_matcher`（`OTEL_LOG_TOOL_DETAILS=1` の場合）: フック設定から設定されている場合のマッチャー文字列

1179* `plugin.name`（`hook_source` が `"pluginHook"` の場合）: 貢献するプラグインの名前。公式マーケットプレイスと組み込みバンドルの外のプラグインの場合、値は `OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `"third-party"`1226* `plugin.name`（`hook_source` が `"pluginHook"` の場合）: 貢献プラグインの名前。公式マーケットプレイスおよび組み込みバンドル外のプラグインの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り値は `"third-party"`

1180* `plugin_id_hash`（`hook_source` が `"pluginHook"` の場合）: プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。名前を記録せずに、異なる貢献プラグインをカウントできます。Claude Code は [プラグイン読み込みイベント](#plugin-loaded-event) で説明されているように計算します1227* `plugin_id_hash`（`hook_source` が `"pluginHook"` の場合）: プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。名前を記録せずに異なる貢献プラグインをカウントできます。Claude Code は[プラグインロードイベント](#plugin-loaded-event)で説明されているように計算します

1181 1228

1182<h4 id="hook-execution-start-event">1229<h4 id="hook-execution-start-event">

1183 フック実行開始イベント1230 フック実行開始イベント

1189 1236

1190**属性**:1237**属性**:

1191 1238

1192* すべての [標準属性](#standard-attributes)1239* すべての[標準属性](#standard-attributes)

1193* `event.name`: `"hook_execution_start"`1240* `event.name`: `"hook_execution_start"`

1194* `event.timestamp`: ISO 8601 タイムスタンプ1241* `event.timestamp`: ISO 8601 タイムスタンプ

1195* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1242* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1196* `hook_event`: フックイベントタイプ。`"PreToolUse"` または `"PostToolUse"` など1243* `hook_event`: フックイベントタイプ。`"PreToolUse"` または `"PostToolUse"` など

1197* `hook_name`: マッチャーを含む完全なフック名。`"PreToolUse:Write"` など1244* `hook_name`: マッチャーを含む完全なフック名。`"PreToolUse:Write"` など

1198* `num_hooks`: マッチするフックコマンドの数1245* `num_hooks`: マッチングフックコマンドの数

1199* `managed_only`: 管理ポリシーフックのみが許可される場合は `"true"`1246* `managed_only`: 管理ポリシーフックのみが許可される場合は `"true"`

1200* `hook_source`: `"policySettings"` または `"merged"`1247* `hook_source`: `"policySettings"` または `"merged"`

1201* `safe_mode`: セッションが [`--safe-mode`](/docs/ja/cli-reference) で開始された場合は `"true"`。それ以外の場合は `"false"`。Claude Code v2.1.169 以降が必要1248* `safe_mode`: セッションが [`--safe-mode`](/docs/ja/cli-reference) で開始された場合は `"true"`。それ以外の場合は `"false"`。Claude Code v2.1.169 以降が必要

1202* `hook_definitions`: JSON シリアル化されたフック設定。詳細ベータトレースと `OTEL_LOG_TOOL_DETAILS=1` の両方が有効な場合のみ含まれます1249* `hook_definitions`: JSON シリアル化されたフック設定。詳細ベータトレーシングと `OTEL_LOG_TOOL_DETAILS=1` の両方が有効な場合のみ含まれます

1203 1250

1204<h4 id="hook-execution-complete-event">1251<h4 id="hook-execution-complete-event">

1205 フック実行完了イベント1252 フック実行完了イベント

1211 1258

1212**属性**:1259**属性**:

1213 1260

1214* すべての [標準属性](#standard-attributes)1261* すべての[標準属性](#standard-attributes)

1215* `event.name`: `"hook_execution_complete"`1262* `event.name`: `"hook_execution_complete"`

1216* `event.timestamp`: ISO 8601 タイムスタンプ1263* `event.timestamp`: ISO 8601 タイムスタンプ

1217* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1264* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1218* `hook_event`: フックイベントタイプ1265* `hook_event`: フックイベントタイプ

1219* `hook_name`: マッチャーを含む完全なフック名1266* `hook_name`: マッチャーを含む完全なフック名

1220* `num_hooks`: マッチするフックコマンドの数1267* `num_hooks`: マッチングフックコマンドの数

1221* `num_success`: 正常に完了したカウント1268* `num_success`: 正常に完了したカウント

1222* `num_blocking`: ブロッキング決定を返したカウント1269* `num_blocking`: ブロッキング決定を返したカウント

1223* `num_non_blocking_error`: ブロッキングなしで失敗したカウント1270* `num_non_blocking_error`: ブロッキングなしで失敗したカウント

1224* `num_cancelled`: 完了前にキャンセルされたカウント1271* `num_cancelled`: 完了前にキャンセルされたカウント

1225* `total_duration_ms`: すべてのマッチするフックのウォールクロック期間1272* `total_duration_ms`: すべてのマッチングフックのウォールクロック期間

1226* `stdout_chars`: 成功したマッチするフック全体の stdout の総文字数。Claude Code v2.1.280 以降が必要1273* `stdout_chars`: 成功したマッチングフック全体の stdout の総文字数。Claude Code v2.1.280 以降が必要

1227* `additional_context_chars`: マッチするフックによって返された `additionalContext` の総文字数。Claude Code v2.1.280 以降が必要1274* `additional_context_chars`: マッチングフックによって返された `additionalContext` の総文字数。Claude Code v2.1.280 以降が必要

1228* `system_message_chars`: マッチするフックによって返された `systemMessage` の総文字数。Claude Code v2.1.280 以降が必要1275* `system_message_chars`: マッチングフックによって返された `systemMessage` の総文字数。Claude Code v2.1.280 以降が必要

1229* `initial_user_message_chars`: マッチするフックによって返された `initialUserMessage` の総文字数。Claude Code v2.1.280 以降が必要1276* `initial_user_message_chars`: マッチングフックによって返された `initialUserMessage` の総文字数。Claude Code v2.1.280 以降が必要

1230* `num_outputs_persisted`: [10,000 文字キャップ](/docs/ja/hooks#json-output) を超えたフック出力の数。Claude Code がファイルに保存。Claude Code v2.1.280 以降が必要1277* `num_outputs_persisted`: [10,000 文字キャップ](/docs/ja/hooks#json-output)を超えるフック出力の数。Claude Code がファイルに保存。Claude Code v2.1.280 以降が必要

1231* `managed_only`: 管理ポリシーフックのみが許可される場合は `"true"`1278* `managed_only`: 管理ポリシーフックのみが許可される場合は `"true"`

1232* `hook_source`: `"policySettings"` または `"merged"`1279* `hook_source`: `"policySettings"` または `"merged"`

1233* `safe_mode`: セッションが [`--safe-mode`](/docs/ja/cli-reference) で開始された場合は `"true"`。それ以外の場合は `"false"`。Claude Code v2.1.169 以降が必要1280* `safe_mode`: セッションが [`--safe-mode`](/docs/ja/cli-reference) で開始された場合は `"true"`。それ以外の場合は `"false"`。Claude Code v2.1.169 以降が必要

1234* `hook_definitions`: JSON シリアル化されたフック設定。詳細ベータトレースと `OTEL_LOG_TOOL_DETAILS=1` の両方が有効な場合のみ含まれます1281* `hook_definitions`: JSON シリアル化されたフック設定。詳細ベータトレーシングと `OTEL_LOG_TOOL_DETAILS=1` の両方が有効な場合のみ含まれます

1235 1282

1236<h4 id="hook-plugin-metrics-event">1283<h4 id="hook-plugin-metrics-event">

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

1238</h4>1285</h4>

1239 1286

1240公式マーケットプレイスプラグインフックが呼び出しごとのメトリクスを発行するとログされます。公式 Anthropic マーケットプレイスからインストールされたプラグインのみがこれを発行できます。サードパーティマーケットプレイスプラグインとユーザー設定フックはこのイベントに発行しません。このイベントを使用して、独自の可観測性スタックからプラグイン動作（検出率、コスト、期間など）を監視します。1287公式マーケットプレイスプラグインフックが呼び出しごとのメトリクスを発行するとログされます。公式 Anthropic マーケットプレイスからインストールされたプラグインのみがこれを発行できます。サードパーティマーケットプレイスプラグインおよびユーザー設定フックはこのイベントに発行しません。このイベントを使用して、独自の可観測性スタックからプラグイン動作（検出率、コスト、期間など）を監視します。

1241 1288

1242**イベント名**: `claude_code.hook_plugin_metrics`1289**イベント名**: `claude_code.hook_plugin_metrics`

1243 1290

1244**属性**:1291**属性**:

1245 1292

1246* すべての [標準属性](#standard-attributes)1293* すべての[標準属性](#standard-attributes)

1247* `event.name`: `"hook_plugin_metrics"`1294* `event.name`: `"hook_plugin_metrics"`

1248* `event.timestamp`: ISO 8601 タイムスタンプ1295* `event.timestamp`: ISO 8601 タイムスタンプ

1249* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1296* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1250* `plugin_id`: `<name>@<marketplace>` 形式のプラグイン識別子1297* `plugin_id`: `<name>@<marketplace>` 形式のプラグイン識別子

1251* `hook_event`: メトリクスを発行したフックイベントタイプ1298* `hook_event`: メトリクスを発行したフックイベントタイプ

1252* 最大 20 個のプラグイン発行メトリクスキー。名前は `^[a-z][a-z0-9_]{0,39}$` と一致します。値はブール値または数値。1299* 最大 20 個のプラグイン発行メトリクスキー。名前は `^[a-z][a-z0-9_]{0,39}$` と一致します。値はブール値または数値。

1261 1308

1262**属性**:1309**属性**:

1263 1310

1264* すべての [標準属性](#standard-attributes)1311* すべての[標準属性](#standard-attributes)

1265* `event.name`: `"compaction"`1312* `event.name`: `"compaction"`

1266* `event.timestamp`: ISO 8601 タイムスタンプ1313* `event.timestamp`: ISO 8601 タイムスタンプ

1267* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1314* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1268* `trigger`: `"auto"` または `"manual"`1315* `trigger`: `"auto"` または `"manual"`

1269* `success`: `"true"` または `"false"`1316* `success`: `"true"` または `"false"`

1270* `duration_ms`: 圧縮期間1317* `duration_ms`: 圧縮期間

1271* `pre_tokens`: 圧縮前の概算トークンカウント1318* `pre_tokens`: 圧縮前の概算トークンカウント

1272* `post_tokens`: 圧縮後の概算トークンカウント1319* `post_tokens`: 圧縮後の概算トークンカウント

1273* `error`: 圧縮が失敗した場合のエラーメッセージ1320* `error`: 圧縮が失敗した場合のエラーメッセージ

1274* `precompute_reuse`: `trigger` が `"manual"` の場合のみ設定。自動圧縮は、コンテキストウィンドウが満杯になる前にバックグラウンドで概要を準備でき、この属性は `/compact` がその準備された概要を再利用したかどうかを記録します。`"hit"` は再利用されたことを意味します。`"miss_custom_instructions"`、`"miss_hook"`、`"miss_not_ready"` は、代わりに新しい概要が計算された理由を示します。Claude Code v2.1.153 以降が必要1321* `precompute_reuse`: `trigger` が `"manual"` の場合のみ設定。自動圧縮はコンテキストウィンドウが満杯になる前にバックグラウンドで概要を準備でき、この属性は `/compact` がその準備された概要を再利用したかどうかを記録します。`"hit"` は再利用されたことを意味します。`"miss_custom_instructions"`、`"miss_hook"`、`"miss_not_ready"` は代わりに新しい概要が計算された理由を示します。Claude Code v2.1.153 以降が必要

1275 1322

1276<h4 id="subagent-completed-event">1323<h4 id="subagent-completed-event">

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

1278</h4>1325</h4>

1279 1326

1280[サブエージェント](/docs/ja/sub-agents) が完了し、それを開始した会話に結果を返すとログされます。ツール使用と実行時をサブエージェントタイプでロールアップするために使用します。トークンまたはコストロールアップの場合、`query_source` を `"subagent"` にフィルタリングした [トークンカウンター](#token-counter) および [コストカウンター](#cost-counter) を使用します。このイベントの `total_tokens` は最終リクエストのみをカバーするため。`"subagent"` カテゴリはエージェントベースのフックからのリクエストもカウントします。サブエージェントイベントは発行しません。1327[サブエージェント](/docs/ja/sub-agents)が完了し、結果をそれを開始した会話に返すとログされます。ツール使用と実行時をサブエージェントタイプ別にロールアップするために使用します。トークンまたはコストロールアップの場合、[トークンカウンター](#token-counter)および[コストカウンター](#cost-counter)を `query_source` `"subagent"` でフィルタリングして使用します。このイベントの `total_tokens` は最終リクエストのみをカバーするため。`"subagent"` カテゴリはエージェントベースのフックからのリクエストもカウントします。これはサブエージェントイベントを発行しません。

1281 1328

1282**イベント名**: `claude_code.subagent_completed`1329**イベント名**: `claude_code.subagent_completed`

1283 1330

1284**属性**:1331**属性**:

1285 1332

1286* すべての [標準属性](#standard-attributes)1333* すべての[標準属性](#standard-attributes)

1287* `event.name`: `"subagent_completed"`1334* `event.name`: `"subagent_completed"`

1288* `event.timestamp`: ISO 8601 タイムスタンプ1335* `event.timestamp`: ISO 8601 タイムスタンプ

1289* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1336* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1290* `agent_type`: サブエージェントタイプ。組み込みエージェント名と公式マーケットプレイスプラグインのエージェントはそのまま表示されます。他のエージェント名は `OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `"custom"` に置き換えられます1337* `agent_type`: サブエージェントタイプ。組み込みエージェント名と公式マーケットプレイスプラグインのエージェントはそのまま表示されます。他のエージェント名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `"custom"` に置き換えられます

1291* `agent.source`: エージェント定義の出所。`built-in`、`plugin`、またはカスタムエージェントを定義した設定ソース（`userSettings` や `projectSettings` など）1338* `agent.source`: エージェント定義がどこから来たか。`built-in`、`plugin`、または `userSettings` や `projectSettings` などのカスタムエージェントを定義した設定ソース

1292* `is_built_in`: サブエージェントが組み込みエージェントタイプであるかどうか1339* `is_built_in`: サブエージェントが組み込みエージェントタイプであるかどうか

1293* `is_async`: サブエージェントが [バックグラウンド](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) で実行されたかどうか1340* `is_async`: サブエージェントが[バックグラウンド](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)で実行されたかどうか

1294* `total_tokens`: サブエージェントの最終 API リクエストのトークンフットプリント。その 1 つのリクエストの入力、キャッシュ作成、キャッシュ読み取り、出力トークン。大体、完了時のサブエージェントのコンテキストサイズ。実行全体のサムではありません1341* `total_tokens`: サブエージェントの最終 API リクエストのトークンフットプリント。その 1 つのリクエストの入力、キャッシュ作成、キャッシュ読み取り、出力トークン。大体、完了時のサブエージェントのコンテキストサイズ。実行全体にわたる合計ではありません

1295* `total_tool_uses`: サブエージェントが実行全体で行ったツール呼び出しの数1342* `total_tool_uses`: サブエージェントが実行全体で行ったツール呼び出しの数

1296* `duration_ms`: 実行時間（ミリ秒）1343* `duration_ms`: ミリ秒単位の実行時間

1297* `model`: サブエージェントが実行するために解決されたモデル1344* `model`: サブエージェントが実行するために解決されたモデル

1298* `final_model`: サブエージェントの最終応答を生成したモデル。フォールバックなどの実行中スイッチ後に `model` と異なります。Claude Code v2.1.212 以降が必要1345* `final_model`: サブエージェントの最終レスポンスを生成したモデル。フォールバックなどの実行中スイッチ後に `model` と異なります。Claude Code v2.1.212 以降が必要

1299* `model_swapped`: 複数のモデルがサブエージェントのリクエストを提供したかどうか。Claude Code v2.1.212 以降が必要1346* `model_swapped`: 複数のモデルがサブエージェントのリクエストに対応したかどうか。Claude Code v2.1.212 以降が必要

1300* `plugin_id_hash`、`plugin.name`: プラグイン提供エージェント用に存在。公式マーケットプレイスプラグイン名はそのまま表示されます。他のプラグイン名は `OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `"third-party"` に置き換えられます1347* `plugin_id_hash`、`plugin.name`: プラグイン提供エージェント用に存在。公式マーケットプレイスプラグイン名はそのまま表示されます。他のプラグイン名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `"third-party"` に置き換えられます

1301 1348

1302<h4 id="feedback-survey-event">1349<h4 id="feedback-survey-event">

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

1304</h4>1351</h4>

1305 1352

1306セッション品質調査が表示または回答されるとログされます。[セッション品質調査](/docs/ja/data-usage#session-quality-surveys) で調査が収集する内容と制御方法を参照してください。1353セッション品質調査が表示または回答されるとログされます。調査が収集する内容と制御方法については[セッション品質調査](/docs/ja/data-usage#session-quality-surveys)を参照。

1307 1354

1308**イベント名**: `claude_code.feedback_survey`1355**イベント名**: `claude_code.feedback_survey`

1309 1356

1310**属性**:1357**属性**:

1311 1358

1312* すべての [標準属性](#standard-attributes)1359* すべての[標準属性](#standard-attributes)

1313* `event.name`: `"feedback_survey"`1360* `event.name`: `"feedback_survey"`

1314* `event.timestamp`: ISO 8601 タイムスタンプ1361* `event.timestamp`: ISO 8601 タイムスタンプ

1315* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1362* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1316* `event_type`: 調査ライフサイクルイベント。例：`"appeared"`、`"responded"`、`"transcript_prompt_appeared"`1363* `event_type`: 調査ライフサイクルイベント。例：`"appeared"`、`"responded"`、`"transcript_prompt_appeared"`

1317* `appearance_id`: 1 つの調査インスタンスに対して発行されたイベントをリンクする一意の ID1364* `appearance_id`: 1 つの調査インスタンスに対して発行されたイベントをリンクする一意の ID

1318* `survey_type`: イベントを生成した調査。`"session"` は「Claude はどのように機能していますか？」評価プロンプト1365* `survey_type`: イベントを生成した調査。`"session"` は「Claude はどのように機能していますか？」評価プロンプト

1319* `response`: `responded` イベントのユーザーの選択1366* `response`: `responded` イベントのユーザーの選択

1320* `enabled_via_override`: [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/ja/env-vars) が設定されている場合は `true`。文字列ではなくブール値として発行。`session` 調査イベントに存在。このオーバーライドがフロート全体で適用されていることを確認するには、この属性でフィルタリングします1367* `enabled_via_override`: [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/ja/env-vars) が設定されている場合は `true`。文字列ではなくブール値として発行。`session` 調査イベントに存在。このオーバーライドがフロート全体に適用されていることを確認するにはこの属性でフィルタリング

1321 1368

1322<h4 id="retention-sweep-event">1369<h4 id="retention-sweep-event">

1323 保持スイープイベント1370 保持スイープイベント

1324</h4>1371</h4>

1325 1372

1326保持クリーンアップスイープの実行ごとに 1 回ログされます。[セッショントランスクリプトおよび他のアプリケーションデータ](/docs/ja/claude-directory#cleaned-up-automatically) を [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) 設定より古い削除します。Claude Code はバックグラウンドでスイープを実行し、セッションごとに最大 1 回。何も削除しない実行でもイベントを発行します。Claude Code が同じマシン上の任意のセッションで過去 24 時間にスイープを実行した場合、このセッションのスイープを少なくとも 10 分遅延させるため、より早く終了するセッションは何も発行しません。`claude -p` を `--bare` で実行する場合、Claude Code はスイープを実行せず、何も発行しません。1373保持クリーンアップスイープの実行ごとに 1 回ログされます。[セッショントランスクリプトおよび他のアプリケーションデータ](/docs/ja/claude-directory#cleaned-up-automatically)を [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) 設定より古い削除。Claude Code はバックグラウンドでスイープを実行します。セッションごとに最大 1 回。何も削除しない実行でもイベントを発行します。Claude Code が同じマシン上の任意のセッションで過去 24 時間にスイープを実行した場合、このセッションのスイープを少なくとも 10 分遅延させるため、より早く終了するセッションは何も発行しません。`claude -p` を `--bare` で実行する場合、Claude Code はスイープを実行せず、何も発行しません。

1327 1374

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

1329 1376

1330Claude Code が保持期間を安全に決定できない場合、スイープを一時停止し、`result` を `"skipped"` に設定し、`skip_reason` を持つイベントを発行します。[管理設定](/docs/ja/server-managed-settings) が `cleanupPeriodDays` を設定する場合、管理値は保持期間をピンし、下位優先度スコープの設定ファイルが破損または無効な場合でもスイープが実行されます。`managed-settings.json` 自体が読み取れない場合、Claude Code は [管理層](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) がサーバー管理設定などの他の場所から `cleanupPeriodDays` を提供しない限り、スイープを一時停止します。破損したファイルの横にある `managed-settings.d/` ドロップイン。削除カウンター属性は `result` が `"complete"` の場合のみ存在します。1377Claude Code が保持期間を安全に決定できない場合、スイープを一時停止し、`result` を `"skipped"` に設定し、`skip_reason` を含むイベントを発行します。[管理設定](/docs/ja/server-managed-settings)が `cleanupPeriodDays` を設定する場合、管理値は保持期間をピンで留め、スイープは下位優先度スコープの設定ファイルが破損または無効な場合でも実行されます。[管理層](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)が `cleanupPeriodDays` をサーバー管理設定などの他の場所から供給する場合、`managed-settings.json` 自体が読み取れない場合でも Claude Code はスイープを一時停止します。削除カウンター属性は `result` が `"complete"` の場合のみ存在します。

1331 1378

1332**イベント名**: `claude_code.retention_sweep`1379**イベント名**: `claude_code.retention_sweep`

1333 1380

1334**属性**:1381**属性**:

1335 1382

1336* すべての [標準属性](#standard-attributes)1383* すべての[標準属性](#standard-attributes)

1337* `event.name`: `"retention_sweep"`1384* `event.name`: `"retention_sweep"`

1338* `event.timestamp`: ISO 8601 タイムスタンプ1385* `event.timestamp`: ISO 8601 タイムスタンプ

1339* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1386* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

1340* `result`: スイープが実行された場合は `"complete"`。Claude Code がそれを一時停止した場合は `"skipped"`1387* `result`: スイープが実行された場合は `"complete"`。Claude Code が一時停止した場合は `"skipped"`

1341* `period_days`: マージされた設定からの `cleanupPeriodDays` 値（日数）。またはソースが設定しない場合は `30`。スキップされたイベントでは、スイープが使用した値。Claude Code が読み取れた設定ソースから計算1388* `period_days`: マージされた設定からの `cleanupPeriodDays` 値（日数）。またはソースが設定しない場合は `30`。スキップされたイベントでは、スイープが使用した値。Claude Code が読み取れた設定ソースから計算

1342* `used_default`: 読み取り可能な設定ソースが `cleanupPeriodDays` を設定しない場合は `"true"`。それ以外の場合は `"false"`。完了イベントでは、`"true"` は 30 日のデフォルトが適用されたことを意味します1389* `used_default`: 読み取り可能な設定ソースが `cleanupPeriodDays` を設定しない場合は `"true"`。それ以外の場合は `"false"`。完了イベントでは、`"true"` は 30 日のデフォルトが適用されたことを意味します

1343* `skip_reason`: Claude Code がスイープを一時停止した理由。`result` が `"skipped"` の場合のみ存在:1390* `skip_reason`: Claude Code がスイープを一時停止した理由。`result` が `"skipped"` の場合のみ存在。

1344 * `"user_source_disabled"`: ユーザー設定は除外されます。例えば、[`--setting-sources`](/docs/ja/cli-reference#cli-flags) フラグまたは SDK の [`settingSources`](/docs/ja/agent-sdk/typescript#options) オプションによって。有効なソースが `cleanupPeriodDays` を提供しません1391 * `"user_source_disabled"`: ユーザー設定は除外されます。例：[`--setting-sources`](/docs/ja/cli-reference#cli-flags) フラグまたは SDK の [`settingSources`](/docs/ja/agent-sdk/typescript#options) オプション。有効なソースが `cleanupPeriodDays` を提供しません

1345 * `"settings_unknowable"`: 設定ファイルが読み取れないか解析できないため、`cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が Claude Code が見ることができない値に設定されている可能性があります1392 * `"settings_unknowable"`: 設定ファイルが読み取られたまたは解析できず、`cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が Claude Code が見ることができない値に設定されている可能性があります

1346 * `"settings_invalid_key_set"`: 設定に検証エラーがあり、`cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が明示的に設定されているため、デフォルトにフォールバックするとその設定に対してファイルを削除または保持する可能性があります1393 * `"settings_invalid_key_set"`: 設定に検証エラーがあり、`cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が明示的に設定されているため、デフォルトにフォールバックするとその設定に対してファイルを削除または保持できます

1347* `transcripts_deleted`: セッショントランスクリプト。トップレベルの `~/.claude/projects/*/*.jsonl` ファイル。スイープが削除した数1394* `transcripts_deleted`: スイープが削除したセッショントランスクリプト。トップレベル `~/.claude/projects/*/*.jsonl` ファイルの数

1348* `transcripts_exempted_desktop`: 保持期間を過ぎたトランスクリプトの数。スイープが [Claude Desktop および Cowork ルール](/docs/ja/claude-directory#cleaned-up-automatically) の下で保持。これらは `files_past_cutoff` にカウントされません。Claude Code v2.1.248 以降が必要1395* `transcripts_exempted_desktop`: 保持期間を過ぎたトランスクリプトの数。スイープが [Claude Desktop および Cowork ルール](/docs/ja/claude-directory#cleaned-up-automatically)の下で保持。`files_past_cutoff` にカウントされません。Claude Code v2.1.248 以降が必要

1349* `session_files_deleted`: セッションファイルスイープが削除したアーティファクトの数。トランスクリプトとサイドカー、録音、ツール結果などのセッションごとのコンパニオンファイル1396* `session_files_deleted`: セッションファイルスイープが削除したアーティファクトの数。トランスクリプトとサイドカー、録音、ツール結果などのセッションごとのコンパニオンファイル

1350* `artifacts_deleted`: データディレクトリ全体でスイープが削除した総アイテム。セッションファイルを含む。一部のスイープは削除されたディレクトリツリー全体を 1 つのアイテムとしてカウントし、いくつかのクリーンアップパスはカウンターに貢献しないため、値を正確なファイルカウントではなくフロアとして扱います1397* `artifacts_deleted`: データディレクトリ全体でスイープが削除した総アイテム数。セッションファイルを含む。一部のスイープは削除されたディレクトリツリー全体を 1 つのアイテムとしてカウントし、いくつかのクリーンアップパスはカウンターに貢献しないため、値を正確なファイルカウントではなくフロアとして扱います

1351* `files_retained_fresh`: 検査され、保持期間内であるため所定の位置に残されたファイル。ファイルごとのスイープのみがこれをカウントするため、値はフロア。ゼロ以外の値は通常の定常状態です1398* `files_retained_fresh`: 検査され、保持期間内であるため所定の位置に残されたファイル。ファイルごとのスイープのみがこれをカウントするため、値はフロア。ゼロ以外の値は通常の定常状態です

1352* `files_past_cutoff`: 保持期間より古いファイル。スイープが削除に失敗。例えば、権限エラーまたは開いているファイルのため。ゼロ以上の値は、ファイルが設定された保持期間を超えたことを意味します。ゼロは、ディレクトリ削除全体の失敗が代わりに `error_count` にカウントされるため、何もしなかったことの証明ではありません1399* `files_past_cutoff`: 保持期間より古いファイル。スイープが削除に失敗。例：権限エラーまたはファイルが開いている。ゼロを超える値は、ファイルが設定された保持期間を超えたことを意味します。ゼロは何もしなかったことの証明ではありません。ディレクトリ全体の削除に失敗すると `error_count` にカウントされるため。

1353* `error_count`: スイープがファイルをリストまたは削除しながら遭遇したエラーの数1400* `error_count`: スイープがファイルをリストまたは削除する際に遭遇したエラーの数

1354 1401

1355<h4 id="managed-settings-resolved-event">1402<h4 id="managed-settings-resolved-event">

1356 管理設定解決イベント1403 管理設定解決イベント

1357</h4>1404</h4>

1358 1405

1359セッションが解決した [管理設定](/docs/ja/managed-settings): セッション開始時に 1 回、セッション中に管理設定または [ポリシーヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program) の状態が変わるときに再度、Claude Code がセッションを開始することを拒否するか、`error.type` 属性がリストする理由の 1 つでセッションを終了するときに。1406セッションが解決した[管理設定](/docs/ja/managed-settings)でログされます。セッション開始時に 1 回。管理設定または[ポリシーヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)の状態がセッション中に変わるときに再度。Claude Code がセッションを開始することを拒否するか、`error.type` 属性がリストする理由の 1 つでセッションを終了するとき。

1360このイベントを使用して、予期しない管理ソースで実行されているマシン、ポリシーヘルパーが失敗しているマシン、マシンが開始を拒否した理由を見つけます。1407このイベントを使用して、予期しない管理ソースで実行されているマシン、ポリシーヘルパーが失敗しているマシン、マシンが開始を拒否した理由を見つけます。

1361Claude Code v2.1.274 以降が必要です。1408Claude Code v2.1.274 以降が必要。

1362 1409

1363デフォルトでは、イベントは管理ソースとポリシーヘルパーの状態を持ちますが、設定自体は持ちません。リダクションされた `managed_settings.settings` 属性と `managed_settings.resolved_sha256` ダイジェストを追加するには、`OTEL_LOG_MANAGED_SETTINGS=1` を設定します。1410デフォルトでは、イベントは管理ソースとポリシーヘルパーの状態を保持しますが、設定自体は保持しません。難読化された `managed_settings.settings` 属性と `managed_settings.resolved_sha256` ダイジェストを追加するには、`OTEL_LOG_MANAGED_SETTINGS=1` を設定します。

1364 1411

1365* 管理設定、ユーザー設定、または `--settings` の `env` ブロック、または Claude Code を起動する環境で設定します。プロジェクトまたはローカル設定の値は有効にしません。クローンされたリポジトリはそれらを書き込むことができるため。1412* 管理設定、ユーザー設定、`--settings` の `env` ブロック、または Claude Code を起動する環境に設定します。プロジェクトまたはローカル設定の値はオンにしません。クローンされたリポジトリはそれらを書き込むことができるため。

1366* サーバー管理設定は、変数が組織が既に受け取るイベントに組織自体のリダクションされたポリシーのみを追加するため、[セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs) を表示せずに設定できます。1413* サーバー管理設定は、変数が組織が既に受け取るイベントに組織自体の難読化ポリシーのみを追加するため、[セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs)を表示せずに設定できます。

1367 1414

1368信頼していないフォルダ内のインタラクティブセッションでは、Claude Code は拒否イベントをエクスポートしません。プロジェクトおよびローカル設定はエクスポートを別のコレクターにポイントできるため、[信頼](/docs/ja/permissions#what-runs-before-you-trust-a-folder) する前に。1415信頼していない[フォルダ](/docs/ja/permissions#what-runs-before-you-trust-a-folder)のインタラクティブセッションでは、Claude Code は拒否イベントをエクスポートしません。

1369 1416

1370**イベント名**: `claude_code.managed_settings_resolved`1417**イベント名**: `claude_code.managed_settings_resolved`

1371 1418

1372**属性**:1419**属性**:

1373 1420

1374* すべての [標準属性](#standard-attributes)1421* すべての[標準属性](#standard-attributes)

1375* `event.name`: `"managed_settings_resolved"`1422* `event.name`: `"managed_settings_resolved"`

1376* `event.timestamp`: ISO 8601 タイムスタンプ1423* `event.timestamp`: ISO 8601 タイムスタンプ

1377* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明1424* `event.sequence`: イベント順序付けのプロセスごとカウンター。[イベント相関属性](#event-correlation-attributes)で説明

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

1379* `error.type`: Claude Code がセッションを停止した理由。`refused` イベントにのみ存在:1426* `error.type`: Claude Code がセッションを停止した理由。`refused` イベントでのみ存在。

1380 * `"helper_failed"`: [ポリシーヘルパー実行が失敗](/docs/ja/settings-reference#helper-failures)1427 * `"helper_failed"`: [ポリシーヘルパー実行が失敗](/docs/ja/settings-reference#helper-failures)

1381 * `"policy_invalid"`: 管理設定にエラーが含まれており、Claude Code が開始できない、またはアドミンソースが読み込めないため、Claude Code は組織ログイン強制をチェックできません1428 * `"policy_invalid"`: 管理設定に Claude Code が開始するのを停止するエラーが含まれるか、管理ソースが読み込みに失敗したため、Claude Code は組織ログイン強制を確認できません

1382 * `"consent_rejected"`: ユーザーがサーバー管理設定の [セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs) を拒否しました1429 * `"consent_rejected"`: ユーザーがサーバー管理設定の[セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs)を拒否

1383 * `"force_refresh_failed"`: [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) が必要とする設定フェッチが失敗しました1430 * `"force_refresh_failed"`: [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) が必要とする設定フェッチが失敗

1384 * `"gateway_rejected"`: [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway) が管理設定ロードに HTTP 403 で応答しました1431 * `"gateway_rejected"`: [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway)が管理設定ロードに HTTP 403 で応答

1385 * `"version_below_minimum"`: この Claude Code バージョンは [`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion) より下、または [`requiredMaximumVersion`](/docs/ja/settings-reference#requiredmaximumversion) より上です1432 * `"version_below_minimum"`: この Claude Code バージョンが [`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion) より下または [`requiredMaximumVersion`](/docs/ja/settings-reference#requiredmaximumversion) より上

1386 * `"_OTHER"`: Claude アプリゲートウェイ管理設定ロードが別の理由で失敗しました1433 * `"_OTHER"`: Claude アプリゲートウェイ管理設定ロードが別の理由で失敗

1387* `managed_settings.sources`: [ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を少なくとも 1 つ配信するすべての管理ソース。優先度が最も高い順。`first-wins` の下で効果を持たないソースを含む。値は `"remote"`、`"plist"` または `"hklm"` は MDM または OS レベルのポリシー、`"file"` は管理設定ファイルおよびドロップイン、`"parent"` は [埋め込みホスト](/docs/ja/managed-settings#let-an-embedding-host-add-policy) が設定を提供する場合、`"hkcu"` は Claude Code が [読み取る](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) 場合の [Windows HKCU レジストリ値](/docs/ja/managed-settings#where-each-mechanism-stores-the-policy)。ポリシーキーのみを持つソース、または Claude Code が読み取れなかったソースはリストされていません。文字列の配列として発行。管理ソースがポリシーキーを配信しない場合は空1434* `managed_settings.sources`: 少なくとも 1 つの[ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)を配信するすべての管理ソース。優先度が最も高い順。`first-wins` の下で効果を持たないソースを含む。値は `"remote"`、MDM または OS レベルポリシーの `"plist"` または `"hklm"`、管理設定ファイルおよびドロップインの `"file"`、[埋め込みホスト](/docs/ja/managed-settings#let-an-embedding-host-add-policy)が設定を供給する場合は `"parent"`、Claude Code が[読み取る](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)場合は [Windows HKCU レジストリ値](/docs/ja/managed-settings#where-each-mechanism-stores-the-policy)の `"hkcu"`。制御キーのみを保持するソース、または Claude Code が読み取れなかったソースはリストされません。文字列の配列として発行。管理ソースがポリシーキーを配信しない場合は空

1388* `managed_settings.source_behavior`: Claude Code が読み取った [`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) 値。`"first-wins"` または `"merge"`。キーが設定されていない場合は `"first-wins"`1435* `managed_settings.source_behavior`: Claude Code が読み取った [`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) 値。`"first-wins"` または `"merge"`。ソースがキーを設定しない場合は `"first-wins"`

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

1390 * `"ok"`: ヘルパーの出力が管理設定として機能1437 * `"ok"`: ヘルパーの出力が管理設定として機能

1391 * `"bad_path"`、`"not_a_file"`、`"exit_nonzero"`、`"timed_out"`、`"oversize"`、`"parse_failed"`、`"envelope_invalid"`、または `"schema_rejected"`: ヘルパーの最後の実行が失敗。[ヘルパー障害](/docs/ja/settings-reference#helper-failures) はケースを説明1438 * `"bad_path"`、`"not_a_file"`、`"exit_nonzero"`、`"timed_out"`、`"oversize"`、`"parse_failed"`、`"envelope_invalid"`、または `"schema_rejected"`: ヘルパーの最後の実行が失敗。[ヘルパー障害](/docs/ja/settings-reference#helper-failures)が場合を説明

1392 * `"none"`: ヘルパーが設定されていない、またはそれを設定するソースが MDM ポリシーまたは管理設定ファイルではない1439 * `"none"`: ヘルパーが設定されていない、またはそれを設定するソースが MDM ポリシーまたは管理設定ファイルではありません

1393* `managed_settings.helper.applied`: ヘルパーの独自の出力が管理設定として機能する場合は `"output"`。そうでない場合は `"none"`1440* `managed_settings.helper.applied`: ヘルパーの独自の出力が管理設定として機能する場合は `"output"`。機能しない場合は `"none"`

1394* `managed_settings.helper.entry`: Claude Code が [`policyHelper`](/docs/ja/settings-reference#policyhelper) を選択した場合は `"policyHelper"`。ヘルパーを選択しなかった場合は存在しません1441* `managed_settings.helper.entry`: Claude Code が [`policyHelper`](/docs/ja/settings-reference#policyhelper) を選択した場合は `"policyHelper"`。ヘルパーを選択しなかった場合は不在

1395* `managed_settings.helper.path`: ヘルパーの設定された [`path`](/docs/ja/settings-reference#policyhelper-path)。Claude Code がヘルパーを選択したときはいつでも存在。`OTEL_LOG_MANAGED_SETTINGS` が設定されているかどうかに関わらず1442* `managed_settings.helper.path`: ヘルパーの設定された [`path`](/docs/ja/settings-reference#policyhelper-path)。Claude Code がヘルパーを選択した場合は常に存在。`OTEL_LOG_MANAGED_SETTINGS` が設定されているかどうかに関わらず

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

1397* `managed_settings.settings`（`OTEL_LOG_MANAGED_SETTINGS=1` の場合）: 解決された管理設定の名前と形状。値はリダクションされます。JSON 文字列として。`refused` イベントでは存在しません。Claude Code はその設定スキーマから構築します:1444* `managed_settings.settings`（`OTEL_LOG_MANAGED_SETTINGS=1` の場合）: 解決された管理設定の名前と形状。JSON 文字列として。値は難読化。`refused` イベントでは不在。Claude Code はその設定スキーマから構築します。

~~1398~~ 1445

1399 * スキーマが宣言する設定名はエクスポートされ、スキーマが宣言しないキーは除外されます1446 * スキーマが宣言するエクスポート設定名。宣言しないキーは除外

1400 * ブール値、数値、および文字列値。スキーマが `permissions.defaultMode` などの固定オプションセットに制限する場合、そのままエクスポートされます。`sandbox.network.httpProxyPort` および `sandbox.network.socksProxyPort` は `"[REDACTED]"` としてエクスポートされます1447 * ブール値、数値、スキーマが固定オプションセットに制限する文字列値。`permissions.defaultMode` など。そのまま発行。`sandbox.network.httpProxyPort` および `sandbox.network.socksProxyPort` は `"[REDACTED]"` として発行

1401 * その他のすべての文字列。`model`、`apiKeyHelper`、すべての `env` 値、すべての URL、およびすべてのコマンドは `"[REDACTED]"` としてエクスポートされます1448 * 他のすべての文字列。`model`、`apiKeyHelper`、すべての `env` 値、すべての URL、すべてのコマンド。`"[REDACTED]"` として発行

1402 * マップのエントリ名。`env` 変数名およびプラグイン ID はそのままエクスポートされます。スキーマが入力をタイプしない設定。`vimInsertModeRemaps` などは単一の `"[REDACTED]"` としてエクスポートされ、`sandbox.ignoreViolations` はコマンドパターンなしでそのパスリストのリストとしてエクスポートされます1449 * マップのエントリ名。`env` 変数名およびプラグイン ID など。そのまま発行。スキーマが入力をタイプしない設定。`vimInsertModeRemaps` など。単一の `"[REDACTED]"` として発行。`sandbox.ignoreViolations` は、コマンドパターンなしでパスリストのリストとして発行

1403 * リストはその長さを保持し、各エントリは同じルールでリダクションされます1450 * リストはその長さを保持。各エントリは同じルールで難読化

1404 * `permissions.allow`、`permissions.deny`、または `permissions.ask` ルールは、ツール名がこのバージョンの Claude Code に組み込まれている場合、またはそのツール名がリダクションされたコンテンツを持つ `mcp__` 参照（`mcp__jira__create_issue` など）である場合、そのツール名としてエクスポートされます。その他のルールは `"[REDACTED]"` としてエクスポートされます1451 * `permissions.allow`、`permissions.deny`、または `permissions.ask` ルールは、ツール名で発行。コンテンツは難読化。`Read([REDACTED])` など。ツールが Claude Code のこのバージョンに組み込まれているか、`mcp__jira__create_issue` などの `mcp__` 参照の場合。他のルールは `"[REDACTED]"` として発行

1405 * フックは同じルールに従うため、`type` および `timeout` などの固定オプションおよび数値フィールドが表示されます。各コマンド、URL、`matcher`、および `if` 条件は `"[REDACTED]"` としてエクスポートされます1452 * フックは同じルールに従う。`type` および `timeout` などの固定オプションおよび数値フィールドは表示。各コマンド、URL、`matcher`、`if` 条件は `"[REDACTED]"` として発行

~~1406~~ 1453

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

1408 1455

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

1410* `managed_settings.settings_truncated`（`managed_settings.settings` が存在する場合）: Claude Code が `managed_settings.settings` を 8 KB で切り詰めた場合は `true`。それ以外の場合は `false`。ブール値として発行。文字列ではなく1457* `managed_settings.settings_truncated`（`managed_settings.settings` が存在する場合）: Claude Code が `managed_settings.settings` を 8 KB で切り詰めた場合は `true`。それ以外の場合は `false`。ブール値として発行。文字列ではなく

1495 1542

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

1497 1544

1498MCP ツール呼び出し、Bash コマンド、ファイル編集は、セッションを開始した開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでの開発者の IdP ID です。1545開発者が開始したセッションでは、MCP ツール呼び出し、Bash コマンド、ファイル編集はその開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでの開発者の IdP ID です。Claude Tag チャネルセッションでは、Claude はあなたの組織の [共有 ID](/docs/ja/cloud-environments#set-the-environment-a-claude-tag-channel-uses) として機能します。

1499 1546

1500Claude Code が直接 API キーで認証する場合、または Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、`user.id` と `session.id` のみが入力されます。これらのデプロイメントでは、`OTEL_RESOURCE_ATTRIBUTES` を使用してユーザー ID を自分で添付し、[管理設定](#administrator-configuration) ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません：CLI は [標準属性](#standard-attributes) で説明されているように、IdP ID を自動的にスタンプします。1547Claude Code が直接 API キーで認証する場合、または Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、`user.id` と `session.id` のみが入力されます。これらのデプロイメントでは、`OTEL_RESOURCE_ATTRIBUTES` を使用してユーザー ID を自分で添付し、[管理設定](#administrator-configuration) ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません：CLI は [標準属性](#standard-attributes) で説明されているように、IdP ID を自動的にスタンプします。

1501 1548

1559}1606}

1560```1607```

1561 1608

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

1563 1610

1564<h2 id="backend-considerations">1611<h2 id="backend-considerations">

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

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

1621</h2>1668</h2>

1622 1669

1623* OpenTelemetry エクスポートをバックエンドに送信することはオプトインであり、明示的な設定が必要です。Anthropic の個別の運用テレメトリーと無効化方法については、[データ使用](/docs/ja/data-usage#telemetry-services)を参照してください1670* OpenTelemetry エクスポートをバックエンドに送信することはオプトインであり、明示的な設定が必要です。Anthropic の個別の運用テレメトリと無効化方法については、[データ使用](/docs/ja/data-usage#telemetry-services)を参照してください

1624* ファイルの生コンテンツとコードスニペットはメトリクスやイベントに含まれません。トレーススパンは別のデータパスです。以下の `OTEL_LOG_TOOL_CONTENT` の項目を参照してください1671* 生のファイルコンテンツとコードスニペットはメトリクスやイベントに含まれません。トレーススパンは別のデータパスです。以下の `OTEL_LOG_TOOL_CONTENT` の項目を参照してください

1625* OAuth 経由で認証されている場合、`user.email` はテレメトリー属性に含まれ、設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。これが組織にとって懸念事項である場合は、テレメトリーバックエンドと協力してこのフィールドをフィルタリングまたは編集してください1672* OAuth 経由で認証されている場合、`user.email` はテレメトリ属性に含まれ、設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。これが組織にとって懸念事項である場合は、テレメトリバックエンドと協力してこのフィールドをフィルタリングまたは編集してください

1626* ユーザープロンプトコンテンツはデフォルトでは収集されません。プロンプト長のみが記録されます。プロンプトコンテンツを含めるには、`OTEL_LOG_USER_PROMPTS=1` を設定してください。詳細なベータトレースでは、この変数はプロンプトテキストより広い範囲に達します。これは [`new_context` スパン属性](#new-context-gates)もゲートします。これは `claude_code.llm_request` スパンのツール結果を含みます1673* ユーザープロンプトコンテンツはデフォルトでは収集されません。プロンプト長のみが記録されます。プロンプトコンテンツを含めるには、`OTEL_LOG_USER_PROMPTS=1` を設定してください。詳細なベータトレースでは、この変数はプロンプトテキストよりも広い範囲に達します。これは [`new_context` スパン属性](#new-context-gates)もゲートします。これは `claude_code.llm_request` スパンのツール結果を含みます

1627* アシスタント応答テキストはデフォルトでは収集されません。応答長のみが記録されます。応答テキストを含めるには、`OTEL_LOG_ASSISTANT_RESPONSES=1` を設定してください。Claude Code からのすべての OpenTelemetry データと同様に、応答テキストは設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。この変数が設定されていない場合、`OTEL_LOG_USER_PROMPTS` がフォールバックとして使用されるため、プロンプトコンテンツなしで応答コンテンツが必要な場合は `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定してください1674* アシスタント応答テキストはデフォルトでは収集されません。応答長のみが記録されます。応答テキストを含めるには、`OTEL_LOG_ASSISTANT_RESPONSES=1` を設定してください。Claude Code からのすべての OpenTelemetry データと同様に、応答テキストは設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。この変数が設定されていない場合、`OTEL_LOG_USER_PROMPTS` がフォールバックとして使用されるため、プロンプトコンテンツなしで応答コンテンツが必要な場合は `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定してください

1628* ツール入力引数とパラメータはデフォルトではログに記録されません。これらを含めるには、`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 には送信されません。引数には機密値が含まれる可能性があるため、テレメトリーバックエンドを設定してこれらの属性をフィルタリングまたは編集してください。有効にすると：1675* ツール入力引数とパラメータはデフォルトではログに記録されません。これらを含めるには、`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 には送信されません。引数には機密値が含まれる可能性があるため、テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください。有効にすると：

1629 * `tool_result` と `tool_decision` イベントには、Bash コマンド、MCP サーバーとツール名、スキル名を含む `tool_parameters` 属性が含まれます。`full_command` などのフィールドは切り詰められずに出力されます1676 * `tool_result` と `tool_decision` イベントには、Bash コマンド、MCP サーバーとツール名、およびスキル名を含む `tool_parameters` 属性が含まれます。`full_command` などのフィールドは切り詰められずに出力されます

1630 * `tool_result` イベントには、ファイルパス、URL、検索パターン、その他の引数を含む `tool_input` 属性も含まれます。512 文字を超える個別の値は切り詰められ、合計は約 4 K 文字に制限されます1677 * `tool_result` イベントには、ファイルパス、URL、検索パターン、およびその他の引数を含む `tool_input` 属性も含まれます。512 文字を超える個別の値は切り詰められ、合計は約 4 K 文字に制限されます

1631 * `user_prompt` イベントには、カスタム、プラグイン、MCP コマンドの逐語的な `command_name` が含まれます1678 * `user_prompt` イベントには、カスタム、プラグイン、および MCP コマンドの逐語的な `command_name` が含まれます

1679 * [コストとトークンカウンター](#cost-counter)および `api_request`、`api_error`、および `api_refusal` イベントは、その属性の帰属に実際のエージェント、スキル、プラグイン、および MCP サーバーとツール名を含みます

1632 * トレーススパンには、同じ `tool_input` 属性と `file_path` などの入力派生属性が含まれ、`tool_input` と同じ切り詰めが行われます1680 * トレーススパンには、同じ `tool_input` 属性と `file_path` などの入力派生属性が含まれ、`tool_input` と同じ切り詰めが行われます

1633* ツールコンテンツはデフォルトではトレーススパンにログに記録されません。これを含めるには、`OTEL_LOG_TOOL_CONTENT=1` を設定してください。その後、`claude_code.tool` スパンは、ファイルの生コンテンツと Bash コマンド出力を含む [`tool.output` スパンイベント](#tool-output-span-event)を含みます。これは属性ごとのコンテンツ制限（デフォルトでは 60 KB）で切り詰められます。ツールコンテンツは [`new_context`](#new-context-gates) を通じてスパンに到達します。このゲートはスパンごとに異なります。テレメトリーバックエンドを設定してこれらの属性をフィルタリングまたは編集してください1681* ツールコンテンツはデフォルトではトレーススパンにログに記録されません。これを含めるには、`OTEL_LOG_TOOL_CONTENT=1` を設定してください。その後、`claude_code.tool` スパンは、生のファイルコンテンツ、Bash コマンド出力、および MCP ツール、WebFetch、WebSearch が返すものを含む [`tool.output` スパンイベント](#tool-output-span-event)を含みます。コンテンツは属性ごとにコンテンツ制限（デフォルトでは 60 KB）で切り詰められます。MCP ツール、WebFetch、WebSearch からの結果には Claude Code v2.1.283 以降が必要です。ツールコンテンツは [`new_context`](#new-context-gates) を通じてスパンに到達します。このゲートはスパンごとに異なります。テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください

1634* 生の Anthropic Messages API リクエストおよびレスポンスボディはデフォルトではログに記録されません。これらを含めるには、シェル、ユーザー設定、または管理設定で `OTEL_LOG_RAW_API_BODIES` を設定してください。これは [プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。ボディには、システムプロンプト、すべての以前のユーザーとアシスタントのターン、ツール結果を含む完全な会話履歴が含まれるため、これを有効にすることは、他の `OTEL_LOG_*` コンテンツフラグが明かすすべてのものへの同意を意味します。Claude Code は、他の設定に関係なく、これらのボディから Claude の拡張思考コンテンツを常に編集します。設定する値は、Claude Code がボディを配信する方法を決定します：1682* 生の Anthropic Messages API リクエストおよびレスポンスボディはデフォルトではログに記録されません。これらを含めるには、シェル、ユーザー設定、または管理設定で `OTEL_LOG_RAW_API_BODIES` を設定してください。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。ボディには、システムプロンプト、すべての以前のユーザーとアシスタントのターン、およびツール結果を含む完全な会話履歴が含まれるため、これを有効にすることは、他の `OTEL_LOG_*` コンテンツフラグが明かすすべてのことへの同意を意味します。Claude Code は、他の設定に関係なく、これらのボディから Claude の拡張思考コンテンツを常に編集します。設定する値は、Claude Code がボディを配信する方法を決定します：

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

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

1637 1685

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

1639 1687

1640<h2 id="monitor-claude-code-on-amazon-bedrock">1688<h2 id="monitor-claude-code-on-amazon-bedrock">

1641 Amazon Bedrock での Claude Code の監視1689 Amazon Bedrock での Claude Code の監視

monitoring-usage.md 2026-09-28 22:59 UTC to 2026-09-29 19:59 UTC

監視

クイックスタート

管理者設定

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

設定の詳細

一般的な設定変数

mTLS 認証

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

トレース（ベータ）

スパン階層

スパン属性

動的ヘッダー

設定の設定

スクリプト要件

リフレッシュ動作

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

設定例

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

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

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

標準属性

リポジトリ属性

メトリクス

メトリクスの詳細

セッションカウンター

コード行カウンター

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

コミットカウンター

コストカウンター

トークンカウンター

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

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

イベント

イベント相関属性

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

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

ツール結果イベント

API リクエストイベント

API エラーイベント

API 拒否イベント

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

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

ツール決定イベント

権限モード変更イベント

認証イベント

MCP サーバー接続イベント

内部エラーイベント

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

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

スキル有効化イベント

@ メンションイベント

API 再試行枯渇イベント

フック登録イベント

フック実行開始イベント

フック実行完了イベント

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

圧縮イベント

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

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

保持スイープイベント

管理設定解決イベント

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

使用状況監視

コスト監視

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

再試行枯渇の検出

イベント分析

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

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

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

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

SIEM にイベントを送信する

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

メトリクスの場合

イベント/ログの場合

トレースの場合

サービス情報

ROI 測定リソース

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