監視

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

クイックスタート

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

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

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

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

# 5. デバッグ用: エクスポート間隔を短縮する
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 秒 (デフォルト: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5 秒 (デフォルト: 5000ms)

# 6. Claude Code を実行する
claude

​

管理者設定

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

​

設定の詳細

​

一般的な設定変数

​

mTLS 認証

​

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

​

トレース (ベータ)

​

スパン階層

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

​

スパン属性

​

動的ヘッダー

​

設定ファイルの設定

{
  "otelHeadersHelper": "/bin/generate_opentelemetry_headers.sh"
}

​

スクリプト要件

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

​

リフレッシュ動作

​

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

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

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

# ❌ 無効 - スペースを含む
export OTEL_RESOURCE_ATTRIBUTES="org.name=John's Organization"

# ✅ 有効 - アンダースコアまたはキャメルケースを代わりに使用する
export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

# ✅ 有効 - 必要に応じて特殊文字をパーセントエンコードする
export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

​

設定例

# コンソールデバッグ (1 秒間隔)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

# OTLP/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
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

# 複数のエクスポーター
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console,otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

# メトリクスとログの異なるエンドポイント/バックエンド
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://metrics.example.com:4318
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

# メトリクスのみ (イベント/ログなし)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# イベント/ログのみ (メトリクスなし)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

​

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

​

標準属性

• prompt.id: ユーザープロンプトを次のプロンプトまでのすべての後続イベントと相関させる UUID。イベント相関属性を参照してください。
• workspace.host_paths: デスクトップアプリで選択されたホストワークスペースディレクトリ (文字列配列として)

​

メトリクス

​

メトリクスの詳細

​

セッションカウンター

• すべての標準属性
• start_type: セッションがどのように開始されたか。"fresh"、"resume"、または "continue" のいずれか

​

コード行カウンター

• すべての標準属性
• type: ("added"、"removed")

​

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

• すべての標準属性

​

コミットカウンター

• すべての標準属性

​

コストカウンター

• すべての標準属性
• model: モデル識別子 (例: “claude-sonnet-4-6”)
• query_source: リクエストを発行したサブシステムのカテゴリ。"main"、"subagent"、または "auxiliary" のいずれか
• speed: 高速モードを使用した場合は "fast"。それ以外の場合は存在しません
• effort: リクエストに適用された努力レベル: "low"、"medium"、"high"、"xhigh"、または "max"。モデルが努力をサポートしない場合は存在しません。
• agent.name: リクエストを発行したサブエージェントタイプ。組み込みエージェント名と公式マーケットプレイスプラグインのエージェントはそのまま表示されます。その他のユーザー定義エージェント名は "custom" に置き換えられます。リクエストが名前付きサブエージェントタイプによって発行されなかった場合は存在しません。
• skill.name: リクエストに対してアクティブなスキル。Skill ツール、/ コマンド、またはスポーンされたサブエージェントによって継承されます。組み込み、バンドル、ユーザー定義、および公式マーケットプレイスプラグインスキル名はそのまま表示されます。サードパーティプラグインスキル名は "third-party" に置き換えられます。アクティブなスキルがない場合は存在しません。
• plugin.name: アクティブなスキルまたはサブエージェントがプラグインによって提供される場合の所有プラグイン。公式マーケットプレイスプラグイン名はそのまま表示されます。サードパーティプラグイン名は "third-party" に置き換えられます。スキルもサブエージェントも所有プラグインを持たない場合は存在しません。
• marketplace.name: 所有プラグインがインストールされたマーケットプレイス。公式マーケットプレイスプラグインに対してのみ出力されます。それ以外の場合は存在しません。

​

トークンカウンター

• すべての標準属性
• type: ("input"、"output"、"cacheRead"、"cacheCreation")
• model: モデル識別子 (例: “claude-sonnet-4-6”)
• query_source: リクエストを発行したサブシステムのカテゴリ。"main"、"subagent"、または "auxiliary" のいずれか
• speed: 高速モードを使用した場合は "fast"。それ以外の場合は存在しません
• effort: リクエストに適用された努力レベル。詳細は コストカウンターを参照してください。
• agent.name、skill.name、plugin.name、marketplace.name: リクエストのスキル、プラグイン、およびエージェント属性。定義と編集動作については コストカウンターを参照してください。

​

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

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

​

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

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

​

イベント

​

イベント相関属性

​

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

• すべての標準属性
• event.name: "user_prompt"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• prompt_length: プロンプトの長さ
• prompt: プロンプトコンテンツ (デフォルトではマスク、OTEL_LOG_USER_PROMPTS=1 で有効化)
• command_name: プロンプトがコマンドを呼び出す場合のコマンド名。compact または debug などの組み込みおよびバンドルされたコマンド名はそのまま出力されます。reset などのエイリアスは、正規名ではなく入力されたとおりに出力されます。カスタム、プラグイン、MCP コマンド名は、OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り custom または mcp に折りたたまれます
• command_source: コマンドが存在する場合のコマンドの起源: builtin、custom、または mcp。プラグイン提供のコマンドは custom として報告されます

​

ツール結果イベント

• すべての標準属性
• 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" または "reject"
• 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 ツール用)
• tool_parameters (OTEL_LOG_TOOL_DETAILS=1 の場合): ツール固有のパラメーターを含む JSON 文字列:
  • Bash ツールの場合: bash_command、full_command、timeout、description、dangerouslyDisableSandbox、および git_commit_id (git commit コマンドが成功した場合のコミット SHA) を含む
  • MCP ツール: mcp_server_name、mcp_tool_name を含む
  • Skill ツール: skill_name を含む
  • Task ツール: subagent_type を含む
