지원 사이트
| 사이트 | URL |
|---|---|
| US1 | app.datadoghq.com |
| US3 | us3.datadoghq.com |
| US5 | us5.datadoghq.com |
| EU1 | app.datadoghq.eu |
| AP1 | ap1.datadoghq.com |
| AP2 | ap2.datadoghq.com |
사전 요구 사항
Datadog API 키와 범위 지정된 Application 키가 필요합니다. API 키 생성:- Datadog 계정에서 Organization Settings → API Keys로 이동합니다.
- + New Key를 클릭하고 이름(예:
CloudThinker)을 지정한 후 저장합니다. - 키 값을 복사합니다.
- Organization Settings → Application Keys로 이동합니다.
- + New Key를 클릭하고 이름(예:
CloudThinker)을 지정합니다. - Scopes에서 필요 권한에 나열된 권한을 선택합니다.
- 저장하고 키 값을 복사합니다.
설정
연결 세부 정보
| 필드 | 설명 | 예시 |
|---|---|---|
| Site | 계정에 맞는 Datadog 사이트 | US1 (datadoghq.com) |
| API Key | Datadog API 키 | — |
| Application Key | 명시적 범위가 있는 Datadog Application 키 | — |
필요 권한
Application 키 생성 시 이 범위를 선택합니다. 읽기 범위는 모든 조사 도구를 지원합니다.notebooks_write는 선택 사항으로 노트북 생성을 활성화합니다.
| 범위 | 활성화 기능 |
|---|---|
logs_read_data, logs_read_index_data | 로그 검색 및 분석 |
metrics_read, timeseries_query | 메트릭 및 시계열 데이터 쿼리 |
monitors_read | 상태 및 태그로 모니터 검색 |
incidents_read | 인시던트 검색 및 세부 정보 조회 |
dashboards_read | 대시보드 구성 검사 |
hosts_read | 인프라 호스트 목록 조회 및 검사 |
apm_read | 트레이스 조회 및 APM 스팬 검색 |
apm_service_catalog_read | 서비스 목록 조회 및 의존성 매핑 |
events_read | 플랫폼 및 커스텀 이벤트 검색 |
notebooks_read | 조사 노트북 검색 및 조회 |
rum_apps_read | Real User Monitoring 데이터 검색 |
notebooks_write | 조사 노트북 생성 및 편집 (선택) |
에이전트 기능
연결 후 에이전트는 Datadog 환경 전반에서 읽기 및 쓰기 작업을 수행할 수 있습니다.| 기능 | 에이전트가 할 수 있는 것 |
|---|---|
| 로그 | 서비스 및 환경 전반의 로그 검색, 패턴 및 트렌드 분석 |
| 메트릭 | 사용 가능한 메트릭 검색, 시계열 데이터 쿼리, 메트릭 메타데이터 조회 |
| 모니터 | 상태, 이름, 또는 태그로 모니터 검색 |
| 인시던트 | 활성 및 해결된 인시던트 검색, 전체 인시던트 세부 정보 조회 |
| 대시보드 | 대시보드 구성 검색 및 검사 |
| 인프라 | 인프라 전반의 호스트 목록 조회 및 검사 |
| APM | 분산 트레이스 조회, 지연 분석을 위한 스팬 검색 |
| 서비스 카탈로그 | 서비스 목록 조회 및 서비스 의존성 관계 매핑 |
| 이벤트 | 플랫폼 및 커스텀 이벤트 검색 |
| 노트북 | 조사 노트북 검색, 조회, 생성, 편집 |
| RUM | Real User Monitoring 데이터 검색 |
| 연결 상태 | Datadog 연결이 정상 작동하는지 확인 |
연결 확인
예시 프롬프트
문제 해결
연결 테스트 403 실패
연결 테스트 403 실패
API 키가 유효하고 취소되지 않았는지 확인합니다. Application 키에 필요한 범위가 있는지, 두 키가 동일한 Datadog 조직에 속하는지 확인합니다.
연결 후 데이터가 없음
연결 후 데이터가 없음
Application 키 범위에 쿼리하는 데이터 유형이 포함되어 있는지 확인합니다 (예: 로그의 경우
logs_read_data). Datadog 보존 설정을 확인하고 서비스 또는 호스트가 데이터를 활발히 전송하고 있는지 확인합니다.잘못된 Datadog 사이트 선택
잘못된 Datadog 사이트 선택
쿼리가 빈 결과를 반환하는 경우, 잘못된 사이트를 선택했을 수 있습니다. Datadog URL을 확인하세요 —
app.datadoghq.com은 US1, us3.datadoghq.com은 US3, app.datadoghq.eu는 EU1입니다. 연결을 해제하고 올바른 사이트로 다시 연결합니다.API 키와 Application 키 혼동
API 키와 Application 키 혼동
두 키 모두 필요하며 서로 다른 역할을 합니다. API 키는 요청을 인증합니다. Application 키는 에이전트가 접근할 수 있는 Datadog 기능과 데이터를 제어합니다. 하나만으로는 충분하지 않습니다.
보안
- 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
- 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
- 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
- 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
- 범위 지정된 Application 키 — 항상 명시적 범위를 지정하세요. 범위가 없는 키는 생성한 사용자의 전체 권한을 상속합니다.
- 통합별 별도 키 — CloudThinker 전용 API 및 Application 키를 생성하여 독립적으로 취소할 수 있도록 합니다.
관련 항목
Grafana 연결
대안적 메트릭 및 대시보드
PagerDuty 연결
인시던트 알림 및 온콜