CC逆引きリファレンス

OpenTelemetry でログ・メトリクスを収集したい

12. CI/CD・自動化

コマンド / 機能

OTEL_LOG_ASSISTANT_RESPONSES / OTEL_LOG_TOOL_DETAILS / OTEL_RESOURCE_ATTRIBUTES

OTEL連携の詳細設定

概要

Claude Code は OpenTelemetry によるログ・メトリクス出力に対応しています。OTEL_LOG_ASSISTANT_RESPONSES で応答本文のログ出力、OTEL_LOG_TOOL_DETAILS でツール実行の詳細ログ出力を有効化でき、OTEL_RESOURCE_ATTRIBUTES で任意のリソース属性（環境名、チーム名など）を付与できます。

設定例

# 応答本文もログに含める
export OTEL_LOG_ASSISTANT_RESPONSES=1

# ツール実行の詳細（引数・結果）をログに含める
export OTEL_LOG_TOOL_DETAILS=1

# リソース属性を付与して集計しやすくする
export OTEL_RESOURCE_ATTRIBUTES="service.name=claude-code,deployment.environment=ci,team=platform"

claude -p "テストを実行して"
公式ドキュメントを見る

こんな時に使う

  • 社内の可観測性基盤（Datadog, Grafana等）にClaude Codeの利用状況を集約したい時
  • チーム別・環境別に利用状況を分析したい時
  • 監査のため詳細なツール実行ログを残したい時

使い方

  1. 1OTEL_LOG_ASSISTANT_RESPONSES=1 で応答本文をログ出力
  2. 2OTEL_LOG_TOOL_DETAILS=1 でツール引数・結果を詳細出力
  3. 3OTEL_RESOURCE_ATTRIBUTES でカンマ区切りの key=value 属性を付与

Tips

  • 応答本文やツール詳細には機密情報が含まれる可能性があるため送信先のアクセス制御に注意
  • OTEL基盤自体のセットアップ（エンドポイント等）は別途必要
  • エンタープライズでの利用状況の一元監視に有効

同じカテゴリの記事

非対話で実行したい
claude -p "query"
JSON 出力したい
claude -p --output-format json "query"
ストリーミング JSON 出力したい
--output-format stream-json
テキスト出力したい
--output-format text
ターン数を制限したい
claude -p --max-turns 3 "query"
パイプで入力したい
echo "query" | claude -p
前の記事
PTY付きバックグラウンドジョブとしてコマンドを実行したい
次の記事
Bedrock/Vertex/Foundry で自動モードを使いたい