메인 콘텐츠로 건너뛰기
Datadog 계정을 연결하여 CloudThinker 에이전트가 전체 스택에서 로그를 검색하고, 메트릭을 쿼리하며, 인프라를 모니터링하고, 인시던트를 조사할 수 있도록 합니다. Datadog은 API 키범위 지정된 Application 키 쌍으로 인증합니다.

지원 사이트

사이트URL
US1app.datadoghq.com
US3us3.datadoghq.com
US5us5.datadoghq.com
EU1app.datadoghq.eu
AP1ap1.datadoghq.com
AP2ap2.datadoghq.com
GovCloud (US1-FED)는 Datadog MCP 서버에서 지원되지 않습니다.

사전 요구 사항

Datadog API 키범위 지정된 Application 키가 필요합니다. API 키 생성:
  1. Datadog 계정에서 Organization Settings → API Keys로 이동합니다.
  2. + New Key를 클릭하고 이름(예: CloudThinker)을 지정한 후 저장합니다.
  3. 키 값을 복사합니다.
범위 지정된 Application 키 생성:
  1. Organization Settings → Application Keys로 이동합니다.
  2. + New Key를 클릭하고 이름(예: CloudThinker)을 지정합니다.
  3. Scopes에서 필요 권한에 나열된 권한을 선택합니다.
  4. 저장하고 키 값을 복사합니다.
항상 범위가 없는 키 대신 범위 지정된 Application 키를 사용하세요. 범위가 없는 키는 생성한 사용자의 모든 권한을 상속합니다.

설정

1

CloudThinker 열기

CloudThinker 워크스페이스에서 Connections → Datadog으로 이동합니다.
2

Datadog 사이트 선택

계정에 맞는 Datadog 사이트를 선택합니다 (예: datadoghq.com은 US1, datadoghq.eu는 EU1).
3

API 키 입력

Datadog API 키를 붙여 넣습니다.
4

Application 키 입력

Datadog Application 키를 붙여 넣습니다.
5

연결

Connect를 클릭합니다. CloudThinker가 자격 증명을 확인하고 Connected 상태를 표시합니다.

연결 세부 정보

필드설명예시
Site계정에 맞는 Datadog 사이트US1 (datadoghq.com)
API KeyDatadog 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_readReal User Monitoring 데이터 검색
notebooks_write조사 노트북 생성 및 편집 (선택)
읽기 범위만으로 시작하세요. 에이전트가 조사 노트북을 생성해야 하는 워크플로에서만 notebooks_write를 추가하세요.

에이전트 기능

연결 후 에이전트는 Datadog 환경 전반에서 읽기 및 쓰기 작업을 수행할 수 있습니다.
기능에이전트가 할 수 있는 것
로그서비스 및 환경 전반의 로그 검색, 패턴 및 트렌드 분석
메트릭사용 가능한 메트릭 검색, 시계열 데이터 쿼리, 메트릭 메타데이터 조회
모니터상태, 이름, 또는 태그로 모니터 검색
인시던트활성 및 해결된 인시던트 검색, 전체 인시던트 세부 정보 조회
대시보드대시보드 구성 검색 및 검사
인프라인프라 전반의 호스트 목록 조회 및 검사
APM분산 트레이스 조회, 지연 분석을 위한 스팬 검색
서비스 카탈로그서비스 목록 조회 및 서비스 의존성 관계 매핑
이벤트플랫폼 및 커스텀 이벤트 검색
노트북조사 노트북 검색, 조회, 생성, 편집
RUMReal User Monitoring 데이터 검색
연결 상태Datadog 연결이 정상 작동하는지 확인
노트북 쓰기 작업은 실행 전 사용자 승인이 필요합니다.

연결 확인

@alex run the Datadog connection health check and summarize active monitors and host count

예시 프롬프트

@alex search for error logs in the production environment from the last 15 minutes
@alex check for active Datadog incidents and investigate root causes
@alex analyze APM traces for the checkout service and identify latency bottlenecks

문제 해결

API 키가 유효하고 취소되지 않았는지 확인합니다. Application 키에 필요한 범위가 있는지, 두 키가 동일한 Datadog 조직에 속하는지 확인합니다.
Application 키 범위에 쿼리하는 데이터 유형이 포함되어 있는지 확인합니다 (예: 로그의 경우 logs_read_data). Datadog 보존 설정을 확인하고 서비스 또는 호스트가 데이터를 활발히 전송하고 있는지 확인합니다.
쿼리가 빈 결과를 반환하는 경우, 잘못된 사이트를 선택했을 수 있습니다. Datadog URL을 확인하세요 — app.datadoghq.com은 US1, us3.datadoghq.com은 US3, app.datadoghq.eu는 EU1입니다. 연결을 해제하고 올바른 사이트로 다시 연결합니다.
두 키 모두 필요하며 서로 다른 역할을 합니다. API 키는 요청을 인증합니다. Application 키는 에이전트가 접근할 수 있는 Datadog 기능과 데이터를 제어합니다. 하나만으로는 충분하지 않습니다.

보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 범위 지정된 Application 키 — 항상 명시적 범위를 지정하세요. 범위가 없는 키는 생성한 사용자의 전체 권한을 상속합니다.
  • 통합별 별도 키 — CloudThinker 전용 API 및 Application 키를 생성하여 독립적으로 취소할 수 있도록 합니다.

관련 항목

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/grafana.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c1329049025cd3c3a0909b400baef7be

Grafana 연결

대안적 메트릭 및 대시보드
https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/pagerduty.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=cdc34a966d5d46da70c3bc509a2a7492

PagerDuty 연결

인시던트 알림 및 온콜