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

クイックスタート

環境変数を使用して OpenTelemetry を設定します:
メトリクスをエクスポートするセットアップを検証するには、バックエンドで 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 設定を設定できます。設定がどのように適用されるかについては、設定の優先順位を参照してください。 管理設定の設定例:
Claude Desktop アプリでは、Code タブセッションは各種 Desktop セッションに到達するソースからこれらの管理設定を読み込みます。管理コンソールのデータとプライバシー設定の監視下にある Cowork の OpenTelemetry フォームは Cowork セッションのみに適用されるため、ターミナル CLI も Code タブも、そこで設定したコレクターにはエクスポートしません。 Claude Code は、リポジトリの .claude/settings.json と .claude/settings.local.json の OpenTelemetry エクスポーター変数を無視するため、リポジトリはそれらを使用してテレメトリをオンにしたり、送信先を選択したり、コンテンツをキャプチャしたりすることはできません。管理設定で設定するか、各開発者がシェルまたは ~/.claude/settings.json で設定してください。リポジトリは、OTEL_LOGS_EXPORTER などのエクスポーターセレクターを none に設定することでシグナルをオフにすることはできますが、管理設定、--settings ファイル、または Claude Code を起動する環境がその変数を設定している場合を除きます。 Claude Code は、Bash ツール、フック、MCP サーバー、言語サーバーを含む、生成するサブプロセスに OTEL_* 環境変数を渡しません。OpenTelemetry でインストルメント化されたアプリケーションを Bash ツール経由で実行する場合、Claude Code のエクスポーターエンドポイントまたはヘッダーを継承しないため、そのアプリケーションが独自のテレメトリをエクスポートする必要がある場合は、コマンド内でこれらの変数を直接設定してください。

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

管理設定で OTEL_EXPORTER_OTLP_* 変数を設定すると、Claude Code は起動時に競合する開発者設定の変数を削除し、デバッグログに警告をログに記録します。削除される内容は、設定する変数によって異なります:
  • エンドポイント:OTEL_EXPORTER_OTLP_ENDPOINT を設定すると、Claude Code はすべての開発者設定のシグナル別エンドポイントを削除します。開発者は 1 つのシグナルを別のコレクターにポイントできないため、管理設定でシグナル別エンドポイント変数も設定する必要はありません。
  • プロトコル:OTEL_EXPORTER_OTLP_PROTOCOL を設定すると、Claude Code はすべての開発者設定のシグナル別プロトコルを削除します。
  • 認証情報:OTEL_EXPORTER_OTLP_HEADERS、OTEL_EXPORTER_OTLP_CLIENT_KEY、または OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE を設定すると、Claude Code はその変数の開発者設定のシグナル別バージョンと、すべての開発者設定のエンドポイント変数(汎用またはシグナル別)を削除します。これらの認証情報が管理設定で選択されていないコレクターに到達するのを防ぐためです。
  • エクスポーターセレクター:OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER、およびベータ版の OTEL_TRACES_EXPORTER は通常のキーごとの優先順位に従います。開発者の設定はシグナルを無効にするか、コンソールエクスポーターに切り替えることができるため、ロックが必要な場合は管理設定でセレクターも設定してください。管理ソース全体で、OTEL_LOGS_EXPORTER はテレメトリユニットに従い、他の 2 つのセレクターはキーごとにマージされます。Claude Code v2.1.223 以降が必要です。
  • ベータ版トレーシングエンドポイント:詳細ベータ版トレーシングがアクティブな場合、Claude Code はログとトレースをログおよびトレースエクスポーターを通じてではなく BETA_TRACING_ENDPOINT にエクスポートします。したがって、Claude Code は以下の管理設定のいずれかがシグナルの宛先を決定するたびに、開発者設定の BETA_TRACING_ENDPOINT を削除します:
    • 汎用またはログ/トレースエンドポイントまたは認証情報
    • otelHeadersHelper
    • none、console、または空に設定されたログまたはトレースエクスポーターセレクター。これらの値はシグナルをコレクターから外します
    • CLAUDE_CODE_ENABLE_TELEMETRY がオフ
    メトリクスのみのエンドポイントまたは認証情報は削除しません。v2.1.251 より前では、開発者設定の BETA_TRACING_ENDPOINT は、管理設定がコレクターをピン留めしている場合でも、詳細ベータ版トレーシングがエクスポートするログとトレースをリダイレクトしていました。
Claude Code は管理設定自体で設定したシグナル別変数を削除しないため、その変数をそこに設定することで 1 つのシグナルを別のコレクターにルーティングできます。SIEM の例がこれを行っています。そこでシグナル別認証情報を設定する場合、Claude Code はそのシグナルの開発者設定エンドポイントを削除します。 この削除動作は、テレメトリが配信される場所を変更するもので、Claude Code が収集する内容ではありません。 v2.1.217 より前では、すべての変数は独立してキーごとの設定優先順位に従っていたため、ユーザー設定またはシェルで設定されたシグナル固有のエンドポイントがそのシグナルを管理コレクターから離れた場所にリダイレクトしていました。 デスクトップアプリまたはセルフホスト環境ランナーが Claude Code を起動し、提供する環境で OTLP エンドポイントを指定する場合、Claude Code は同じ方法で宛先をピン留めします。ランナーのテレメトリ変数は、管理設定と同じように開発者設定の変数を削除します。Claude Code はランナー自体が設定した変数を削除しません。Claude Code v2.1.251 以降が必要です。

設定の詳細

共通の設定変数

これらの変数は、すべてのデプロイに共通するエクスポーター、エンドポイント、エクスポート動作を設定します。 OTEL_EXPORTER_OTLP_METRICS_ENDPOINT のようなシグナルごとのエンドポイント変数またはプロトコル変数を設定すると、Claude Code はそのシグナルについて汎用の変数の代わりにそれを使用します。OTEL_EXPORTER_OTLP_METRICS_HEADERS のようなシグナルごとのヘッダー変数を設定すると、Claude Code はそのシグナルについて汎用の OTEL_EXPORTER_OTLP_HEADERS とマージします。 管理設定があるマシンで Claude Code が何を削除するかについては、管理設定が OTLP の送信先をロックする仕組みを参照してください。 http/protobuf および http/json プロトコルでは、Claude Code は各エクスポートリクエストを Content-Length ヘッダー付きで送信します。

mTLS 認証

OTLP エクスポーターのクライアント証明書の設定方法は、そのシグナルで使用される OTLP プロトコル(OTEL_EXPORTER_OTLP_PROTOCOL またはシグナルごとの上書きで設定)によって異なります。同じ設定がメトリクス、ログ、トレースに適用されます。 grpc の場合、OpenTelemetry SDK が標準の OTLP 変数を直接読み取るため、シグナルごとのメトリクス変数を設定している既存の設定はそのまま動作します。管理設定があるマシンでは、Claude Code は起動時に開発者が設定したシグナルごとの認証情報とエンドポイントを削除する場合があります。

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

以下の環境変数は、カーディナリティを管理するためにメトリクスとイベントに含める属性を制御します。 一般に、カーディナリティが低いほどパフォーマンスが向上しストレージコストが下がりますが、分析用のデータの粒度は粗くなります。

トレース(ベータ)

分散トレースは、各ユーザープロンプトと、それによってトリガーされる API リクエストおよびツール実行を結び付けるスパンをエクスポートするため、トレースバックエンドで 1 つのリクエスト全体を単一のトレースとして確認できます。 トレースはデフォルトでオフです。有効にするには、CLAUDE_CODE_ENABLE_TELEMETRY=1 と CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 の両方を設定し、OTEL_TRACES_EXPORTER を設定してスパンの送信先を選択します。トレースは、エンドポイント、プロトコル、ヘッダー、mTLS について共通の OTLP 設定を再利用します。管理設定があるマシンでは、Claude Code は起動時に開発者が設定したシグナルごとの認証情報とエンドポイントを削除する場合があります。 スパンでは、ユーザープロンプトのテキスト、ツール入力の詳細、ツールコンテンツがデフォルトで編集(秘匿)されます。これらを含めるには、OTEL_LOG_USER_PROMPTS=1、OTEL_LOG_TOOL_DETAILS=1、OTEL_LOG_TOOL_CONTENT=1 を設定します。 トレースが有効な場合、Bash と PowerShell のサブプロセスは、アクティブなツール実行スパンの W3C トレースコンテキストを含む TRACEPARENT 環境変数を自動的に継承します。これにより、TRACEPARENT を読み取るサブプロセスは自身のスパンを同じトレースの下に親付けでき、Claude が実行するスクリプトやコマンドを通じたエンドツーエンドの分散トレースが可能になります。 トレースが有効で、Claude Code が Anthropic API に直接接続されている場合、各モデルリクエストには claude_code.llm_request スパンのコンテキストに設定された W3C traceparent ヘッダーが付与され、API の traceresponse ヘッダーはスパンリンクとして記録されます。これらを組み合わせることで、準拠した中継サーバーを経由しても、Claude Code のクライアント側スパンがサーバー側のトレースに接続されます。送信される HTTP MCP リクエストにも同様に traceparent が付与されます。このヘッダーはサードパーティのプロバイダーには送信されません。 一部のプロキシは認識できないヘッダーを拒否するため、デフォルトでは、モデルリクエストと HTTP MCP リクエストの traceparent ヘッダーは、ANTHROPIC_BASE_URL が未設定であるか Anthropic API を指している場合にのみ送信されます。一貫性のため、サブプロセスの TRACEPARENT 変数も同じスイッチで制御されます。カスタムの ANTHROPIC_BASE_URL プロキシを介して Claude Code を実行していて、トレースコンテキストを伝播させたい場合は、CLAUDE_CODE_PROPAGATE_TRACEPARENT=1 を設定してください。 Agent SDK および -p で開始した非対話型セッションでは、Claude Code は各インタラクションスパンの開始時に、自身の環境から TRACEPARENT と TRACESTATE も読み取ります。これにより、埋め込み側のプロセスがアクティブな W3C トレースコンテキストをサブプロセスに渡し、Claude Code のスパンを呼び出し元の分散トレースの子として表示させることができます。対話型セッションでは、CI やコンテナ環境の周囲の値を誤って継承しないよう、受信した TRACEPARENT は無視されます。 受信したトレースコンテキストはイベントにも適用されます。TRACEPARENT が設定された Agent SDK および -p セッションでは、トレースエクスポーターが設定されていない場合でも、各 OTLP イベントログレコードにアプリケーションのトレースと結び付ける trace_id と span_id の値が付与されるため、ログバックエンドでイベントをトレースの他の部分と関連付けることができます。 インタラクションがアクティブな間に出力されたレコードには、Claude Code がスパンの非同期コンテキストの外で出力した場合(権限プロンプトのコールバック内や、起動中にバッファリングされて後でエクスポートされたレコードなど)でも、インタラクションスパンの ID が付与されます。アクティブなインタラクションスパンがない状態で出力されたレコードには、受信した TRACEPARENT の ID が直接付与されます。

