Agent Console 설정

문서 > Agent Console > Agent Console 설정

모니터링하려는 각 코딩 에이전트에 대한 통합을 Agent Console에서 설정합니다.

Claude Code

옵션 1: Anthropic 사용량 및 비용 통합(추천)

Agent Console에서 Claude Code를 모니터링하려면 Anthropic 사용량 및 비용 통합을 설정합니다.

설정 후 Agent Console로 이동한 다음 Claude Code 타일을 클릭하여 메트릭을 확인합니다.

옵션 2: OpenTelemetry(OTLP)

다음 절차는 Claude Code가 OpenTelemetry 프로토콜(OTLP)을 사용하여 Datadog에 직접 텔레메트리를 전송하도록 구성합니다.

로그 구성에 모든 로그를 포괄하는 인덱스 또는 service:claude-code에 해당하는 인덱스가 포함되어 있는지 확인합니다.
Datadog API 키를 생성합니다.

Claude Code 설정 파일(예: ~/.claude/settings.json)에 다음과 같은 환경 변수를 설정합니다.

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_LOGS_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_METRICS_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT": "",
    "OTEL_EXPORTER_OTLP_HEADERS": "dd-api-key=<DATADOG_API_KEY>"
  }
}

Replace <DATADOG_API_KEY> with your Datadog API key.

To set up Agent Console for Claude Code across your organization, your IT team can use a Mobile Device Management (MDM) system or server-managed settings to distribute the Claude Code settings file across all managed devices.

Restart Claude Code.

After you restart Claude Code, navigate to the Agent Console and click the Claude Code tile. Metrics (usage, cost, latency, errors) should appear within a few minutes.

Option 3: Forward data through the Datadog Agent

Make sure that your Logs configuration includes a catch-all index, or an index that covers service:claude-code.
Install the Datadog Agent.

Configure your Datadog Agent to enable the OpenTelemetry Collector:

otlp_config:
  receiver:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
  logs:
    enabled: true
otelCollector:
  enabled: true

Claude Code 설정 파일(예: ~/.claude/settings.json)에 다음과 같은 환경 변수를 설정합니다.
```
{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://127.0.0.1:4317",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_METRIC_EXPORT_INTERVAL": "10000"
  }
}
```
조직 전체에서 Claude Code에 대한 Agent Console을 설정하려면 IT 팀이 MDM(모바일 기기 관리) 시스템 또는 서버 관리 설정을 사용하여 모든 관리 기기에 Claude Code 설정 파일을 배포할 수 있습니다.
Claude Code를 재시작합니다.