1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude CodeのOpenTelemetryで取得できるデータ一覧

1
Posted at

はじめに

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=1CLAUDE_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_parameterstool_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 も同義) 無効

関連書籍

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?