スパンの階層

各ユーザープロンプトは claude_code.interaction ルートスパンを開始します。API 呼び出し、ツール呼び出し、フックの実行は、その子として記録されます。ツールスパンには独自の子スパンが 2 つあります。1 つは権限の決定を待つ時間、もう 1 つは実行自体の時間です。Agent ツールまたはレガシーの Task ツールがサブエージェントを起動すると、サブエージェントの API スパンとツールスパンは親の claude_code.tool スパンの下にネストされます。
Agent SDK および claude -p セッションでは、環境に TRACEPARENT が設定されている場合、claude_code.interaction 自体が呼び出し元のスパンの子になります。 PreToolUse フックがツール呼び出しを延期すると、Claude Code は延期したターンのトレースコンテキストを保存します。セッションを再開してツールが再実行されると、そのツールのスパンは以前のターンのトレースに、そのターンの claude_code.interaction スパンの子として加わります。

スパン属性

すべてのスパンには、標準属性に加えて、スパン名と一致する span.type 属性が付与されます。以下の表は、各スパンに設定される追加の属性を示しています。llm_request、tool.execution、hook スパンは、失敗を記録した場合に OpenTelemetry のステータス ERROR を設定します。その他のスパンは常にステータス UNSET で終了します。 claude_code.interaction claude_code.llm_request 各再試行は、attempt 属性と client_request_id 属性を持つ gen_ai.request.attempt スパンイベントとしても記録されます。 claude_code.tool claude_code.tool の tool.output スパンイベント OTEL_LOG_TOOL_CONTENT=1 を設定すると、Read と Bash の呼び出しで claude_code.tool スパンに tool.output スパンイベントを記録できます。Edit と Write の呼び出しでは、OTEL_LOG_TOOL_DETAILS=1 も設定した場合にのみ記録されます。この変数はこれら 2 つのツールに限定されないため、他の箇所で追加される引数については設定テーブルの該当行を確認してください。 MCP ツール、WebFetch、WebSearch も、Claude Code v2.1.283 以降ではこのイベントを記録します。 Claude Code はツール呼び出しが正常に戻ったときにこのイベントを書き込むため、エラーを発生させた呼び出しは、ツールにかかわらず何も記録しません。正常に戻った呼び出しのうち、次の場合は tool.output イベントを記録しません。
  • Read、Edit、Write、Bash、WebFetch、WebSearch、MCP ツール以外のツールの呼び出し
  • ファイルのテキスト以外を返す Read(画像、PDF、内容が変更されていないファイルの再読み込みなど)
  • OTEL_LOG_TOOL_DETAILS=1 も設定していない場合の Edit または Write の呼び出し
  • 待機中のメッセージが Claude に届くよう、実行中に Claude Code がバックグラウンドに移した WebFetch または WebSearch の呼び出し。後から届く結果も記録されません。Claude Code が呼び出しを移すタイミングについては、ターミナルの場合はキューに入れた内容を Claude Code が送信するタイミングを、Agent SDK セッションの場合は priority フィールドを参照してください
このイベントには以下の属性が付与され、それぞれコンテンツ上限(デフォルトで 60 KB)で切り詰められます。ゲートは OTEL_LOG_TOOL_CONTENT=1 に加えて属性に必要な変数を示します。Edit と Write については、その変数は属性ではなくイベント自体のゲートとなります。 親スパンの tool_name 属性で、イベントがどのツールから来たかがわかります。コンテンツ上限で切り詰められた属性には、<attribute>_truncated と <attribute>_original_length が付随します。 claude_code.tool.blocked_on_user source が user_abort である cancelled の決定は、権限プロンプトまたは auto モードのチェックが保留中の間に、即時配信が必要なメッセージがターンを中断したことを意味します。たとえば、auto モードのチェック中に、ユーザーがキューに入れていたメッセージをすぐに送信した場合です。 claude_code.tool.execution claude_code.hook このスパンは詳細ベータトレースが有効な場合にのみ表示されます。詳細ベータトレースには ENABLE_BETA_TRACING_DETAILED=1 と BETA_TRACING_ENDPOINT が必要で、この組み合わせはログとトレースの送信先も変更します。この組み合わせは、シェル、ユーザー設定、または管理設定で設定してください。どちらの変数もプロジェクト設定とローカル設定では無視されます。CLAUDE_CODE_ENHANCED_TELEMETRY_BETA だけではこのスパンは生成されません。 対話型 CLI セッションでは、詳細ベータトレースには、組織がこの機能の許可リストに登録されていることも必要です。Agent SDK および非対話型の -p セッションでは、許可リストへの登録は不要です。
ENABLE_BETA_TRACING_DETAILED はデバッグ目的でのみ設定し、本番環境では設定しないでください。詳細ベータトレースはエクスポート量が多く、そのコンテンツ属性は安定したスパンスキーマには含まれません。
詳細ベータトレースでのコンテンツ属性
new_context、system_reminders、system_prompt_preview、user_system_prompt、tool_input、response.model_output など、コンテンツを保持する追加の属性は、詳細ベータトレースが有効な場合にのみ出力されます。これらは安定したスパンスキーマには含まれません。
これらの属性は以下のスパンに付与され、ゲートは詳細ベータトレースに加えて属性に必要な変数を示します。コンテンツ上限(デフォルトで 60 KB)を超える値は切り詰められます。 詳細ベータトレースで OTEL_LOG_USER_PROMPTS=1 を設定している場合、Claude Code は完全なシステムプロンプトを保持する claude_code.system_prompt イベントも出力します。このシステムプロンプトはコンテンツ上限で切り詰められます。このイベントは、セッションが個々の異なるシステムプロンプトを初めて送信したときに届き、コンテキスト圧縮の後にも再度届きます。

動的ヘッダー

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

設定

.claude/settings.json に以下を追加し、パスを独自のスクリプトに置き換えます。
値には、実行可能ファイルへのパス(スペースを含むパスも可)、または引数付きのシェルコマンドラインを指定できます。Windows では値は常にシェルを介して実行されるため、スペースを含むパスは JSON 値内で引用符で囲んでください。

スクリプトの要件

スクリプトは、HTTP ヘッダーを表す文字列のキーと値のペアを含む有効な JSON を出力する必要があります。
ヘルパーが失敗するか、これらの要件を満たさない出力を表示した場合、エクスポートは失敗し、ヘルパーが再び動作するまでテレメトリバックエンドはそのセッションから何も受信しません。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 環境変数を使用してカスタム属性を追加し、異なるグループを区別できます。
これらのカスタム属性はすべてのメトリクスとイベントに含まれるため、次のことが可能になります。
  • チームまたは部門でメトリクスをフィルタリングする
  • コストセンターごとにコストを追跡する
  • チーム固有のダッシュボードを作成する
  • 特定のチーム向けのアラートを設定する
Claude Code は、これらの値を OTLP リソースブロックで送信するだけでなく、すべてのメトリクスのデータポイントとイベントレコードに属性として付与します。ほとんどのメトリクスバックエンドはデータポイントの属性をクエリ可能なラベルとして公開するため、カスタムキーでメトリクスを直接グループ化およびフィルタリングできます。vcs.* リポジトリ属性を除き、カスタムキーが user.id や session.id などの標準属性を上書きすることはありません。キーが衝突した場合、Claude Code は組み込みの値を保持します。 各カスタムキーはすべてのメトリクス系列のラベルになるため、カーディナリティの高い値はメトリクスバックエンドのストレージコストを増加させます。カスタム属性をリソースブロックでのみ送信し、データポイントのラベルから除外するには、OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false を設定します。メトリクスのカーディナリティ制御を参照してください。
OTEL_RESOURCE_ATTRIBUTES 環境変数は、厳密なフォーマット要件を持つカンマ区切りの key=value ペアを使用します。
  • スペース不可: 値にスペースを含めることはできません。たとえば、user.organizationName=My Company は無効です
  • フォーマット: カンマ区切りの key=value ペアである必要があります: key1=value1,key2=value2
  • 使用可能な文字: 制御文字、空白、二重引用符、カンマ、セミコロン、バックスラッシュを除く US-ASCII 文字のみ
  • 特殊文字: 使用可能な範囲外の文字はパーセントエンコードする必要があり、値の中の = は %3D と記述する必要があります
スペースが必要な値には、代わりにアンダースコアまたはキャメルケースを使用してください。以下の例では、それぞれの形式で org.name を設定しています。
除外された文字に限らず、任意の文字をパーセントエンコードできます。この例では、スペースとアポストロフィの両方をエンコードしています。
値を引用符で囲んでもスペースはエスケープされません。たとえば、org.name="My Company" は My Company ではなく、引用符を含むリテラル値 "My Company" になります。

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

Desktop SSH セッションがどのリモートマシンで実行されたかを確認するには、カスタム属性で各マシンに名前を付けます。メトリクスとイベントには、セッションが実行されたマシンの名前は含まれません。 各リモートマシンで、セッションが読み取る管理設定ファイル内の、テレメトリをオンにする env ブロックに OTEL_RESOURCE_ATTRIBUTES を追加します。名前は各マシンのファイルに直接書き込んでください。Claude Code は値を展開しないため、host.name=$(hostname) はその文字列のまま届きます。 次の例では、マシンに build-7 という名前を付けています。
他にこの変数を設定するものがない場合、host.name は、Desktop SSH セッションでもそのマシン上の CLI でも、リソースブロックに含まれて届きます。カスタム属性が他にどこに表示されるかについては、複数チームの組織のサポートを参照してください。 名前が届かない場合は、次のいずれかの原因を確認してください。
  • Desktop を実行しているコンピューターで設定した: Desktop は、そこで設定した値を SSH セッションに渡しません
  • /etc/profile など、ログインシェルのみが読み取るファイルでエクスポートした: ログインシェルから claude を実行した場合は名前が届きますが、Desktop SSH セッションでは届きません。Desktop はログインシェル経由で Claude Code を起動しません。代わりに、リモートマシン上の管理設定ファイルの env で変数を設定してください。
  • 値の中にスペースが含まれている: この場合、Claude Code はどのキーもイベントやデータポイントにコピーしません。どの値にスペースが含まれているかを確認するには、リモートマシン上のセッションで /status を実行してください。値からスペースを取り除いてください。
  • 他の何かがすでにこの変数を設定している: デスクトップアプリが開始するセッションでは、起動環境ですでに設定されている変数が設定ファイルより優先されます。デバッグログで、無視された変数の名前を確認できる場合があります。サードパーティの Desktop デプロイが、提供する環境で OTLP エンドポイントを指定している場合、その環境には Desktop 独自の OTEL_RESOURCE_ATTRIBUTES が含まれます。

