미리 보기
Agent Console은 현재 미리 보기로 제공되고 있으며 모든 Datadog 고객이 사용할 수 있습니다.
Agent Console을 설정하려면 모니터링할 AI 도구를 연결하고, 선택적으로 생산성 도구를 연결한 다음 도구 전반에서 사용자 ID를 매핑하세요. Agent Console Settings의 Setup 페이지는 각 단계의 진행 상황을 추적합니다.
권한
Agent Console 액세스는 다음 역할 권한에 의해 제어됩니다. Organization Settings > Roles에서 해당 권한을 역할에 할당하세요.
| 권한 | 설명 |
|---|
agent_console_read | Overview, My Usage, Usage, Settings를 포함한 Agent Console을 확인합니다. 이 권한이 없는 사용자는 Agent Console을 열 수 없습니다. |
agent_console_write | ID 매핑 및 통합 설정과 같은 Agent Console 구성을 변경합니다. |
Agent Console을 처음 열 때 나타나는 Set up your AI tools 페이지에서 연결할 AI 도구를 선택하세요. 데이터를 확인하려면 최소 하나의 도구를 연결해야 합니다. 나중에 도구를 더 추가할 수 있습니다.
Anthropic 제품
Claude Code, Claude Chat, Claude Cowork 및 Claude Design을 모니터링하려면 Anthropic 사용량 및 비용 통합을 설정하세요. 이 통합은 각 Claude 제품에 대한 일일 지출 및 사용자 분석 데이터를 수집합니다.
Anthropic 사용량 및 비용 통합은 Claude Team 플랜을 지원하지 않습니다. 조직에서 Team 플랜을 사용하는 경우, 대신 OpenTelemetry를 사용하여 Claude Code 텔레메트리 데이터를 Datadog으로 전송하세요.
OpenTelemetry를 사용하는 Claude Code
OpenTelemetry(OTLP)를 사용하여 Claude Code 텔레메트리 데이터를 Datadog으로 직접 전송하세요. 이 방식으로 수집된 데이터는 Agent Console의 Claude Code (OTel) 카드에 표시됩니다.
조직 전체에서 Claude Code에 대한 Agent Console을 설정하려면 IT 팀이 MDM(모바일 기기 관리) 시스템 또는 서버 관리 설정을 사용하여 모든 관리 기기에 Claude Code 설정 파일을 배포할 수 있습니다.
로그 구성에 모든 로그를 포괄하는 인덱스 또는 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": "<span class="js-region-param region-param" data-region-param="otlp_logs_endpoint"></span>",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_EXPORTER_OTLP_METRICS_PROTOCOL": "http/protobuf",
"OTEL_EXPORTER_OTLP_METRICS_ENDPOINT": "<span class="js-region-param region-param" data-region-param="otlp_metrics_endpoint"></span>",
"OTEL_EXPORTER_OTLP_HEADERS": "dd-api-key=<DATADOG_API_KEY>"
}
}
Replace <DATADOG_API_KEY> with your Datadog API key.
Restart Claude Code.
- 로그 구성에 모든 로그를 포괄하는 인덱스 또는
service:claude-code에 해당하는 인덱스가 포함되어 있는지 확인합니다. - Datadog Agent를 설치합니다.
- OpenTelemetry Collector를 활성화하도록 Datadog Agent를 구성합니다.
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를 재시작합니다.
Claude Code를 다시 시작하면 몇 분 내에 Agent Console에 메트릭(사용량, 비용, 지연 시간, 오류)이 표시됩니다.
Codex
Codex를 모니터링하려면 OpenAI Codex 통합을 설정하세요. 이 통합은 일일 사용량, 크레딧, 코드 기여도 및 검토 분석을 수집합니다.
ChatGPT Work
ChatGPT Work를 모니터링하려면 OpenAI 통합을 설정하세요. 이 통합은 활동, 토큰 및 예상 비용 분석을 수집합니다.
Cursor
Cursor를 모니터링하려면 Cursor용 Datadog Extension을 사용하여 Cursor 통합을 설정하세요. 이 통합은 하루에 한 번 지출 메트릭과 사용자 분석 데이터를 수집합니다.
GitHub Copilot
GitHub Copilot을 모니터링하려면 GitHub Copilot 통합을 설정합니다. 이 통합은 하루에 한 번 지출 메트릭과 사용자 분석 데이터를 수집합니다.
Microsoft Copilot 365
미리 보기
Microsoft Copilot 365 지원은 미리 보기로 제공되고 있습니다. 액세스를 요청하려면 Datadog 계정 팀에 문의하세요.
Microsoft Copilot 통합은 일일 Microsoft 365 Copilot 도입 데이터와 메타데이터 전용 상호 작용 분석 데이터를 수집합니다.
Trajectory를 사용하는 기타 코딩 및 데스크톱 에이전트
Trajectory는 Claude Code, Claude Desktop, Codex CLI, Cursor, Cline, Windsurf, Zed 등 30개 이상의 코딩 및 데스크톱 에이전트에서 세션을 캡처하여 Datadog으로 전송하는 오픈 소스 도구입니다. 전체 목록 및 버전 요구 사항은 지원되는 클라이언트를 참조하세요.
Trajectory 세션 데이터는 Agent Console의 Tasks, Skills, Tools 및 Sessions 뷰에 사용됩니다.
설치 프로그램을 실행하여 현재 사용자를 위해 Trajectory를 설치하세요.
bash <(curl -fsSL https://raw.githubusercontent.com/datadog-labs/trajectory/main/install.sh)
설치 프로그램은 플랫폼에 맞는 최신 Trajectory 릴리스를 다운로드하고 trajectory setup을 실행한 다음, 발견된 코딩 에이전트를 연결합니다. 메시지가 표시되면 Datadog API 키를 입력하여 Datadog으로 데이터를 전송하세요.
나중에 Datadog 대상을 구성하려면 다음을 실행합니다.
trajectory publish destination configure
Trajectory를 업그레이드하려면 설치 프로그램을 다시 실행합니다.
Jamf Pro 또는 Microsoft Intune과 같은 MDM 또는 UEM 제품을 사용하여 개발자 컴퓨터에 Trajectory를 배포하려면 관리형 엔드포인트 관리자 가이드를 따르세요. 이 가이드에서는 패키지 준비, 정책 배포, 코딩 에이전트 선택 및 확인 과정을 다룹니다.
통합 요청
모니터링하려는 도구가 목록에 없으면 Set up your AI tools 페이지에서 Request an Integration을 클릭합니다.
선택적으로 생산성 도구를 연결하면 Agent Console에서 AI 비용과 함께 병합된 풀 리퀘스트, 병합까지 걸린 시간, 풀 리퀘스트당 비용 및 해결된 이슈를 표시할 수 있습니다.
- GitHub: GitHub 통합을 설정하여 풀 리퀘스트 데이터를 수집합니다.
- Jira: Jira 통합을 설정하여 이슈 데이터를 수집합니다.
ID 매핑
각 AI 도구는 이메일 주소, GitHub 로그인 또는 Microsoft 사용자 주체 이름(UPN) 등 서로 다른 방식으로 사용자를 식별합니다. 모든 도구의 사용량과 비용이 올바른 사람에게 귀속되도록 ID 매핑 표를 업로드하세요.
Agent Console에서 Settings > Identity Mapping으로 이동합니다.
사람당 한 행과 다음 열이 포함된 CSV 파일을 준비합니다.
| 열 | 요구 사항 |
|---|
email | 필수 |
github_login | GitHub를 사용하는 경우 필수 |
microsoft_upn | 선택 사항 |
jira_account_id | 선택 사항 |
datadog_handle | 선택 사항 |
여러 이메일 별칭, GitHub 로그인 또는 Jira 계정 ID는 세미콜론으로 구분합니다. 첫 번째 이메일이 표준 이메일입니다.
email과 같은 고유한 값이 있는 열을 기본 식별자로 선택합니다. 직원 ID와 같이 이 목적을 위한 열을 직접 추가할 수도 있습니다.
CSV 파일을 업로드하고(최대 10 MiB), 매핑을 미리 본 다음 저장합니다.
데이터 검증
도구를 연결한 후 Agent Console을 열고 연결된 각 통합이 Overview 탭에서 활성 상태로 표시되는지 검사합니다. 대부분의 통합은 하루에 한 번 데이터를 수집하므로 데이터가 표시되기까지 최대 24시간이 걸릴 수 있습니다.
추가 자료