mcp-server-datadog

Datadog MCP 서버

면책 조항 : 이것은 커뮤니티에서 유지하는 프로젝트이며 Datadog, Inc.와 공식적으로 제휴, 보증 또는 지원을 받지 않습니다. 이 MCP 서버는 Datadog API를 활용하지만 Model Context Protocol 생태계의 일부로 독립적으로 개발되었습니다.

Datadog API를 위한 MCP 서버로, 사고 관리 등을 가능하게 합니다.

특징

• 관찰 도구 : MCP 서버를 통해 인시던트, 모니터, 로그, 대시보드, 지표와 같은 주요 Datadog 모니터링 기능을 활용할 수 있는 메커니즘을 제공합니다.
• 확장 가능한 디자인 : 추가적인 Datadog API와 쉽게 통합되도록 설계되어 향후 기능 확장이 원활합니다.

도구

1. list_incidents
   • Datadog에서 사건 목록을 검색합니다.
   • 입력 :
     • filter (선택적 문자열): 사고에 대한 필터 매개변수(예: 상태, 우선순위).
     • pagination (선택적 객체): 페이지 크기/오프셋과 같은 페이지 번호 매기기 세부 정보입니다.
   • 반환값 : Datadog 사건 및 관련 메타데이터의 배열입니다.
2. get_incident
   • 특정 Datadog 사건에 대한 자세한 정보를 검색합니다.
   • 입력 :
     • incident_id (문자열): 세부 정보를 가져올 사건 ID입니다.
   • 반환 : 자세한 사고 정보(제목, 상태, 타임스탬프 등)
3. get_monitors
   • Datadog 모니터의 상태를 가져옵니다.
   • 입력 :
     • groupStates (선택적 배열): 필터링할 상태(예: 경고, 경고, 데이터 없음, 확인).
     • name (선택 문자열): 이름으로 필터링합니다.
     • tags (선택적 배열): 태그로 필터링합니다.
   • 반환 : 데이터와 상태 요약을 모니터링합니다.
4. get_logs
   • Datadog에서 로그를 검색하고 불러옵니다.
   • 입력 :
     • query (문자열): Datadog 로그 쿼리 문자열입니다.
     • ( from ): 시작 시간(에포크 초)입니다.
     • (숫자): 종료 시간(에포크 초) to .
     • limit (선택적 숫자): 반환할 로그의 최대 개수(기본값은 100).
   • 반환값 : 일치하는 로그 배열입니다.
5. list_dashboards
   • Datadog에서 대시보드 목록을 가져옵니다.
   • 입력 :
     • name (선택 문자열): 이름으로 대시보드를 필터링합니다.
     • tags (선택적 배열): 태그로 대시보드를 필터링합니다.
   • 반환 : URL 참조가 있는 대시보드 배열입니다.
6. get_dashboard
   • Datadog에서 특정 대시보드를 검색합니다.
   • 입력 :
     • dashboard_id (문자열): 가져올 대시보드의 ID입니다.
   • 반환 : 제목, 위젯 등을 포함한 대시보드 세부 정보
7. query_metrics
   • Datadog에서 메트릭 데이터를 검색합니다.
   • 입력 :
     • query (문자열): 메트릭 쿼리 문자열.
     • ( from ): 시작 시간(에포크 초)입니다.
     • (숫자): 종료 시간(에포크 초) to .
   • 반환 : 쿼리된 기간에 대한 메트릭 데이터입니다.
8. list_traces
   • Datadog에서 APM 추적 목록을 검색합니다.
   • 입력 :
     • query (문자열): Datadog APM 추적 쿼리 문자열.
     • ( from ): 시작 시간(에포크 초)입니다.
     • (숫자): 종료 시간(에포크 초) to .
     • limit (선택적 숫자): 반환할 추적의 최대 수(기본값은 100).
     • sort (선택적 문자열): 추적에 대한 정렬 순서(기본값은 '-timestamp').
     • service (선택 문자열): 서비스 이름으로 필터링합니다.
     • operation (선택 문자열): 작업 이름으로 필터링합니다.
   • 반환 : Datadog APM의 일치하는 추적 배열입니다.