設定例

claude を実行する前に、これらの環境変数を設定してください。以下の各シナリオは完全な設定を示しており、各変数は共通の設定変数で説明しています。設定が反映されたことを確認するには、セッションを開始した後にバックエンドで claude_code.session.count メトリクスを確認してください。ログのみの検証方法と、何も届かない場合の確認事項についてはクイックスタートで説明しています。 エクスポート間隔 1 秒でのコンソールデバッグの場合:
gRPC 経由の OTLP の場合:
http://localhost:9464/metrics からスクレイプする Prometheus の場合:
セルフホスト環境では、セッションがポート 9464 をバインドするのは、ランナーのキャパシティがデフォルトの 1 の場合のみです。キャパシティがそれより大きい場合、ランナーは代わりにセッションのカウンターとゲージを自身の /metrics エンドポイントで再公開します。 メトリクスを複数のエクスポーターに送信するには:
メトリクスとログを異なるエンドポイントまたはバックエンドに送信するには:
イベントやログなしでメトリクスのみをエクスポートするには:
メトリクスなしでイベントとログのみをエクスポートするには:

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

クラウドセッション(Claude Tag チャネルセッションを含む)は、ユーザーのデバイス上ではなく クラウド環境 で実行されるため、これらのデバイス上の管理設定ファイルまたはシェルプロファイルではテレメトリを設定できません。Anthropic ホスト環境のセッションの場合、このセクションではテレメトリ変数を設定する場所、コレクターを環境から到達可能にする方法、およびエクスポートされたデータでクラウドセッションと Claude Tag セッションを区別する方法について説明します。 これらのセッションからテレメトリをエクスポートするには、管理者設定 の例と同じキーを使用して、CLAUDE_CODE_ENABLE_TELEMETRY と OTEL_* 変数を次の 2 つの場所のいずれかに設定します。
  • サーバー管理設定: 組織の サーバー管理設定 の env ブロックに追加します。Claude Code は サーバー管理設定が適用される 場所(ユーザーのマシンと Claude Tag チャネルセッション以外のクラウドセッションを含む)で起動時にこれらの設定を取得します。Claude Tag セッションはサーバー管理設定を受け取らないため、このルートではそれらを設定できません。
  • 環境の変数: クラウド環境の 環境変数 に追加して、その環境で実行されるセッションのみを設定します。これは Claude Tag セッションに到達するルートです。
環境を使用する誰もがその変数を読み取ることができるため、OTEL_EXPORTER_OTLP_HEADERS のコレクタートークンなどの認証情報をそこに配置しないでください。環境の ネットワークシークレット も役に立ちません。Claude Code 独自のテレメトリエクスポートは、シークレットを取得しないリクエスト の 1 つだからです。コレクターが認証情報を必要とする場合は、代わりにサーバー管理設定を通じてエクスポート全体を設定してください。認証情報をそこに設定すると、Claude Code は管理設定外で設定されたエンドポイント変数を削除します。 クラウドセッションのテレメトリを設定する際は、これらの制約を念頭に置いてください。
  • セッションがコレクターに到達できるようにする: Claude Code はセッションのネットワークを通じてエクスポートを送信するため、OTEL_EXPORTER_OTLP_ENDPOINT のホストに到達できるかどうかは、環境の ネットワークアクセスレベル によって異なります。セッションが選択したレベルでコレクターのドメインに到達できない場合は、ドメインを環境のアローリストに追加してください。サーバー管理設定はドメインを環境のネットワークアローリストに追加しないためです。
  • Claude Tag チャネル: 組織のデフォルトとして設定されている、またはチャネルにピン留めされている 共有環境 で、許可リストと環境変数の変更を行ってください。
  • Cowork は個別に設定されます: サーフェスカバレッジテーブル に示されているように、Cowork セッションはサーバー管理設定を受け取らないため、サーバー管理 env ブロックはそれらのテレメトリを設定しません。

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

デフォルトでは、クラウドセッションからのメトリクスとイベントは、session.id、ccr.session.id、organization.id を含む 標準属性 を含むため、追加の設定なしでセッションまたは組織でフィルタリングできます。ccr.session.id の値はセッションの CLAUDE_CODE_REMOTE_SESSION_ID です。これをセッションのトランスクリプト URL に変換するには、出力をセッションにリンク戻す を参照してください。 クラウドセッションを区別するには、session.id ではなく ccr.session.id でグループ化またはフィルタリングしてください。 テレメトリをより詳細に属性付けするには、これらのオプションを使用します。
  • Claude Tag セッションを識別する: メトリクスカーディナリティ制御 で説明されているように、OTEL_METRICS_INCLUDE_ENTRYPOINT=true を設定します。メトリクスとイベントは app.entrypoint を含むようになり、Claude Tag セッションの値は claude-in-slack です。
  • カスタム属性を追加する: これらのセッションの他の OTEL_* 変数を設定する場所と同じ場所に OTEL_RESOURCE_ATTRIBUTES を設定します。代わりに環境の セットアップスクリプト でそれを export する場合、値は Claude Code に到達しません。セットアップスクリプトは Claude Code が起動する前に実行される別の Bash スクリプトであり、それがエクスポートする変数はそれで終わります。
Claude Tag チャネルセッションでは、Claude はメンバーではなく組織の 共有 ID として機能するため、user.* 属性に依存して Claude にタグを付けたユーザーを識別しないでください。

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

標準属性

すべてのメトリクスとイベントは、次の標準属性を共有します: /login を通じて Claude apps gateway にサインインしたセッションでは、CLI はエクスポートに認証済みの ID を付与します。user.id は IdP のサブジェクト、user.email はサインインしたメールアドレスで、user.groups は IdP のグループメンバーシップをカンマ区切りの文字列として保持します。各エクスポートには identity.source: gateway-oidc も含まれます。ゲートウェイの ID は最後に適用されるため、これらのセッションでは OTEL_RESOURCE_ATTRIBUTES で設定した user.* および identity.* キーは無視されます。
開発者がサインインする前に Claude Code がログに記録するイベントには、ゲートウェイの ID は含まれません。Claude Code がゲートウェイからサインアウトした状態でセッションを開いた場合(たとえばゲートウェイがサインインを終了した後)、サインイン前に記録された起動イベントには匿名の user.id が含まれ、identity.source は含まれません。これらのイベントには managed_settings_resolved、plugin_loaded、mcp_server_connection が含まれます。
ゲートウェイ経由で接続する Claude Desktop および Cowork セッションの ID 属性については、ゲートウェイの telemetry リファレンスを参照してください。 イベントには、さらに次の属性が含まれます。これらはカーディナリティの無制限な増大を引き起こすため、メトリクスには付与されません:
  • prompt.id: ユーザープロンプトと、次のプロンプトまでに続くすべてのイベントを関連付ける UUID。イベント相関属性を参照してください。
  • workspace.host_paths: デスクトップアプリで選択されたホストのワークスペースディレクトリ(文字列配列)
  • workflow.run_id: Workflow ツールの実行に属するエージェントが発行する API イベントとツールイベントに付与される、wf_ プレフィックス付きの実行識別子。1 つの workflow.run_id でイベントをフィルタリングすると、その実行の API リクエストとツール結果を再構築できます。この識別子は、ワークフロースクリプトが生成するエージェントと、それらがさらに生成するエージェント(スキル呼び出しなど)を対象とします。Workflow ツールの結果で報告される実行識別子と一致します。
  • workflow.name: ワークフローの名前(スクリプトの meta.name)。workflow.run_id とともに出力されます。変更されていない組み込みスクリプトを実行した場合、組み込みワークフロー名はそのまま表示されます。組み込みスクリプトを編集したコピーを含むユーザー作成の名前は、OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り custom に置き換えられます。
  • agent_id: イベントを発生させたサブエージェントの識別子(例: a3f2c1b4d5e6f7a80)。これを含むイベントには、サブエージェントの API イベントとツールイベント、その assistant_response イベント、および完了したサブエージェントの subagent_completed があります。メインセッションおよびインプロセスのチームメイトのイベントには含まれません。サブエージェントのスパンの agent_id は同じ値か、acompact-3f2c1b4d5e6f7a80 のように先頭の a の後にラベルを追加した値です。Claude Code v2.1.310 以降が必要です
  • parent_agent_id: イベントを発生させたサブエージェントを生成した、または最後に再開したエージェントの agent_id。そのエージェントがメインセッションの場合は含まれません。Claude Code v2.1.310 以降が必要です

リポジトリ属性

OTEL_METRICS_INCLUDE_REPOSITORY=true を設定すると、メトリクスとイベントにセッションのリポジトリの識別情報がタグ付けされ、共有コレクターで使用状況をリポジトリごとに帰属させられるようになります。Claude Code v2.1.269 以降が必要です。 Claude Code は、これらの属性をリポジトリの origin リモートからセッションごとに 1 回導出します。GitHub、GitLab、Bitbucket Cloud のように、リポジトリの HTTPS リモートと SSH リモートが同じホストと同じパスを指している場合、どちらからも同一の値が得られます: 値は小文字に変換され、リモート URL に含まれる認証情報、クエリ文字列、フラグメントが値に現れることはありません。セッションに origin リモートがない場合、リモートが URL 形式でない場合、またはそれを囲む唯一のリポジトリがホームディレクトリである場合、これらの属性は省略されます。 クラウドセッションからこれらの属性を取得するには、OTEL_METRICS_INCLUDE_REPOSITORY を含むテレメトリ変数をそのクラウド環境に設定します。また、環境のネットワークアクセスでコレクターのドメインを許可してください。 OTEL_RESOURCE_ATTRIBUTES で宣言した vcs.* キーは、そのキーの導出値を置き換えます。vcs.repository.url.full を宣言した場合、Claude Code はリモートを一切読み取らず、宣言したキーのみを報告します。 1 つのリポジトリの HTTPS クローンと SSH クローンで異なる値が報告される場合(HTTPS のクローン URL に SSH の URL にはないパスプレフィックスが含まれるセルフホスト環境など)、報告したい他のすべての vcs.* キーとともに vcs.repository.url.full を OTEL_RESOURCE_ATTRIBUTES で宣言してください。これにより、すべてのクローンが宣言した識別情報を報告するようになります。 これらの属性は独自のエクスポーターにのみ送られます。Anthropic のテレメトリはすべての vcs.* キーを破棄します。

