はじめに
2026/04/20時点での以下のページの内容をわかりやすくまとめ直したものになります。
標準属性(全データ共通)
すべてのメトリクス・イベント・トレースに付与されます。
| 属性名 |
内容 |
備考 |
session.id |
セッション識別子 |
OTEL_METRICS_INCLUDE_SESSION_ID(デフォルト: 有効) |
app.version |
Claude Code バージョン |
OTEL_METRICS_INCLUDE_VERSION(デフォルト: 無効) |
organization.id |
組織 UUID |
認証時のみ |
user.account_uuid |
アカウント UUID |
OTEL_METRICS_INCLUDE_ACCOUNT_UUID(デフォルト: 有効) |
user.account_id |
タグ付き形式のアカウント ID(例: user_01BWBeN28…) |
同上 |
user.id |
インストールごとの匿名デバイス識別子 |
常に含まれる |
user.email |
ユーザーメールアドレス |
OAuth 認証時のみ |
terminal.type |
ターミナル種別(iTerm.app / vscode / cursor / tmux など) |
検出時のみ |
イベント専用の追加属性(メトリクスには含まれない)
| 属性名 |
内容 |
prompt.id |
1プロンプトに紐づく全イベントを相関させる UUID v4 |
workspace.host_paths |
選択されたワークスペースディレクトリ(文字列配列) |
メトリクス(OTEL_METRICS_EXPORTER を設定)
1. claude_code.session.count — セッションカウンター
| 項目 |
内容 |
| 単位 |
count |
| タイミング |
各 CLI セッション開始時にインクリメント |
| 追加属性 |
なし(標準属性のみ) |
2. claude_code.lines_of_code.count — コード行カウンター
| 項目 |
内容 |
| 単位 |
count |
| タイミング |
コードが追加・削除されたときにインクリメント |
追加属性:
| 属性名 |
値 |
type |
"added" または "removed"
|
3. claude_code.pull_request.count — PR カウンター
| 項目 |
内容 |
| 単位 |
count |
| タイミング |
Claude Code 経由で PR を作成した時 |
| 追加属性 |
なし(標準属性のみ) |
4. claude_code.commit.count — コミットカウンター
| 項目 |
内容 |
| 単位 |
count |
| タイミング |
Claude Code 経由で git コミットを作成した時 |
| 追加属性 |
なし(標準属性のみ) |
5. claude_code.cost.usage — コストカウンター
| 項目 |
内容 |
| 単位 |
USD |
| タイミング |
各 API リクエスト完了後にインクリメント |
追加属性:
| 属性名 |
値 |
model |
モデル識別子(例: claude-sonnet-4-6) |
⚠️ 概算値。正式な請求は API プロバイダー(Claude Console / AWS Bedrock / Google Cloud Vertex)を参照。
6. claude_code.token.usage — トークンカウンター
| 項目 |
内容 |
| 単位 |
tokens |
| タイミング |
各 API リクエスト完了後にインクリメント |
追加属性:
| 属性名 |
値 |
type |
"input" / "output" / "cacheRead" / "cacheCreation"
|
model |
モデル識別子(例: claude-sonnet-4-6) |
7. claude_code.code_edit_tool.decision — コード編集ツール決定カウンター
| 項目 |
内容 |
| 単位 |
count |
| タイミング |
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") |
8. claude_code.active_time.total — アクティブ時間カウンター
| 項目 |
内容 |
| 単位 |
s(秒) |
| タイミング |
ユーザー操作中・CLI 処理中(ツール実行・AI 応答生成)に加算。アイドル時間は含まない |
追加属性:
| 属性名 |
値 |
type |
"user": キーボード操作・応答読み取り / "cli": ツール実行・AI 応答生成 |
イベント / ログ(OTEL_LOGS_EXPORTER を設定)
1. claude_code.user_prompt — ユーザープロンプトイベント
ユーザーがプロンプトを送信するときにログされます。
| 属性名 |
内容 |
備考 |
event.name |
"user_prompt" |
|
event.timestamp |
ISO 8601 タイムスタンプ |
|
event.sequence |
セッション内イベント順序番号(単調増加) |
|
prompt_length |
プロンプトの文字数 |
常に記録 |
prompt |
プロンプト本文 |
OTEL_LOG_USER_PROMPTS=1 で有効化(デフォルト: 収集されない) |
2. claude_code.tool_result — ツール結果イベント
ツールが実行を完了するときにログされます。
| 属性名 |
内容 |
備考 |
event.name |
"tool_result" |
|
event.timestamp |
ISO 8601 タイムスタンプ |
|
event.sequence |
セッション内イベント順序番号 |
|
tool_name |
ツール名 |
|
success |
"true" または "false"
|
|
duration_ms |
実行時間(ミリ秒) |
|
error |
エラーメッセージ |
失敗時のみ |
decision_type |
"accept" または "reject"
|
|
decision_source |
config / hook / user_permanent / user_temporary / user_abort / user_reject
|
|
tool_result_size_bytes |
ツール結果のサイズ(バイト) |
|
mcp_server_scope |
MCP サーバースコープ識別子 |
MCP ツール使用時のみ |
tool_parameters |
ツール固有パラメーター JSON |
OTEL_LOG_TOOL_DETAILS=1 で有効化(デフォルト: 無効) |
tool_input |
JSON シリアル化されたツール引数(512文字超は切り詰め・全体4K文字上限) |
OTEL_LOG_TOOL_DETAILS=1 で有効化(デフォルト: 無効) |
tool_parameters の内訳:
| ツール種別 |
含まれるフィールド |
| Bash ツール |
bash_command, full_command, timeout, description, dangerouslyDisableSandbox, git_commit_id(git commit 成功時の SHA) |
| MCP ツール |
mcp_server_name, mcp_tool_name
|
| Skill ツール |
skill_name |
3. claude_code.api_request — API リクエストイベント
Claude への各 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 |
キャッシュ作成トークン数 |
|
speed |
"fast" または "normal"
|
高速モードの有無 |
4. claude_code.api_error — API エラーイベント
Claude への API リクエストが失敗するときにログされます。
| 属性名 |
内容 |
備考 |
event.name |
"api_error" |
|
event.timestamp |
ISO 8601 タイムスタンプ |
|
event.sequence |
セッション内イベント順序番号 |
|
model |
使用モデル |
|
error |
エラーメッセージ |
|
status_code |
HTTP ステータスコード(非 HTTP エラーは "undefined") |
|
duration_ms |
リクエスト時間(ミリ秒) |
|
attempt |
試行番号 |
リトライ時 |
speed |
"fast" または "normal"
|
高速モードの有無 |
5. claude_code.tool_decision — ツール決定イベント
ツール権限の承認・拒否が行われるときにログされます。
| 属性名 |
内容 |
備考 |
event.name |
"tool_decision" |
|
event.timestamp |
ISO 8601 タイムスタンプ |
|
event.sequence |
セッション内イベント順序番号 |
|
tool_name |
ツール名(Read / Edit / Write / NotebookEdit など) |
|
decision |
"accept" または "reject"
|
|
source |
config / hook / user_permanent / user_temporary / user_abort / user_reject
|
|
トレース(ベータ)
有効化には CLAUDE_CODE_ENABLE_TELEMETRY=1 と CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 の両方を設定し、OTEL_TRACES_EXPORTER でエクスポート先を指定します。
| 項目 |
内容 |
| スパン構造 |
ユーザープロンプト → API リクエスト → ツール実行 を親子スパンでリンク |
| prompt テキスト |
デフォルト: マスク。OTEL_LOG_USER_PROMPTS=1 で有効化 |
| ツール入出力コンテンツ |
デフォルト: マスク。OTEL_LOG_TOOL_CONTENT=1 で有効化(60 KB 上限) |
| 含まれうるコンテンツ |
Read ツール結果の生ファイル内容、Bash コマンド出力など |
サービス情報(全シグナル共通リソース属性)
| 属性名 |
値・説明 |
service.name |
claude-code |
service.version |
現在の Claude Code バージョン |
os.type |
OS 種別(linux / darwin / windows) |
os.version |
OS バージョン文字列 |
host.arch |
ホストアーキテクチャ(amd64 / arm64) |
wsl.version |
WSL バージョン番号(WSL 環境のみ) |
オプション設定まとめ
| 環境変数 |
効果 |
デフォルト |
OTEL_LOG_USER_PROMPTS=1 |
user_prompt イベントにプロンプト本文を含める |
無効(長さのみ記録) |
OTEL_LOG_TOOL_DETAILS=1 |
tool_result イベントに tool_parameters と tool_input を含める |
無効 |
OTEL_LOG_TOOL_CONTENT=1 |
トレーススパンにツール入出力コンテンツを含める(60 KB 上限)。トレース有効化(CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1)が前提
|
無効 |
OTEL_METRICS_INCLUDE_SESSION_ID |
メトリクスに session.id を含める |
true |
OTEL_METRICS_INCLUDE_VERSION |
メトリクスに app.version を含める |
false |
OTEL_METRICS_INCLUDE_ACCOUNT_UUID |
メトリクスに user.account_uuid / user.account_id を含める |
true |
CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 |
分散トレース(スパン)を有効化(ENABLE_ENHANCED_TELEMETRY_BETA=1 も同義) |
無効 |
関連書籍