• tool_input (OTEL_LOG_TOOL_DETAILS=1 の場合): JSON シリアル化されたツール引数。512 文字を超える個別の値は切り詰められ、全体のペイロードは約 4 K 文字に制限されます。すべてのツール (MCP ツールを含む) に適用されます。

​

API リクエストイベント

• すべての標準属性
• event.name: "api_request"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• model: 使用されたモデル (例: “claude-sonnet-4-6”)
• cost_usd: 推定コスト (USD)
• duration_ms: リクエスト期間 (ミリ秒単位)
• input_tokens: 入力トークンの数
• output_tokens: 出力トークンの数
• cache_read_tokens: キャッシュから読み取られたトークンの数
• cache_creation_tokens: キャッシュ作成に使用されたトークンの数
• request_id: レスポンスの request-id ヘッダーからの Anthropic API リクエスト ID。例: "req_011..."。API が返す場合のみ存在します。
• speed: "fast" または "normal"、高速モードがアクティブであったかどうかを示します
• query_source: リクエストを発行したサブシステム。例: "repl_main_thread"、"compact"、またはサブエージェント名
• effort: リクエストに適用された努力レベル: "low"、"medium"、"high"、"xhigh"、または "max"。モデルが努力をサポートしない場合は存在しません。

​

API エラーイベント

• すべての標準属性
• event.name: "api_error"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• model: 使用されたモデル (例: “claude-sonnet-4-6”)
• error: エラーメッセージ
• status_code: HTTP ステータスコード (数値)。接続失敗などの非 HTTP エラーの場合は存在しません。
• duration_ms: リクエスト期間 (ミリ秒単位)
• attempt: 試行の総数 (初期リクエストを含む。1 は再試行が発生しなかったことを意味します)
• request_id: レスポンスの request-id ヘッダーからの Anthropic API リクエスト ID。例: "req_011..."。API が返す場合のみ存在します。
• speed: "fast" または "normal"、高速モードがアクティブであったかどうかを示します
• query_source: リクエストを発行したサブシステム。例: "repl_main_thread"、"compact"、またはサブエージェント名
• effort: リクエストに適用された努力レベル。モデルが努力をサポートしない場合は存在しません。

​

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

• すべての標準属性
• event.name: "api_request_body"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• body: JSON シリアル化された Messages API リクエストパラメーター (システムプロンプト、メッセージ、ツールなど)。60 KB で切り詰められます。前のアシスタントターンの拡張思考コンテンツはマスクされます。インラインモード (OTEL_LOG_RAW_API_BODIES=1) でのみ出力されます。
• body_ref: 切り詰められていないボディを含む <dir>/<uuid>.request.json ファイルへの絶対パス。ファイルモード (OTEL_LOG_RAW_API_BODIES=file:<dir>) でのみ出力されます。
• body_length: 切り詰められていないボディの長さ。OTEL_LOG_RAW_API_BODIES=file:<dir> の場合は UTF-8 バイト、=1 の場合は UTF-16 コードユニット
• body_truncated: インライン切り詰めが発生した場合は "true"。ファイルモードおよび切り詰めが発生しなかった場合は存在しません。
• model: リクエストパラメーターからのモデル識別子
• query_source: リクエストを発行したサブシステム (例: "compact")