メトリクス

Claude Code は次のメトリクスをエクスポートします。単位列には、各メトリクスに付与される OpenTelemetry の単位文字列が表示されます。カウントメトリクスには単位はありません。 OTEL_METRICS_EXPORTER に記載されたエクスポーターが prometheus のみの場合、スクレイプが有効な Prometheus テキスト形式に保たれるよう、Claude Code はエクスポートされるメトリクスから USD、tokens、s の単位を省略します。メトリクス名は変わらず、otlp,prometheus のようにエクスポーターを組み合わせた設定では単位が保持されます。

メトリクスの詳細

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

セッションカウンター

各セッションの開始時に増加します。代わりに人数をカウントする場合は、使用状況の監視を参照してください。 属性:
  • すべての標準属性
  • start_type: セッションの開始方法。"fresh"、"resume"、"continue"、"agents_view" のいずれかです。"agents_view" の値は claude agents ダッシュボードプロセスを示します。これは会話セッションではなく、ユーザーが起動するローカル UI です。ダッシュボードで UI プロセスの起動と会話セッションを区別するには、この値でフィルタリングしてください。

コード行数カウンター

コードが追加または削除されたときに増加します。 属性:
  • すべての標準属性
  • type: ("added"、"removed")
  • model: 変更を行ったモデルのモデル識別子(例: “claude-sonnet-5”)

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

Claude Code がシェルコマンドまたは MCP ツールを通じてプルリクエストまたはマージリクエストを作成したときに増加します。 属性:

コミットカウンター

Claude Code を介して git コミットを作成したときに増加します。 属性:

コストカウンター

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

トークンカウンター

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

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

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

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

アイドル時間を除いた、Claude Code を実際にアクティブに使用した時間を追跡します。このメトリクスは、入力や応答の閲覧などのユーザー操作中と、ツールの実行や AI の応答生成などの CLI 処理中に増加します。 属性:
  • すべての標準属性
  • type: キーボード操作の場合は "user"、ツールの実行と AI の応答の場合は "cli"

イベント

Claude Code は、OpenTelemetry の logs/events を介して次のイベントをエクスポートします(OTEL_LOGS_EXPORTER が設定されている場合):

イベント相関属性

ユーザーがプロンプトを送信すると、Claude Code は複数の API 呼び出しを行い、複数のツールを実行することがあります。prompt.id 属性を使用すると、これらすべてのイベントを、それらをトリガーした単一のプロンプトに結び付けられます。 単一のプロンプトによってトリガーされたすべてのアクティビティを追跡するには、特定の prompt.id の値でイベントをフィルタリングします。これにより、そのプロンプトの処理中に発生した user_prompt イベント、すべての api_request イベント、およびすべての tool_result イベントが返されます。 event.sequence は Claude Code プロセスが開始するたびに 0 から始まり、そのプロセスが存続する間カウントアップされます。新しい session.id を割り当てる /clear をまたいでもカウントは継続します。フォークせずにセッションを再開した場合、セッションは session.id を維持しますが、event.sequence の値は再開したプロセスから取得されるため、1 つのセッション内で後のイベントが前のイベントより小さい値を持ったり、同じ値が繰り返されたりすることがあります。セッションのイベントを順序付けるには、event.timestamp で並べ替え、タイムスタンプが同じイベントの順序付けに event.sequence を使用してください。 メッセージレベルで再構築するために、各イベントクラスはセッションのトランスクリプトのフィールドと一致するキーを持っています。トランスクリプトのエントリ形式は Claude Code の内部仕様であり、バージョン間で変更されるため、これらのフィールドで結合するパイプラインはどのリリースでも壊れる可能性があります。これらの結合は安定した契約ではなく、バージョン固有のものとして扱ってください:
  • user_prompt、assistant_response、api_response_body の message.uuid
  • API イベントの request_id。トランスクリプトのアシスタントエントリには requestId として保存されます
  • tool_result および tool_decision イベントの tool_use_id。safety_event イベントにも含まれますが、ターンの終了に関するものは除きます

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

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

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

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

ツール結果イベント

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

API リクエストイベント

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

API エラーイベント

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

API 拒否イベント

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

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

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

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

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

ツール決定イベント

ツールの権限決定(承認/拒否)が行われたときに記録されます。 イベント名: claude_code.tool_decision 属性:
  • すべての標準属性
  • event.name: "tool_decision"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
  • tool_name: ツールの名前(例: “Read”、“Edit”、“Write”、“NotebookEdit”)
  • tool_use_id: このツール呼び出しの一意の識別子。フックに渡される tool_use_id と一致し、OTel イベントとフックが取得したデータを関連付けられます。
  • request_id: このツール呼び出しを含んでいた API レスポンスの request_id。これにより、呼び出しをそのレスポンスの API イベントと結合できます。そのレスポンスにリクエスト ID がなかった場合、またはその呼び出しを含む API レスポンスがなかった場合は含まれません。Claude Code v2.1.310 以降が必要です
  • decision: "accept" または "reject"
  • tool_source: 常に含まれます。ツールの出所で、CLI が定める値の閉じた集合です:
    • "builtin": CLI 自身のツール
    • "mcp": MCP サーバー全般
    • "sdk_host_builtin_mcp": Claude Desktop が所有するセッションにおける、Claude Desktop 自体に組み込まれたインプロセスサーバー。Claude Desktop は、自身のエントリポイントである claude-desktop、claude-desktop-3p、local-agent のいずれかから開始したセッションを、そのセッションがネストされた子でない場合に所有します。Claude Code 自体が生成するセッションを含むネストされたセッションでは、これらのサーバーは "mcp" として報告されます
  • source: 決定の出所:
    • "config": プロンプトを表示せずに、次のいずれかのソースによって自動的に決定されたもの:
      • プロジェクト設定
      • ユーザーの個人設定の許可ルールまたは拒否ルール
      • エンタープライズの管理ポリシー
      • --allowedTools または --disallowedTools フラグ
      • アクティブな権限モード
      • auto モードの分類器(その判定は同じイベントの classifier_verdict に記録されます)
      • 同じインタラクティブ CLI セッションの以前の権限プロンプトで付与された、セッションの残りの期間に対する許可
      • 本質的に安全なツールであること
      source の値は、これらのソースのどれが一致したかを示しません。classifier_verdict が含まれる場合、それは呼び出しを決定した分類器の結果を示します。呼び出しを拒否した権限ルールや設定を示す tool_decision 属性はありません。 Claude Code は、権限プロンプトのリクエスト自体が失敗した場合にも "config" を報告します。たとえば、Agent SDK の canUseTool コールバックまたは --permission-prompt-tool ツールが無効な結果を返した場合や、リクエストが保留中に入力ストリームが閉じた場合に、そのリクエストは失敗します。
    • "hook": PreToolUse または PermissionRequest フックが決定を返したもの。
    • "user_permanent": ユーザーが権限プロンプトで “Yes, and don’t ask again for …” を選択した場合に出力されます。これにより、許可ルールがユーザーの個人設定に保存されます。インタラクティブ CLI では、その選択自体に対してのみ出力され、保存されたルールに一致する後続の呼び出しでは代わりに "config" が出力されます。Agent SDK または非インタラクティブな -p セッションでは、最初の選択と後続のルール一致の両方で "user_permanent" が出力されます。承認として扱われます。
    • "user_temporary": ユーザーが権限プロンプトで 1 回限りの承認として “Yes” を選択した場合、またはファイルの編集や読み取りのプロンプトでセッションの残りの期間アクセスを許可するオプションを選択した場合に出力されます。インタラクティブ CLI では、その選択自体に対してのみ出力され、そのセッションスコープの許可によって許可された後続の呼び出しでは代わりに "config" が出力されます。Agent SDK または非インタラクティブな -p セッションでは、選択と後続の一致の両方で "user_temporary" が出力されます。承認として扱われます。
    • "user_abort": ユーザーが回答せずに権限プロンプトを閉じた場合に出力されます。Agent SDK および非インタラクティブな -p セッションでは、canUseTool または --permission-prompt-tool の権限リクエストが保留中にターンを中断した場合も含まれます。拒否として扱われます。
    • "user_reject": プロンプトが表示されたときにユーザーが “No” を選択した場合に出力されます。インタラクティブ CLI では、その選択自体に対してのみ出力され、ユーザーの個人設定の拒否ルールに一致する呼び出しでは代わりに "config" が出力されます。Agent SDK または非インタラクティブな -p セッションでは、個人設定の拒否ルールに一致する呼び出しで "user_reject" が出力されます。拒否として扱われます。
  • classifier_verdict: 呼び出しに対する auto モードの分類器の判定、または判定が得られなかった場合に Claude Code が呼び出しを拒否した理由。Claude Code v2.1.301 以降が必要です
    • "allow": 分類器が呼び出しを承認した
    • "block": 分類器が呼び出しをブロックした。途中で失敗した分類器のチェックも "block" で終わることがあるため、分類器の部分的な障害は "unavailable" ではなくブロックの増加として現れることがあります
    • "no_verdict": チェックは実行されたが使用可能な判定が得られなかったため、Claude Code が呼び出しを拒否した。この拒否は、分類器が呼び出しを安全でないと判断したことを意味しません
    • "unavailable": レート制限、タイムアウト、接続エラーなどにより分類器へのリクエストが失敗したため、Claude Code が呼び出しを拒否した。サーバー側の分類器レビューでは、サーバーが安全性の判定を返さなかったために拒否された呼び出しもこれで示されます
    この属性は、分類器が plan モードでコマンドをレビューする場合の plan モードの呼び出しにも含まれます。次の場合、この属性は含まれません:
    • 許可または拒否の権限ルールが呼び出しを決定した
    • Claude Code が auto モードで分類器に問い合わせずに呼び出しを承認した
    • ブロックが繰り返された後に Claude Code が表示したプロンプトにユーザーが回答した
    • --permission-prompt-tool なしの -p 実行で、プロンプトに回答できる人がいなかったため、ブロックが繰り返された後に Claude Code が呼び出しを拒否した。このイベントは decision を "reject"、source を "config" として報告します
  • classifier_category(OTEL_LOG_TOOL_DETAILS=1 の場合): 分類器が呼び出しをブロックしたときに挙げた組み込みルールの名前。小文字とアンダースコアで表され、たとえば Data Exfiltration ルールの場合は "data_exfiltration" です。Claude Code v2.1.301 以降が必要です。この属性は、次の両方が成り立つ場合に含まれます:
    • classifier_verdict が "block" である
    • 分類器がちょうど 1 つのルールを挙げており、そのルールがユーザーが作成したものではなく組み込みのものである
    v2.1.302 より前では、サーバー側の分類器レビューが決定したブロックでもこの属性は含まれていませんでした。
  • permission_mode: この呼び出しの権限チェックが開始されたときにアクティブだった権限モード: "default"、"plan"、"acceptEdits"、"bypassPermissions"、"dontAsk"、または "auto"。Manual モードは "default" として表示されます。サブエージェントの呼び出しでは、セッションの権限モードではなくサブエージェントの権限モードが報告されます。Claude Code v2.1.301 以降が必要です
  • tool_parameters(OTEL_LOG_TOOL_DETAILS=1 の場合): ツール固有のパラメーターを含む JSON 文字列。ツール結果イベントと同じ形式ですが、git_commit_id などの実行後のフィールドは含まれません。権限決定が updatedInput を介してツール入力を書き換えた場合、承認された呼び出しでは値が tool_result と異なることがあります。decision が "reject" の場合にどのコマンドが拒否されたかを確認するには、この属性を使用してください。
    • "sdk_host_builtin_mcp" ツールの場合: ホストアプリケーションがこれらの名前を定義しているため、OTEL_LOG_TOOL_DETAILS がオフでも mcp_server_name と mcp_tool_name が含まれます。これらがないと、これらの組み込みサーバーのいずれかへの拒否された呼び出しは、デフォルトのストリームでは帰属を特定できなくなります。ユーザーが設定した MCP サーバーの場合、イベントの tool_name は常にリテラル "mcp_tool" であり、サーバー名とツール名はフラグがオンの場合にのみ tool_parameters に表示されます。引数の内容は、どの場合でもフラグが必要です。
    • Bash ツールの場合: bash_command、full_command、timeout、description、dangerouslyDisableSandbox を含みます。デスクトップアプリのワークスペース bash ツールも tool_name を Bash として報告しますが、bash_command、full_command、timeout のみを含みます
    • MCP ツールの場合: mcp_server_name、mcp_tool_name を含みます
    • Skill ツールの場合: skill_name を含みます
    • Agent ツールまたは従来の Task ツールの場合: subagent_type を含みます