9. list_hosts
   • Datadog에서 호스트 목록을 가져옵니다.
   • 입력 :
     • filter (선택 문자열): 검색 결과에 대한 필터 문자열입니다.
     • sort_field (선택적 문자열): 호스트를 정렬할 필드입니다.
     • sort_dir (선택적 문자열): 정렬 방향(오름차순/내림차순).
     • start (선택적 숫자): 페이지 매김을 위한 시작 오프셋입니다.
     • count (선택적 숫자): 반환할 호스트의 최대 수(최대: 1000).
     • from (선택적 숫자): 이 UNIX 타임스탬프에서 호스트를 검색합니다.
     • include_muted_hosts_data (선택적 부울): 음소거된 호스트 상태 및 만료를 포함합니다.
     • include_hosts_metadata (선택적 부울): 호스트 메타데이터(버전, 플랫폼 등)를 포함합니다.
   • 반환 : 이름, ID, 별칭, 앱, 음소거 상태 등의 세부 정보가 포함된 호스트 배열입니다.
10. get_active_hosts_count

• Datadog에서 활성 호스트의 총 수를 가져옵니다.
• 입력 :
  • (선택적 숫자): 활성 호스트의 총 수를 가져올 시작 시간(초) from (기본값은 2시간).
• 반환값 : 활성 호스트와 가동 중인 호스트의 총 개수입니다.

11. mute_host

• Datadog에서 호스트를 음소거합니다.
• 입력 :
  • hostname (문자열): 음소거할 호스트의 이름입니다.
  • message (선택적 문자열): 이 호스트의 음소거와 관련된 메시지입니다.
  • end (선택적 숫자): 음소거가 종료되어야 하는 POSIX 타임스탬프입니다.
  • override (선택적 부울): true이고 호스트가 이미 음소거된 경우 기존 종료 시간을 대체합니다.
• 반환 : 성공 상태 및 확인 메시지.

12. unmute_host

• Datadog에서 호스트의 음소거를 해제합니다.
• 입력 :
  • hostname (문자열): 음소거를 해제할 호스트의 이름입니다.
• 반환 : 성공 상태 및 확인 메시지.

13. list_downtimes

• Datadog에서 예정된 다운타임을 나열합니다.
• 입력 :
  • currentOnly (선택적 부울): true인 경우 현재 활성화된 다운타임만 반환합니다.
  • monitorId (선택적 숫자): 모니터 ID로 필터링합니다.
• 반환 : 범위, 모니터 정보, 일정을 포함한 세부 정보가 포함된 예정된 가동 중지 시간의 배열입니다.

14. schedule_downtime

• Datadog에서 다운타임을 예약하세요.
• 입력 :
  • scope (문자열): 가동 중지 시간을 적용할 범위(예: 'host:my-host').
  • start (선택적 숫자): 다운타임 시작을 나타내는 UNIX 타임스탬프입니다.
  • end (선택적 숫자): 다운타임 종료를 나타내는 UNIX 타임스탬프입니다.
  • message (선택적 문자열): 다운타임에 포함할 메시지입니다.
  • timezone (선택적 문자열): 가동 중지 시간의 시간대(예: 'UTC', 'America/New_York').
  • monitorId (선택적 숫자): 음소거할 모니터의 ID입니다.
  • monitorTags (선택적 배열): 필터링을 위한 모니터 태그 목록입니다.
  • recurrence (선택적 객체): 다운타임에 대한 반복 설정입니다.
    • type (문자열): 반복 유형('일', '주', '월', '년').
    • period (숫자): 반복 빈도(1 이상이어야 함).
    • weekDays (선택적 배열): 매주 반복되는 요일입니다.
    • until (선택적 숫자): 반복이 종료되는 시점을 나타내는 UNIX 타임스탬프입니다.