​

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

• すべての標準属性
• event.name: "api_response_body"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• body: JSON シリアル化された Messages API レスポンス (id、コンテンツブロック、使用状況、停止理由)。60 KB で切り詰められます。拡張思考コンテンツはマスクされます。インラインモード (OTEL_LOG_RAW_API_BODIES=1) でのみ出力されます。
• body_ref: 切り詰められていないボディを含む <dir>/<request_id>.response.json ファイルへの絶対パス。ファイルモード (OTEL_LOG_RAW_API_BODIES=file:<dir>) でのみ出力されます。
• body_length: 切り詰められていないボディの長さ。OTEL_LOG_RAW_API_BODIES=file:<dir> の場合は UTF-8 バイト、=1 の場合は UTF-16 コードユニット
• body_truncated: インライン切り詰めが発生した場合は "true"。ファイルモードおよび切り詰めが発生しなかった場合は存在しません。
• model: モデル識別子
• query_source: リクエストを発行したサブシステム
• request_id: レスポンスの request-id ヘッダーからの Anthropic API リクエスト ID。例: "req_011..."。API が返す場合のみ存在します。

​

ツール決定イベント

• すべての標準属性
• 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"
• source: 決定ソース:
  • "config": プロジェクト設定、ユーザーの個人設定内の許可ルール、エンタープライズ管理ポリシー、--allowedTools または --disallowedTools フラグ、アクティブな権限モード、同じインタラクティブ CLI セッション内の前のプロンプトからのセッションスコープの許可、またはツールが本質的に安全であるため、プロンプトなしで自動的に決定されました。このイベントは、これらのソースのどれが一致したかを示しません。
  • "hook": PreToolUse または PermissionRequest フックが決定を返しました。
  • "user_permanent": ユーザーが権限プロンプトで「はい、今後も同じ対象に対して聞かないでください」を選択し、個人設定に許可ルールを保存した場合に出力されます。インタラクティブ CLI では、その選択自体に対してのみ出力されます。後で保存されたルールに一致する呼び出しは代わりに "config" を出力します。Agent SDK または非インタラクティブ -p セッションでは、初期選択と後のルール一致の両方が "user_permanent" を出力します。受け入れとして扱われます。
  • "user_temporary": ユーザーが権限プロンプトで「はい」を選択した場合、またはファイル編集または読み取りプロンプトで「このセッション中は…」オプションのいずれかを選択した場合に出力されます。インタラクティブ CLI では、その選択自体に対してのみ出力されます。後でそのセッションスコープの許可に一致する呼び出しは代わりに "config" を出力します。Agent SDK または非インタラクティブ -p セッションでは、選択と後の一致の両方が "user_temporary" を出力します。受け入れとして扱われます。
  • "user_abort": ユーザーが権限プロンプトを回答なしで閉じた場合に出力されます。拒否として扱われます。
  • "user_reject": ユーザーがプロンプトされたときに「いいえ」を選択した場合、または呼び出しが個人設定内の拒否ルールに一致した場合に出力されます。拒否として扱われます。

​

権限モード変更イベント

• すべての標準属性
• event.name: "permission_mode_changed"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• from_mode: 前の権限モード。例: "default"、"plan"、"acceptEdits"、"auto"、または "bypassPermissions"
• to_mode: 新しい権限モード
• trigger: 変更の原因。"shift_tab"、"exit_plan_mode"、"auto_gate_denied"、または "auto_opt_in" のいずれか。SDK またはブリッジから発生する場合は存在しません

​

認証イベント

• すべての標準属性
• event.name: "auth"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• action: "login" または "logout"
• success: "true" または "false"
• auth_method: 認証方法。例: "oauth"
• error_category: アクションが失敗した場合のカテゴリエラー種別。生のエラーメッセージは含まれません
• status_code: アクションが HTTP エラーで失敗した場合の HTTP ステータスコード (文字列)

​

MCP サーバー接続イベント