OpenTelemetry SDK の OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT を tool_decision イベントの属性数より小さくすると、SDK は Claude Code が最後に設定した属性を破棄します。SDK は他のどの属性よりも先に、次の順序でこれらを破棄します(イベントに含まれないものはスキップされます):
  1. parent_agent_id
  2. agent_id
  3. request_id
  4. permission_mode
  5. classifier_category
  6. classifier_verdict
permission_mode、classifier_category、classifier_verdict がこの順序で破棄されるのは Claude Code v2.1.302 以降です。parent_agent_id、agent_id、request_id には v2.1.310 以降が必要です。

安全イベント

Claude Code は claude_code.safety_event の送信を停止しました:
  • v2.1.312 以降: これらのバージョンはこのイベントを送信せず、有効にする設定もありません
  • v2.1.307 から v2.1.311: セッションは、次回の機能フラグの更新時にこのイベントの送信を停止します。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry など、機能フラグを取得しないセッションでは、引き続き送信されることがあります。
拒否されたツール呼び出しを確認するには、tool_decision イベントをクエリしてください。これは呼び出しが拒否されたことを示しますが、どのチェックが拒否したかを常に示すわけではありません。 ここでのイベントの詳細は、v2.1.307 から v2.1.311 のイベントについて説明したものです。これらのバージョンでは、安全イベントは次のようなケースを記録します: このイベントは他のイベントとともにエクスポートされ、個別の設定はありません。イベント独自の属性には、コマンドテキスト、ファイルパス、ホスト名、MCP サーバー名およびツール名は含まれません。レコードには、すべてのイベントが持つ標準属性も含まれ、これには workspace.host_paths やリポジトリ属性が含まれる場合があります。イベントの背後にあるコマンドや MCP ツールを確認するには、OTEL_LOG_TOOL_DETAILS=1 を設定し、対応する tool_decision イベントの tool_parameters を読み取ってください。 イベント名: claude_code.safety_event 属性:
  • すべての標準属性
  • event.name: "safety_event"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
  • category: チェックまたは結果。カテゴリの値のいずれかです
  • decision: "accept"、"reject"、またはフックが結果やターンの終了をブロックした場合は "sent_back"
  • decision_source: 決定した主体。tool_decision の source の値または "other"
  • reason_code: チェックの理由("rule:policySettings"、"mode:dontAsk"、"hook:PreToolUse"、"classifier:auto-mode"、"bashMiss:too-complex"、"unknown" など)
  • reason_type: チェックの理由の種類("rule"、"subcommandResults"、"mode"、"hook"、"classifier"、"asyncAgent" など)
  • rule_source: 関係するルールの設定ソース("policySettings"、"userSettings"、"projectSettings"、"localSettings"、"flagSettings"、"cliArg"、"session" など)
  • grant_scope: 設定ファイルにルールを保存せずに承認されたプロンプトの場合は "once" または "session"
  • circuit_breaker: 組み込みの安全チェック("dangerousRemoval"、"outsideReadsBlocked"、"claudeSettingsFile" など)
  • classifier_category: OTEL_LOG_TOOL_DETAILS=1 の場合、auto モードのブロックの背後にある組み込みルール("data_exfiltration" など)
  • hook_event: PreToolUse フックの場合は "pre_tool_use"、"hook_review" イベントでは "post_tool_use"、"post_tool_use_failure"、"stop"、または "subagent_stop"
  • tool_class: Bash と Monitor の場合は "bash"、"powershell"、Read、Edit、Write、NotebookEdit、Glob、Grep の場合は "file"、WebFetch と WebSearch の場合は "web"、"mcp"、または "other"
  • tool_name: ツールの名前。組み込みツールの場合は "Bash" など、または "mcp_tool"、"skill_tool"、"dynamic_tool"、"other_tool"
  • tool_source: tool_decision と同様に、"builtin"、"mcp"、または "sdk_host_builtin_mcp"
  • permission_mode: チェック時の呼び出しの権限モード: "default"、"plan"、"acceptEdits"、"bypassPermissions"、"dontAsk"、または "auto"
  • tool_use_id: 呼び出しの ID。tool_decision および tool_result と同じです
  • sandbox_violation_count: 呼び出しのコマンドからの接続またはリクエストのうち、サンドボックスのネットワークプロキシが拒否した個別のものの数。"0" から "20" の文字列です。拒否は、フォアグラウンドで終了したサンドボックス化されたコマンドについてカウントされます
  • sandbox_enabled: セッションでサンドボックス化がオンの場合は "true"、それ以外は "false"
管理設定の拒否ルールが Bash コマンドを拒否した場合の、イベント独自の属性は次のとおりです:
安全イベントのカテゴリ
任意の category でプロキシによる拒否を見つけるには、sandbox_violation_count が存在し、かつ "0" でないものでフィルタリングしてください。
安全イベントのない呼び出し
カテゴリのないプロンプトに誰も回答できなかったために拒否された呼び出しを見つけるには、source が "config" で "reject" を報告し、かつ同じ tool_use_id を持つ安全イベントがない tool_decision イベントを探してください。このような拒否は、--permission-prompt-tool も --permission-prompts none も指定されていない -p 実行で発生します。 次のような呼び出しについては tool_decision イベントを確認してください。これらには、実行後に送信される "sandbox_network"、"sandbox_other"、または "hook_review" イベントを除き、安全イベントがありません:
  • カテゴリのないプロンプトで承認された呼び出し
  • PreToolUse フックのみが要求したプロンプトで、canUseTool コールバックまたは --permission-prompt-tool ツールが承認した呼び出し
  • 拒否されたかどうかにかかわらず、AskUserQuestion または ExitPlanMode の呼び出し
カテゴリのないプロンプト
プロンプトのチェックを示す category の値がない場合、そのプロンプトにはカテゴリがありません。たとえば、作業ディレクトリ内の編集に対する default モードのプロンプトなどです。

権限モード変更イベント

権限モードが変更されたときに記録されます。たとえば、Shift+Tab による切り替え、plan モードの終了、auto モードのゲートチェックなどによる変更です。 ツール呼び出しを、それぞれがチェックされた権限モードでグループ化するには、ツール決定イベントの permission_mode を使用してください。 イベント名: claude_code.permission_mode_changed 属性:
  • すべての標準属性
  • event.name: "permission_mode_changed"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントを順序付けるためのプロセスごとのカウンター。イベント相関属性で説明しています
  • from_mode: 以前の権限モード(例: "default"、"plan"、"acceptEdits"、"auto"、"bypassPermissions")
  • to_mode: 新しい権限モード
  • trigger: 変更の原因(例: "shift_tab"、"exit_plan_mode"、"auto_gate_denied")。SDK が setPermissionMode() を通じて権限モードを設定した場合など、一部の変更では含まれません

認証イベント

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

MCP サーバー接続イベント

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

内部エラーイベント