• 반환 : ID 및 활성 상태를 포함한 예정된 가동 중지 세부 정보.

15. cancel_downtime

• Datadog에서 예약된 다운타임을 취소합니다.
• 입력 :
  • downtimeId (숫자): 취소할 다운타임의 ID입니다.
• 반환 : 가동 중지 취소 확인.

16. get_rum_applications

• 조직 내 모든 RUM 애플리케이션을 가져옵니다.
• 입력 : 없음.
• 반환 : RUM 애플리케이션 목록.

17. get_rum_events

• Datadog에서 RUM 이벤트를 검색하고 불러옵니다.
• 입력 :
  • query (문자열): Datadog RUM 쿼리 문자열.
  • ( from ): 시작 시간(에포크 초)입니다.
  • (숫자): 종료 시간(에포크 초) to .
  • limit (선택적 숫자): 반환할 이벤트의 최대 개수(기본값: 100).
• 반환값 : RUM 이벤트 배열.

18. get_rum_grouped_event_count

• 지정된 차원별로 RUM 이벤트를 검색, 그룹화하고 계산합니다.
• 입력 :
  • query (선택적 문자열): RUM 검색을 위한 추가 쿼리 필터(기본값: "*").
  • ( from ): 시작 시간(에포크 초)입니다.
  • (숫자): 종료 시간(에포크 초) to .
  • groupBy (선택적 문자열): 결과를 그룹화할 차원(기본값: "application.name").
• 반환값 : 그룹화된 이벤트 수.

19. get_rum_page_performance

• RUM 데이터에서 페이지(뷰) 성능 측정 항목을 가져옵니다.
• 입력 :
  • query (선택적 문자열): RUM 검색을 위한 추가 쿼리 필터(기본값: "*").
  • ( from ): 시작 시간(에포크 초)입니다.
  • (숫자): 종료 시간(에포크 초) to .
  • metricNames (문자열 배열): 검색할 메트릭 이름의 배열(예: 'view.load_time', 'view.first_contentful_paint').
• 반환 : 각 메트릭에 대한 평균, 최소값, 최대값 및 개수를 포함한 성능 메트릭입니다.

20. get_rum_page_waterfall

• 애플리케이션 이름과 세션 ID로 필터링된 RUM 페이지(보기) 워터폴 데이터를 검색합니다.
• 입력 :
  • applicationName (문자열): 이벤트를 필터링할 애플리케이션 이름입니다.
  • sessionId (문자열): 이벤트를 필터링할 세션 ID입니다.
• 반환 : 지정된 애플리케이션 및 세션에 대한 워터폴 데이터입니다.

설정

Datadog 자격증

이 MCP 서버를 사용하려면 유효한 Datadog API 자격 증명이 필요합니다.

• DATADOG_API_KEY : Datadog API 키
• DATADOG_APP_KEY : Datadog 애플리케이션 키
• DATADOG_SITE (선택 사항): Datadog 사이트(예: datadoghq.eu )

서버를 실행하기 전에 환경으로 내보내세요.

지엑스피1

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Datadog MCP 서버를 자동으로 설치하려면:

수동 설치

Claude Desktop과 함께 사용

Claude Desktop과 함께 사용하려면 claude_desktop_config.json 에 다음을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

또는 npx 를 통해 지정하세요:

디버깅

MCP 서버는 표준 입출력(SIO)을 통해 통신하기 때문에 디버깅이 까다로울 수 있습니다. MCP Inspector 사용을 권장합니다. 다음 명령어를 사용하여 Inspector를 실행할 수 있습니다.

검사기는 브라우저에서 열어서 로그를 확인하고 수동으로 요청을 보낼 수 있는 URL을 제공합니다.

기여하다

기여를 환영합니다! 제안, 버그 리포트, 개선 사항 등이 있으시면 이슈를 생성하거나 풀 리퀘스트를 보내주세요.

특허

이 프로젝트는 Apache 라이선스 버전 2.0 에 따라 라이선스가 부여되었습니다.