https://code.claude.com/docs/en/monitoring-usage
概要
- Claude CodeではOpenTelemetryの活用が可能
- Claude Code利用時に発生した、
ログ・メトリクス・トレースなどのテレメトリーデータをエクスポートできる
※おそらくトレースについては、まだβ版: https://code.claude.com/docs/en/monitoring-usage#traces-beta ※必要に応じて追加するでよさそう
Quick Start: 個人環境
個人環境における、環境変数による設定方法は以下の通り。
# 1. Enable telemetry
export CLAUDE_CODE_ENABLE_TELEMETRY=1
# 2. Choose exporters (both are optional - configure only what you need)
export OTEL_METRICS_EXPORTER=otlp # Options: otlp, prometheus, console, none
export OTEL_LOGS_EXPORTER=otlp # Options: otlp, console, none
# 3. Configure OTLP endpoint (for OTLP exporter)
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
# 4. Set authentication (if required)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"
# 5. For debugging: reduce export intervals
export OTEL_METRIC_EXPORT_INTERVAL=10000 # 10 seconds (default: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000 # 5 seconds (default: 5000ms)
# 6. Run Claude Code
claude
管理者設定
参考: https://code.claude.com/docs/en/monitoring-usage#administrator-configuration
管理者が、managed settings file（管理者が上から適用するガードレール/管理者ポリシー）経由で利用者のOTel設定を一括で実施することが可能。managed settings fileはユーザーからの上書きは不可。
組織の場合は、基本的にはこちらを実施することになりそう。
{
"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"
}
}
管理設定は、MDM（モバイルデバイス管理）やその他のデバイス管理ソリューションを通じて配布できます。管理設定ファイルで定義された環境変数は優先度が高く、ユーザーによって上書きすることはできません。
具体的な管理設定の手法は以下の３つのいずれか。
- MDM/OS policy
- Server-managed settings
- File-based managed settings
以下の理由から、会社組織の場合の最優先はMDMを利用した配信。
- 各PCに同じ設定を自動で配れるため、設定漏れや手作業ミスを減らせる
- ユーザーが勝手に設定を変えにくく、社内ルールを守りやすい
- 端末の管理画面から一括で更新でき、運用コストを下げられる
- 「誰にどの設定が入っているか」を追いやすく、監査やトラブル対応がしやすい
- 既存の端末管理（Jamf/Intuneなど）に乗せられるため、導入と保守がスムーズ