• すべての標準属性
• event.name: "mcp_server_connection"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• status: "connected"、"failed"、または "disconnected"
• transport_type: サーバートランスポート。例: "stdio"、"sse"、または "http"
• server_scope: サーバーが設定されているスコープ。例: "user"、"project"、または "local"
• duration_ms: 接続試行期間 (ミリ秒単位)
• error_code: 接続が失敗した場合のエラーコード
• server_name (OTEL_LOG_TOOL_DETAILS=1 の場合): 設定されたサーバー名
• error (OTEL_LOG_TOOL_DETAILS=1 の場合): 接続が失敗した場合の完全なエラーメッセージ

​

内部エラーイベント

• すべての標準属性
• event.name: "internal_error"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• error_name: エラークラス名。例: "TypeError" または "SyntaxError"
• error_code: エラーに存在する場合の Node.js errno コード。例: "ENOENT"

​

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

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

​

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

• すべての標準属性
• event.name: "plugin_loaded"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• plugin.name: プラグインの名前。公式マーケットプレイスおよび組み込みバンドルの外部にあるプラグインの場合、OTEL_LOG_TOOL_DETAILS=1 が設定されていない限り値は "third-party" です
• marketplace.name: プラグインがインストールされたマーケットプレイス (既知の場合)。plugin.name と同じ条件下で "third-party" に編集されます
• plugin.version: プラグインマニフェストからのバージョン。名前が編集されていない場合、およびマニフェストがバージョンを宣言している場合にのみ含まれます
• plugin.scope: プラグインの出所カテゴリ: "official"、"org"、"user-local"、または "default-bundle"
• enabled_via: プラグインが有効になった方法: "default-enable"、"org-policy"、"seed-mount"、または "user-install"
• plugin_id_hash: プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。フリート全体で読み込まれているサードパーティプラグインの数をカウントできます。その名前を記録することなく
• has_hooks: プラグインがフックに貢献するかどうか
• has_mcp: プラグインが MCP サーバーに貢献するかどうか
• skill_path_count: プラグインが宣言するスキルディレクトリの数
• command_path_count: プラグインが宣言するコマンドディレクトリの数
• agent_path_count: プラグインが宣言するエージェントディレクトリの数

​

スキル有効化イベント

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

​

@ メンションイベント

• すべての標準属性
• event.name: "at_mention"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• mention_type: メンションのタイプ ("file"、"directory"、"agent"、"mcp_resource")
• success: メンションが正常に解決されたかどうか ("true" または "false")

​

API 再試行枯渇イベント

• すべての標準属性
• event.name: "api_retries_exhausted"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• model: 使用されたモデル
• error: 最終エラーメッセージ
• status_code: HTTP ステータスコード (数値)。非 HTTP エラーの場合は存在しません。
• total_attempts: 試行の総数
• total_retry_duration_ms: すべての試行にわたる実時間
• speed: "fast" または "normal"

​

フック登録イベント

• すべての標準属性
• event.name: "hook_registered"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• hook_event: フックイベントタイプ。例: "PreToolUse" または "PostToolUse"
• hook_type: フック実装タイプ: "command"、"prompt"、"mcp_tool"、"http"、または "agent"
• hook_source: フックが定義されている場所: "userSettings"、"projectSettings"、"localSettings"、"flagSettings"、"policySettings"、または "pluginHook"
• 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" の場合): プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。その名前を記録することなく、貢献するプラグインの数をカウントできます

​

フック実行開始イベント

• すべての標準属性
• 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"
• hook_definitions: JSON シリアル化されたフック設定。詳細なベータトレースと OTEL_LOG_TOOL_DETAILS=1 の両方が有効な場合にのみ含まれます

​

フック実行完了イベント

• すべての標準属性
• event.name: "hook_execution_complete"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• hook_event: フックイベントタイプ
• hook_name: マッチャーを含む完全なフック名
• num_hooks: 一致するフックコマンドの数
• num_success: 正常に完了した数
• num_blocking: ブロッキング決定を返した数
• num_non_blocking_error: ブロックなしで失敗した数
• num_cancelled: 完了前にキャンセルされた数
• total_duration_ms: すべての一致するフックの実時間
• managed_only: 管理ポリシーフックのみが許可されている場合は "true"
• hook_source: "policySettings" または "merged"
• hook_definitions: JSON シリアル化されたフック設定。詳細なベータトレースと OTEL_LOG_TOOL_DETAILS=1 の両方が有効な場合にのみ含まれます

​

圧縮イベント

