Claude Code OpenTelemetry完全ガイド｜企業向け利用状況モニタリング・コスト追跡・監査ログ設定

# テレメトリを有効化
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# コンソールに出力（動作確認用）
export OTEL_METRICS_EXPORTER=console
export OTEL_LOGS_EXPORTER=console

# エクスポート間隔を短くして確認しやすくする
export OTEL_METRIC_EXPORT_INTERVAL=5000  # 5秒ごと

claude

export CLAUDE_CODE_ENABLE_TELEMETRY=1

# メトリクスとログをOTLPで送信
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp

# プロトコルとエンドポイントを指定
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 認証ヘッダー（バックエンドが必要とする場合）
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

claude

# カンマ区切りで複数のエクスポーターを指定
export OTEL_METRICS_EXPORTER=console,otlp
export OTEL_LOGS_EXPORTER=console,otlp

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf

# Datadogエージェントのエンドポイント（ローカルエージェント経由）
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318

# または直接Datadog OTLPエンドポイントへ（エージェント不要）
# export OTEL_EXPORTER_OTLP_ENDPOINT=https://api.datadoghq.com/api/intake/otlp/v1/metrics
# export OTEL_EXPORTER_OTLP_HEADERS="DD-API-KEY=your-datadog-api-key"

export CLAUDE_CODE_ENABLE_TELEMETRY=1

# Prometheusスクレイプ形式でエクスポート
export OTEL_METRICS_EXPORTER=prometheus

# PrometheusがスクレイプするポートとパスはOTel SDKが自動設定
# デフォルト: http://localhost:9464/metrics

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.nr-data.net:4317
export OTEL_EXPORTER_OTLP_HEADERS="api-key=your-new-relic-license-key"

# 部門・チーム情報を属性として付与
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

# 注意: スペースや特殊文字は使えない（アンダースコアで代替）
# NG: export OTEL_RESOURCE_ATTRIBUTES="team.name=Platform Team"
# OK: export OTEL_RESOURCE_ATTRIBUTES="team.name=Platform_Team"

{
  "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.your-company.internal:4317"
  }
}

#!/bin/bash
# 認証トークンを取得して JSON で出力
TOKEN=$(curl -s -X POST https://auth.internal/token \
  -d "grant_type=client_credentials&client_id=claude-code" \
  | jq -r '.access_token')

echo "{"Authorization": "Bearer ${TOKEN}"}"

{
  "otelHeadersHelper": "~/.claude/generate-otel-headers.sh",
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317"
  }
}

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_ENDPOINT=http://siem.company.internal:4317

# ツール名をログに含める（セキュリティ監査向け）
export OTEL_LOG_TOOL_DETAILS=1

# プロンプト内容もログに含める場合（機密情報に注意）
# export OTEL_LOG_USER_PROMPTS=1