Claude Code が予期しない内部エラーを捕捉したときに記録されます。記録されるのはエラークラス名と errno 形式のコードのみです。エラーメッセージとスタックトレースは一切含まれません。このイベントは、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry に対して実行している場合、または DISABLE_ERROR_REPORTING が設定されている場合には送信されません。 イベント名: claude_code.internal_error 属性:
  • すべての標準属性
  • event.name: "internal_error"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントの順序付けのためのプロセスごとのカウンター。イベント相関属性で説明しています
  • error_name: エラークラス名("TypeError" や "SyntaxError" など)
  • error_code: エラーに存在する場合の Node.js の errno コード("ENOENT" など)

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

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

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

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

スキル有効化イベント

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

@ メンションイベント

Claude Code がプロンプト内の @ メンションを解決したときに記録されます。すべてのメンションがイベントを送信するわけではありません。権限の拒否、サイズ超過のファイル、PDF 参照の添付、ディレクトリ一覧の取得失敗などの早期終了パスは、ログを記録せずに戻ります。 Claude Code がプロンプトを読み取るたびに、mention_type が "agent" のイベントは最大 100 件、"mcp_resource" のイベントは最大 100 件まで記録されます。いずれかの上限を超えたメンションも解決はされますが、イベントは送信されません。 イベント名: claude_code.at_mention 属性:
  • すべての標準属性
  • event.name: "at_mention"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントの順序付けのためのプロセスごとのカウンター。イベント相関属性で説明しています
  • mention_type: メンションの種類("file"、"directory"、"agent"、"mcp_resource"、"peer")。"peer" の値は、自分の他の Claude Code セッションのいずれかをメンションしたことを意味します。Claude Code v2.1.232 以降が必要です
  • success: メンションが正常に解決されたかどうか("true" または "false")

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

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

フック登録イベント

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

フック実行開始イベント

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

フック実行完了イベント

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

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

公式マーケットプレイスのプラグインのフックが呼び出しごとのメトリクスを送信したときに記録されます。これらを送信できるのは、Anthropic の公式マーケットプレイスからインストールされたプラグインのみです。サードパーティのマーケットプレイスのプラグインやユーザーが設定したフックは、このイベントに送信しません。このイベントを使用して、検出率、コスト、所要時間などのプラグインの動作を独自のオブザーバビリティスタックから監視できます。 イベント名: claude_code.hook_plugin_metrics 属性:
  • すべての標準属性
  • event.name: "hook_plugin_metrics"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントの順序付けのためのプロセスごとのカウンター。イベント相関属性で説明しています
  • plugin_id: <name>@<marketplace> 形式のプラグイン識別子
  • hook_event: メトリクスを送信したフックイベントの種類
  • プラグインが送信する最大 20 個のメトリクスキー。名前は ^[a-z][a-z0-9_]{0,39}$ に一致します。値はブール値または数値です。

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

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

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

サブエージェントが終了し、その結果を起動元の会話に返したときに記録されます。サブエージェントの種類ごとにツールの使用と実行時間を集計するために使用します。トークンやコストの集計には、query_source "subagent" でフィルタリングしたトークンカウンターとコストカウンターを使用してください。このイベントの total_tokens は最後のリクエストのみを対象としているためです。"subagent" カテゴリには、サブエージェントイベントを送信しないエージェントベースのフックからのリクエストもカウントされます。 イベント名: claude_code.subagent_completed 属性:
  • すべての標準属性
  • event.name: "subagent_completed"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントの順序付けのためのプロセスごとのカウンター。イベント相関属性で説明しています
  • agent_type: サブエージェントの種類。組み込みエージェントの名前と公式マーケットプレイスのプラグインのエージェントはそのまま表示されます。その他のエージェント名は、OTEL_LOG_TOOL_DETAILS=1 が設定されている場合を除き、"custom" に置き換えられます
  • agent.source: エージェント定義の出どころ: built-in、plugin、またはカスタムエージェントを定義した設定ソース(userSettings や projectSettings など)
  • is_built_in: サブエージェントが組み込みのエージェントの種類かどうか
  • is_async: サブエージェントがバックグラウンドで実行されたかどうか
  • total_tokens: サブエージェントの最後の API リクエストのトークンフットプリント。その 1 つのリクエストの入力、キャッシュ作成、キャッシュ読み取り、出力のトークンで、完了時のサブエージェントのコンテキストサイズにおおよそ相当します。実行全体の合計ではありません
  • total_tool_uses: サブエージェントが実行全体で行ったツール呼び出しの数
  • duration_ms: 実行時間(ミリ秒)
  • model: サブエージェントの実行用に解決されたモデル
  • final_model: サブエージェントの最終応答を生成したモデル。フォールバックなどで実行途中に切り替わった場合は model と異なります
  • model_swapped: サブエージェントのリクエストに複数のモデルが使われたかどうか
  • plugin_id_hash、plugin.name: プラグインが提供するエージェントの場合に存在します。公式マーケットプレイスのプラグイン名はそのまま表示されます。その他のプラグイン名は、OTEL_LOG_TOOL_DETAILS=1 が設定されている場合を除き、"third-party" に置き換えられます

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

セッション品質アンケートが表示されたとき、または回答されたときに記録されます。アンケートが収集する内容と制御方法については、セッション品質アンケートを参照してください。 イベント名: claude_code.feedback_survey 属性:
  • すべての標準属性
  • event.name: "feedback_survey"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントの順序付けのためのプロセスごとのカウンター。イベント相関属性で説明しています
  • event_type: アンケートのライフサイクルイベント(例: "appeared"、"responded"、"transcript_prompt_appeared")
  • appearance_id: 1 つのアンケートインスタンスに対して送信されたイベントを関連付ける一意の ID
  • survey_type: イベントを生成したアンケート。"session" は「How is Claude doing?」の評価プロンプトです
  • response: responded イベントでのユーザーの選択
  • enabled_via_override: CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL が設定されている場合は true。文字列ではなくブール値として送信されます。session アンケートイベントに存在します。この属性でフィルタリングして、上書きがフリート全体に適用されていることを確認できます

保持スイープイベント

保持期間のクリーンアップスイープの実行ごとに 1 回記録されます。このスイープは、cleanupPeriodDays 設定より古いセッショントランスクリプトやその他のアプリケーションデータを削除します。Claude Code はスイープをバックグラウンドでセッションごとに最大 1 回実行し、何も削除しなかった実行でもイベントは送信されます。過去 24 時間以内に同じマシン上のいずれかのセッションで Claude Code がスイープを実行していた場合、このセッションのスイープは少なくとも 10 分遅延されるため、それより早く終了したセッションは何も送信しません。claude -p を --bare 付きで実行した場合、Claude Code はスイープを実行せず、何も送信しません。 このページのすべての OTel イベントと同様に、このイベントは設定したテレメトリバックエンドにのみ送信されます。Claude Code v2.1.227 以降が必要です。 スイープが実行されたかどうかは result で確認できます。
  • "complete": スイープが実行され、イベントにはそのカウントが含まれます
  • "skipped": Claude Code が保持期間を安全に判断できなかったため、スイープを一時停止し、イベントにはカウントが含まれません。skip_reason が "settings_unknowable" または "settings_invalid_key_set" の場合は、後のセッションでスイープを実行できるように、そのマシンで /status が報告する設定エラーを修正してください