• すべての標準属性
• event.name: "compaction"
• event.timestamp: ISO 8601 タイムスタンプ
• event.sequence: セッション内のイベントを順序付けするための単調増加カウンター
• trigger: "auto" または "manual"
• success: "true" または "false"
• duration_ms: 圧縮期間
• pre_tokens: 圧縮前のおおよそのトークン数
• post_tokens: 圧縮後のおおよそのトークン数
• error: 圧縮が失敗した場合のエラーメッセージ

​

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

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

​

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

​

使用状況監視

​

コスト監視

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

​

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

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

​

再試行枯渇の検出

​

イベント分析

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

​

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

​

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

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

​

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

​

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

​

SIEM にイベントを送信する

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

​

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

​

メトリクスの場合

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

​

イベント/ログの場合

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

​

トレースの場合

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

​

サービス情報

• service.name: claude-code
• service.version: 現在の Claude Code バージョン
• os.type: オペレーティングシステムタイプ (例: linux、darwin、windows)
• os.version: オペレーティングシステムバージョン文字列
• host.arch: ホストアーキテクチャ (例: amd64、arm64)
• wsl.version: WSL バージョン番号 (Windows Subsystem for Linux で実行している場合のみ存在)
• メーター名: com.anthropic.claude_code

​

ROI 測定リソース

​

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

• OpenTelemetry エクスポートはオプトインであり、明示的な設定が必要です。Anthropic の個別の運用テレメトリと無効化方法については、データ使用を参照してください
• 生のファイルコンテンツとコードスニペットはメトリクスやイベントに含まれません。トレーススパンは別のデータパスです: 以下の OTEL_LOG_TOOL_CONTENT の項目を参照してください
• OAuth 経由で認証された場合、user.email はテレメトリ属性に含まれます。これが組織にとって懸念事項である場合は、テレメトリバックエンドと協力してこのフィールドをフィルタリングまたはマスクしてください
• ユーザープロンプトコンテンツはデフォルトでは収集されません。プロンプト長のみが記録されます。プロンプトコンテンツを含めるには、OTEL_LOG_USER_PROMPTS=1 を設定します
• ツール入力引数とパラメーターはデフォルトではログされません。これらを含めるには、OTEL_LOG_TOOL_DETAILS=1 を設定します。有効にすると、tool_result イベントには Bash コマンド、MCP サーバーとツール名、スキル名を含む tool_parameters 属性、およびファイルパス、URL、検索パターン、その他の引数を含む tool_input 属性が含まれます。user_prompt イベントには、カスタム、プラグイン、MCP コマンドの逐語的な command_name が含まれます。トレーススパンには同じ tool_input 属性と file_path などの入力派生属性が含まれます。512 文字を超える個別の値は切り詰められ、合計は約 4 K 文字に制限されますが、引数には機密値が含まれる可能性があります。必要に応じてこれらの属性をフィルタリングまたはマスクするようにテレメトリバックエンドを設定してください
• ツール入力と出力コンテンツはデフォルトではトレーススパンでログされません。これを含めるには、OTEL_LOG_TOOL_CONTENT=1 を設定します。有効にすると、スパンイベントには 60 KB で切り詰められたツール入力と出力コンテンツが含まれます。これには Read ツール結果からの生のファイルコンテンツと Bash コマンド出力が含まれる可能性があります。必要に応じてこれらの属性をフィルタリングまたはマスクするようにテレメトリバックエンドを設定してください
• 生の Anthropic Messages API リクエストとレスポンスボディはデフォルトではログされません。これらを含めるには、OTEL_LOG_RAW_API_BODIES を設定します。=1 の場合、各 API 呼び出しは api_request_body および api_response_body ログイベントを出力し、その body 属性は JSON シリアル化されたペイロードで、60 KB で切り詰められます。=file:<dir> の場合、切り詰められていないボディはそのディレクトリの下の .request.json および .response.json ファイルに書き込まれ、イベントはテレメトリストリームではなくログコレクターまたはサイドカーで配信されるディレクトリを含む body_ref パスを持ちます。両方のモードで、ボディには完全な会話履歴 (システムプロンプト、すべての前のユーザーとアシスタントターン、ツール結果) が含まれるため、これを有効にすることは他の OTEL_LOG_* コンテンツフラグが明かすすべてのものに同意することを意味します。Claude の拡張思考コンテンツは、他の設定に関係なく、これらのボディから常にマスクされます

​

Amazon Bedrock での Claude Code の監視