管理設定が cleanupPeriodDays を設定している場合、管理値が保持期間を固定し、優先度の低いスコープの設定ファイルが壊れているか無効であってもスイープは実行されます。 イベント名: claude_code.retention_sweep 属性:
  • すべての標準属性
  • event.name: "retention_sweep"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントの順序付けのためのプロセスごとのカウンター。イベント相関属性で説明しています
  • result: スイープが実行された場合は "complete"、Claude Code がスイープを一時停止した場合は "skipped"
  • period_days: スイープ開始時の保持期間(日数)。マージされた設定の cleanupPeriodDays に、settings.read フックによる変更を適用したものです。その結果キーが未設定の場合は 30。スキップされたイベントでは、Claude Code が読み取れた設定ソースから計算された、スイープが使用したはずの値
  • used_default: period_days が 30 にフォールバックした場合は "true"、それ以外の場合は "false"。complete イベントでは、"true" は 30 日のデフォルトが適用されたことを意味します
  • skip_reason: Claude Code がスイープを一時停止した理由。result が "skipped" の場合にのみ存在します:
    • "user_source_disabled": --setting-sources フラグや SDK の settingSources オプションなどによってユーザー設定が除外されており、有効なソースのいずれも cleanupPeriodDays を提供していない
    • "settings_unknowable": 設定ファイルを読み取れなかったか解析できなかったため、cleanupPeriodDays または desktopSessionCleanupPeriodDays が Claude Code から見えない値に設定されている可能性がある
    • "settings_invalid_key_set": 設定に検証エラーがあり、かつ cleanupPeriodDays または desktopSessionCleanupPeriodDays が明示的に設定されているため、デフォルトにフォールバックすると、その設定に反してファイルを削除または保持する可能性がある
    • "remote_settings_unknowable": サードパーティのデプロイ上の Claude Desktop の Code タブのセッションがサーバー管理設定を要求したが、使用可能なレスポンスを受信しなかったため、cleanupPeriodDays が Claude Code から見えない値に設定されている可能性がある
  • transcripts_deleted: スイープが削除したセッショントランスクリプト(トップレベルの ~/.claude/projects/*/*.jsonl ファイル)の数
  • transcripts_exempted_desktop: 保持期間を過ぎているものの、Claude Desktop と Cowork のルールに基づいてスイープが保持したトランスクリプトの数。これらは files_past_cutoff にはカウントされません。Claude Code v2.1.248 以降が必要です
  • session_files_deleted: セッションファイルのスイープが削除した成果物の数。トランスクリプトに加え、サイドカー、録画、ツール結果などのセッションごとの付随ファイルが含まれます
  • artifacts_deleted: セッションファイルを含め、スイープが対象とするデータディレクトリ全体で削除した項目の合計。一部のスイープは削除したディレクトリツリー全体を 1 項目として数え、いくつかのクリーンアップ処理はカウンターに寄与しないため、この値は正確なファイル数ではなく下限として扱ってください
  • files_retained_fresh: 検査されたものの、まだ保持期間内であるため残されたファイル。ファイル単位のスイープのみがこれらをカウントするため、この値は下限です。ゼロ以外の値が通常の定常状態です
  • files_past_cutoff: 保持期間より古く、権限エラーや開かれたままのファイルなどの理由でスイープが削除に失敗したファイル。このカウントには、スイープが skills/synced/ または plugins/synced/ の下で見つけた古いフォルダーも、ゴミ箱に移動したかどうかにかかわらず 1 つずつ含まれます。これらのフォルダーを除き、ゼロより大きい値は、設定された保持期間を超えてファイルが残ったことを意味します。ただし、ゼロであってもそのようなファイルがないことの証明にはなりません。ディレクトリ全体の削除に失敗した場合は、代わりに error_count にカウントされるためです
  • error_count: ファイルの一覧取得または削除中にスイープで発生したエラーの数

管理設定解決イベント

セッションが解決した管理設定とともに記録されます。セッション開始時に 1 回、セッション中に管理設定またはポリシーヘルパーの状態が変化したときに再度、そして error.type 属性に列挙されているいずれかの理由で Claude Code が起動を拒否するかセッションを終了したときに記録されます。 このイベントを使用して、予期しない管理ソースで実行されているマシン、ポリシーヘルパーが失敗しているマシン、およびマシンが起動を拒否した理由を特定できます。 Claude Code v2.1.274 以降が必要です。 デフォルトでは、イベントには管理ソースとポリシーヘルパーの状態が含まれますが、設定自体は含まれません。秘匿化された managed_settings.settings 属性と managed_settings.resolved_sha256 ダイジェストを追加するには、OTEL_LOG_MANAGED_SETTINGS=1 を設定します。
  • 管理設定、ユーザー設定、または --settings の env ブロック、あるいは Claude Code を起動する環境で設定します。プロジェクト設定やローカル設定の値では有効になりません。クローンしたリポジトリがそれらを書き込めるためです。
  • サーバー管理設定では、セキュリティ承認ダイアログを表示せずに設定できます。この変数は、組織がすでに受信しているイベントに組織自身の秘匿化されたポリシーを追加するだけだからです。
信頼していないフォルダーでの対話型セッションでは、Claude Code は拒否イベントをエクスポートしません。 イベント名: claude_code.managed_settings_resolved 属性:
  • すべての標準属性
  • event.name: "managed_settings_resolved"
  • event.timestamp: ISO 8601 タイムスタンプ
  • event.sequence: イベントの順序付けのためのプロセスごとのカウンター。イベント相関属性で説明しています
  • managed_settings.trigger: セッション開始時のイベントでは "startup"、セッションの後半で管理設定またはポリシーヘルパーの状態が変化した場合は "change"、管理設定ポリシーによってセッションが停止された場合は "refused"。Claude Code は、いずれかの属性が最後に送信したイベントと異なる場合にのみ change イベントを送信します。OTEL_LOG_MANAGED_SETTINGS がオフの場合でも、設定値の変更はこれに該当します
  • error.type: Claude Code がセッションを停止した理由。refused イベントにのみ存在します:
    • "helper_failed": ポリシーヘルパーの実行が失敗した
    • "policy_invalid": 管理設定に Claude Code の起動を妨げるエラーが含まれているか、管理ソースが読み取り拒否以外の理由で読み込みに失敗したため、Claude Code が組織ログインやプロバイダーの強制を確認できない
    • "provider_not_allowed": セッションが、管理設定の allowedProviders リストで許可されていない API プロバイダーを使用するか、プロバイダーのトラフィックを許可されていないホストに送信しようとした。Claude Code v2.1.285 以降が必要です
    • "consent_rejected": ユーザーがサーバー管理設定のセキュリティ承認ダイアログを拒否した
    • "force_refresh_failed": forceRemoteSettingsRefresh が必要とする設定の取得が失敗した
    • "gateway_rejected": Claude apps ゲートウェイが管理設定の読み込みに HTTP 403 で応答した
    • "version_below_minimum": この Claude Code のバージョンが requiredMinimumVersion を下回っているか、requiredMaximumVersion を上回っている
    • "_OTHER": Claude apps ゲートウェイの管理設定の読み込みが他の理由で失敗した
  • managed_settings.sources: 少なくとも 1 つのポリシーキーを提供するすべての管理ソースで、優先度の高い順に並びます。first-wins の下でキーが有効にならないソースも含まれます。値は、"remote"、MDM または OS レベルのポリシーの場合は "plist" または "hklm"、管理設定ファイルとドロップインの場合は "file"、埋め込みホストが設定を提供する場合は "parent"、Claude Code が Windows HKCU レジストリ値を読み取る場合は "hkcu" です。制御キーのみを含むソースや、Claude Code が読み取れなかったソースは列挙されません。文字列の配列として送信され、ポリシーキーを提供する管理ソースがない場合は空になります
  • managed_settings.source_behavior: Claude Code が読み取った managedSourcesBehavior の値で、"first-wins" または "merge"。どのソースもキーを設定していない場合は "first-wins"
  • managed_settings.helper.state: 選択された MDM またはファイルソースが設定するポリシーヘルパーの状態:
    • "ok": ヘルパーの出力が管理設定として使用されている
    • "bad_path"、"not_a_file"、"exit_nonzero"、"timed_out"、"oversize"、"parse_failed"、"envelope_invalid"、または "schema_rejected": ヘルパーの最後の実行が失敗した。各ケースについてはヘルパーの失敗で説明しています
    • "none": ヘルパーが設定されていないか、ヘルパーを設定しているソースが MDM ポリシーまたは管理設定ファイルではない
  • managed_settings.helper.applied: ヘルパー自身の出力が管理設定として使用されている間は "output"、そうでない場合は "none"
  • managed_settings.helper.entry: Claude Code が policyHelper を選択した場合は "policyHelper"。ヘルパーを選択しなかった場合は存在しません
  • managed_settings.helper.path: ヘルパーの設定された path。OTEL_LOG_MANAGED_SETTINGS が設定されているかどうかにかかわらず、Claude Code がヘルパーを選択した場合は常に存在します
  • managed_settings.resolved_sha256(OTEL_LOG_MANAGED_SETTINGS=1 の場合): 秘匿化前の解決済み管理設定の SHA-256 で、キーを再帰的にソートし、空白を含めない JSON としてシリアライズしたものです。同じダイジェストを持つマシンは同じポリシーで動作しています。短いポリシーは推測値をハッシュすることで復元できるため、Claude Code はオプトインした場合にのみダイジェストを送信します。管理設定が解決されなかった場合、および refused イベントでは存在しません
  • managed_settings.settings(OTEL_LOG_MANAGED_SETTINGS=1 の場合): 解決済み管理設定の名前と構造を、値を秘匿化した JSON 文字列として表したもの。refused イベントでは存在しません。Claude Code は設定スキーマに基づいてこれを構築します:
    • スキーマが宣言している設定名はエクスポートされ、宣言されていないキーは除外されます
    • ブール値、数値、およびスキーマが固定の選択肢に制限している文字列値(permissions.defaultMode など)はそのままエクスポートされます。sandbox.network.httpProxyPort と sandbox.network.socksProxyPort は "[REDACTED]" としてエクスポートされます
    • その他のすべての文字列(model、apiKeyHelper、すべての env の値、すべての URL、すべてのコマンドなど)は "[REDACTED]" としてエクスポートされます
    • マップのエントリ名(env の変数名やプラグイン ID など)はそのままエクスポートされます。スキーマがエントリの型を定義していない設定(vimInsertModeRemaps など)は単一の "[REDACTED]" としてエクスポートされ、sandbox.ignoreViolations はコマンドパターンを除いたパスリストのリストとしてエクスポートされます
    • リストはその長さを保持し、各エントリは同じルールで秘匿化されます
    • permissions.allow、permissions.deny、または permissions.ask のルールは、ツールがこのバージョンの Claude Code に組み込まれている場合、または mcp__jira__create_issue のような mcp__ 参照である場合、内容を秘匿化したツール名(Read([REDACTED]) など)としてエクスポートされます。その他のルールは "[REDACTED]" としてエクスポートされます
    • フックも同じルールに従うため、type や timeout などの固定選択肢のフィールドや数値フィールドは表示されますが、各コマンド、URL、matcher、if 条件は "[REDACTED]" としてエクスポートされます
    たとえば、apiKeyHelper、2 つの env 変数、および拒否ルールを含む管理設定は、{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}} としてエクスポートされます。 Claude Code はこの値を UTF-8 で 8 KB の位置で切り詰め、切り詰められた値は有効な JSON ではありません
  • managed_settings.settings_truncated(managed_settings.settings が存在する場合): Claude Code が managed_settings.settings を 8 KB で切り詰めた場合は true、それ以外の場合は false。文字列ではなくブール値として送信されます

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

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

使用状況監視

サーフェス間でアクティブユーザーを比較するには、OTEL_METRICS_INCLUDE_ENTRYPOINT=true を設定して、メトリクスとイベントに app.entrypoint を追加します。次に、claude_code.user_prompt イベント、またはメトリクスのみをエクスポートしている場合は claude_code.token.usage で、エントリポイントごとに一意の user.account_uuid 値の数をカウントします。たとえば、対話型 CLI セッションには cli を使用し、Claude Desktop の Code タブについては claude-desktop、claude-desktop-3p、remote_desktop をまとめてグループ化します。 user.account_uuid は Claude Tag チャネルセッションでは個人を識別せず、Claude アカウントのないセッションには含まれません。アクションをユーザーに帰属させる を参照してください。1 人が多数のセッションを開始した場合や、セッションがプロンプトを受け取らなかった場合、claude_code.session.count は増加しますが、アクティブユーザーは増えません。

コスト監視

claude_code.cost.usage メトリクスは以下に役立ちます:
  • チームまたは個人全体の使用トレンドを追跡する
  • 最適化のための高使用セッションを特定する
  • skill.name、plugin.name、および agent.name 属性を介して、特定のスキル、プラグイン、またはサブエージェントタイプへの支出を属性付けする
コストメトリクスは概算です。公式な請求データについては、組織のコストを管理する を参照してください。
Claude Code は、ANTHROPIC_BASE_URL の背後にあるゲートウェイまたはプロキシが複数のフレーム全体で使用状況をプログレッシブにストリーミングする場合を含め、各ストリーミングレスポンスをコストおよびトークンメトリクスに対して正確に 1 回カウントします。

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

検討すべき一般的なアラート:
  • コストスパイク
  • 異常なトークン消費
  • 特定のユーザーからの高いセッションボリューム
すべてのメトリクスは、標準属性 でセグメント化できます。model 属性は claude_code.token.usage、claude_code.cost.usage、および claude_code.lines_of_code.count で利用可能です。 コミットのモデル別の内訳は、1 つのセッションが複数のモデルにまたがる可能性があるため、session.id でトークンまたはコストメトリクスに対して結合することによってのみ概算できます。トークンまたはコスト側をフィルタリングして、query_source が "main" である行のみにしてください。これにより、補助的なリクエストとサブエージェントリクエストが、セッションのコミットをそれらを作成しなかったモデルに属性付けしません。

再試行枯渇の検出

Claude Code は失敗した API リクエストを内部的に再試行し、あきらめた後にのみ単一の claude_code.api_error イベントを出力するため、イベント自体がそのリクエストの終端信号です。中間再試行試行は個別のイベントとしてログされません。 イベントの attempt 属性は、試行回数を記録します。CLAUDE_CODE_MAX_RETRIES はデフォルトで 10 で、15 で上限です。CLAUDE_CODE_RETRY_WATCHDOG を設定すると、デフォルトはより高くなり、上限はなくなります。 リクエストが一時的なエラーのすべての再試行を枯渇させた場合、attempt は最大でもその有効な制限より 1 つ多い値になります: デフォルトでは 11 です。 より低い値でも再試行が尽きたことを意味する場合があります: Claude Code がストリーミングの失敗後にリクエストを再発行するたびに、attempt は 1 から再び開始されるためです。 セッションが回復したものと停止したものを区別するには、イベントを session.id でグループ化し、エラーの後に後続の api_request イベントが存在するかどうかを確認します。

イベント分析

イベントデータは Claude Code インタラクションに関する詳細な洞察を提供します: ツール使用パターン: ツール結果イベントを分析して以下を特定します:
  • 最も頻繁に使用されるツール
  • ツール成功率
  • 平均ツール実行時間
  • ツールタイプ別のエラーパターン
パフォーマンス監視: API リクエスト期間とツール実行時間を追跡して、パフォーマンスボトルネックを特定します。

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

Claude Code は、入力トークン数を API レスポンスの usage ブロックに表示されるとおりにエクスポートするため、これらの値には プロンプトキャッシュ から読み取られたトークンやキャッシュに書き込まれたトークンは含まれません: Claude Code は gen_ai.usage.* 属性を設定しません。OpenTelemetry GenAI セマンティック規約 では、gen_ai.usage.input_tokens にはキャッシュから読み取られたトークンとキャッシュに書き込まれたトークンを含めるべきとされています。その合計を計算するには:
  • スパンまたはイベントから: input_tokens、cache_read_tokens、cache_creation_tokens を合計します
  • claude_code.token.usage メトリクスから: その "input"、"cacheRead"、"cacheCreation" タイプを合計します
規約では、キャッシュ読み取りとキャッシュ書き込みに対して個別の属性も定義されています:
  • cache_read_tokens は gen_ai.usage.cache_read.input_tokens に対応します
  • cache_creation_tokens は gen_ai.usage.cache_write.input_tokens に対応します。古いバージョンの規約ではキャッシュ書き込み属性の名前が gen_ai.usage.cache_creation.input_tokens となっているため、バックエンドが想定する名前を使用してください。

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

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

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

各イベントの 標準属性 には、認証されたユーザーの ID が含まれます:Claude アカウントでサインインしている場合は user.email、user.account_uuid、user.account_id、および organization.id、さらに クラウドセッション では、セッション自体の認証情報がそれらを持つ場合、user.id とセッションごとの session.id。user.id はインストールスコープの識別子です。ただし、Claude apps gateway セッションでは /login を通じてサインインしている場合、ゲートウェイが発行したトークンからの IdP サブジェクトです。 開発者が開始したセッションでは、MCP ツール呼び出し、Bash コマンド、ファイル編集はその開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または Claude apps gateway セッションでの開発者の IdP ID です。Claude Tag チャネルセッションでは、Claude はあなたの組織の 共有 ID として機能します。 Claude Code が直接 API キーで認証する場合、または Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、user.id と session.id のみが入力されます。これらのデプロイメントでは、OTEL_RESOURCE_ATTRIBUTES を使用してユーザー ID を自分で添付し、管理設定 ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません:標準属性 を参照して、それらのエクスポートが持つ ID を確認してください。

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

完全なコール詳細で MCP サーバーアクティビティをキャプチャするには、ログエクスポーターを有効にし、OTEL_LOG_TOOL_DETAILS=1 を設定します。その後、各 MCP 操作は、標準 ID 属性と共にサーバー名、ツール名、呼び出し引数を含む構造化イベントを生成します: OTEL_LOG_TOOL_DETAILS がない場合、これらのイベントは識別詳細を削除します:
  • tool_result:mcp_server_scope と、ユーザー設定サーバーの場合はリテラル "mcp_tool" に編集された tool_name を保持し、引数コンテンツを省略します。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、tool_parameters 内の mcp_server_name/mcp_tool_name ペアも保持します。これは tool_decision と同じホスト作成例外です
  • tool_decision:tool_source と、ユーザー設定サーバーの場合はリテラル "mcp_tool" に編集された tool_name を保持し、引数コンテンツを省略します。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、tool_parameters 内の mcp_server_name/mcp_tool_name ペアも保持します
  • mcp_server_connection:server_name とエラーメッセージを省略しますが、is_plugin、plugin_id_hash、および plugin.name を保持し、Anthropic 以外のプラグイン名はリテラル "third-party" に編集されるため、プラグイン提供サーバーは詳細ログなしで区別可能なままです

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

safety_event の行は、v2.1.307 から v2.1.311 までのバージョンで、このイベントをまだ送信する セッションにのみ適用されます。 検出ルールを構築する場合、監視したいシグナルを検索し、対応するイベントと属性についてバックエンドをクエリします: Claude Code は生のイベントストリームのみを出力します。異常検出、ベースライン化、セッション間の相関、アラートは SIEM または可観測性バックエンドの責任です。

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

次の表は、セッションの内容をマシン外に持ち出す可能性のある経路とローカル保持を、それらを制限する 管理設定 のキー、およびそれらを記録するイベントと対応付けたものです。/feedback レポートなど、Claude Code 自体が Anthropic に送信するものについては、データの使用 を参照してください。各名前はそれぞれのリファレンス項目にリンクしており、そこに値とデフォルトが記載されています。 allowedHttpHookUrls、managed-mcp.json、およびフックイベントの各項目には、表に示した以上の補足があります:
  • allowedHttpHookUrls:エントリは設定ファイル間でマージされるため、開発者は空の管理リストに追加できます。どのフックを実行するかは allowManagedHooksOnly が決定します
  • managed-mcp.json:MCP をオフにするには、MCP を完全に無効にする を参照してください。Claude Code がこのファイルを読み込んでいることを確認するには、設定を検証する を参照してください
  • フックイベント:Claude Code は hook_execution_start と hook_execution_complete をフックイベントごとに 1 回ログに記録し、一致するすべてのフックを対象とします。OTEL_LOG_TOOL_DETAILS=1 だけでは HTTP フックの URL は記録されません。フックの設定は hook_definitions にのみ表示され、これには詳細なベータトレースも必要です
OTEL_LOG_TOOL_DETAILS=1 は、これらのイベントにコマンド文字列、サーバー名とツール名、およびツール入力を追加します。この詳細にはセッション自体と同じ機密コンテンツが含まれる可能性があるため、コレクターがそのコンテンツを保持することが承認されている場合にのみ有効にしてください。

保持スイープを確認する

すべてのマシンに同じ保持期間を適用するには、管理設定 で cleanupPeriodDays を設定します。マシンがその値でスイープを実行していることを確認するには、retention_sweep イベントを収集します。period_days とカウンターは文字列であるため、比較する前に数値にキャストしてください。 意図どおりに動作しているマシンでも、次のような理由でイベントが発生しないことがあります:
  • 誰も Claude Code を起動しない:スイープは実行されず、マシンは次回の起動までデータを保持します
  • セッションが開いたままになっている:Claude Code はセッションごとに最大 1 回しかスイープを実行しません
  • セッションが早期に終了する:セッション終了時に完了していないスイープは何も出力せず、予期しないエラーで停止したスイープも同様です
スイープはすべてのパスを対象とするわけではありません。残るものは 削除するまで保持されるもの に一覧があり、その削除方法は ローカルデータを消去する で説明しています。

SIEM にイベントを送信する

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT を SIEM の OTLP レシーバーに、または SIEM のネイティブ取り込み API にフォワードする OpenTelemetry Collector に指定します。以下の管理設定の例は、MCP および Bash 監査のための完全なツール詳細を有効にして、イベントのみをエクスポートします:
イベントが到着したことを確認するには、この設定で実行されているセッションでプロンプトを送信し、SIEM で claude_code.user_prompt イベントを確認します。何も到着しない場合は、claude --debug-file <path> で Claude Code を起動し、そのログで [3P telemetry] エクスポートエラーを確認します。

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

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

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

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

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

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

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

分散トレースストレージとスパン相関をサポートするバックエンドを選択します:
  • 分散トレースシステム: スパン可視化、リクエストウォーターフォール、レイテンシー分析
  • フル機能の可観測性プラットフォーム: トレース検索とメトリクスおよびログとの相関
日次/週次/月次アクティブユーザー (DAU/WAU/MAU) メトリクスが必要な組織の場合は、効率的な一意値クエリをサポートするバックエンドを検討してください。

サービス情報

すべてのメトリクスとイベントは、以下のリソース属性でエクスポートされます:
  • service.name: ターミナルセッションの場合は claude-code、Claude Desktop アプリのコードタブから開始されたローカルセッションの場合は claude-code-desktop
  • service.version: 現在の Claude Code バージョン、またはローカルのコードタブセッションの場合は Desktop アプリバージョン
  • os.type: オペレーティングシステムタイプ (例: linux、darwin、windows)
  • os.version: オペレーティングシステムバージョン文字列
  • host.arch: ホストアーキテクチャ (例: amd64、arm64)
  • wsl.version: WSL バージョン番号 (Windows Subsystem for Linux で実行している場合のみ存在)
  • メーター名: com.anthropic.claude_code
service.name = claude-code でフィルタリングするコレクターパイプラインまたはダッシュボードがある場合は、ローカルのコードタブセッションからのテレメトリもキャプチャするために、フィルターに claude-code-desktop を追加してください。

ROI 測定リソース

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

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

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

Amazon Bedrock での Claude Code の監視

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