Datadog MCP Server

Datadog MCP 서버

영어(본 문서) |日本語

Datadog API용 MCP 서버로, 로그 검색, 추적 기간 검색, 추적 기간 집계 기능을 제공합니다.

특징

• 로그 검색 : 유연한 쿼리 옵션을 사용하여 Datadog에서 로그를 검색하고 검색합니다.
• 추적 범위 검색 : 다양한 필터링 옵션을 사용하여 분산 추적 범위를 검색합니다.
• 추적 범위 집계 : 분석을 위해 다양한 차원별로 추적 범위를 집계합니다.

도구

1. search_logs
   • Datadog에서 로그 검색
   • 입력:
     • filterQuery (선택적 문자열): 로그를 검색하기 위한 쿼리 문자열(기본값: "*")
     • filterFrom (선택적 숫자): 검색 시작 시간을 UNIX 타임스탬프(초)로 표시(기본값: 15분 전)
     • filterTo (선택적 숫자): 검색 종료 시간을 UNIX 타임스탬프(초)로 표시(기본값: 현재 시간)
     • pageLimit (선택적 숫자): 검색할 로그의 최대 수(기본값: 25, 최대값: 1000)
     • pageCursor (선택적 문자열): 추가 결과를 검색하기 위한 페이지 번호 커서
   • 반환: 다음을 포함하는 서식이 지정된 텍스트:
     • 검색 조건(쿼리 및 시간 범위)
     • 발견된 로그 수
     • 다음 페이지 커서(사용 가능한 경우)
     • 다음을 포함한 로그 세부 정보:
       • 서비스 이름
       • 태그
       • 타임스탬프
       • 상태
       • 메시지 (300자로 축소)
       • 주인
       • 중요 속성(http.method, http.url, http.status_code, error)
2. search_spans
   • Datadog에서 추적 기간 검색
   • 입력:
     • filterQuery (선택적 문자열): span을 검색할 쿼리 문자열(기본값: "*")
     • filterFrom (선택적 숫자): 검색 시작 시간을 UNIX 타임스탬프(초)로 표시(기본값: 15분 전)
     • filterTo (선택적 숫자): 검색 종료 시간을 UNIX 타임스탬프(초)로 표시(기본값: 현재 시간)
     • pageLimit (선택적 숫자): 검색할 최대 스팬 수(기본값: 25, 최대값: 1000)
     • pageCursor (선택적 문자열): 추가 결과를 검색하기 위한 페이지 번호 커서
   • 반환: 다음을 포함하는 서식이 지정된 텍스트:
     • 검색 조건(쿼리 및 시간 범위)
     • 발견된 스팬 수
     • 다음 페이지 커서(사용 가능한 경우)
     • 다음을 포함한 스팬 세부 정보:
       • 서비스 이름
       • 타임스탬프
       • 리소스 이름
       • 지속 시간(초)
       • 주인
       • 환경
       • 유형
       • 중요 속성(http.method, http.url, http.status_code, error)
3. aggregate_spans
   • 지정된 차원에 따라 Datadog에서 추적 범위 집계
   • 입력:
     • filterQuery (선택적 문자열): 집계를 위해 스팬을 필터링하기 위한 쿼리 문자열(기본값: "*")
     • filterFrom (선택적 숫자): UNIX 타임스탬프(초)로 시작 시간(기본값: 15분 전)
     • filterTo (선택적 숫자): UNIX 타임스탬프(초)로 표시되는 종료 시간(기본값: 현재 시간)
     • groupBy (선택적 문자열[]): 그룹화할 차원(예: ["service", "resource_name", "status"])
     • aggregation (선택적 문자열): 집계 방법 - "count", "avg", "sum", "min", "max", "pct"(기본값: "count")
     • interval (선택적 문자열): 시계열 데이터의 시간 간격(type이 "timeseries"인 경우에만 해당)
     • type (선택적 문자열): 결과 유형, "timeseries" 또는 "total"(기본값: "timeseries")
   • 반환: 다음을 포함하는 서식이 지정된 텍스트:
     • 버킷에 결과를 집계합니다. 각 버킷에는 다음이 포함됩니다.
       • 버킷 ID
       • 값별로 그룹화(groupBy가 지정된 경우)
       • 집계 방법에 따른 계산된 값
     • 추가 메타데이터:
       • 처리 시간(경과)
       • 요청 ID
       • 상태
       • 경고(있는 경우)

설정

Datadog API와 애플리케이션 키를 설정해야 합니다.

1. Datadog API 키 페이지 에서 API 키와 애플리케이션 키를 받으세요.
2. datadog-mcp 프로젝트에 종속성을 설치합니다.지엑스피1
3. TypeScript 프로젝트를 빌드합니다.
   npm run build # or pnpm run build

도커 설정

다음 명령을 사용하여 Docker를 사용하여 빌드할 수 있습니다.

Claude Desktop과 함께 사용

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

Docker를 사용하는 경우 다음과 같이 구성할 수 있습니다.

VS Code를 사용한 사용

VS Code에 빠르게 설치하려면 설정을 구성하세요.

1. VS Code에서 사용자 설정(JSON) 열기( Ctrl+Shift+P → Preferences: Open User Settings (JSON) )
2. 다음 구성을 추가합니다.

Docker를 사용하는 경우 다음과 같이 구성할 수 있습니다.

또는 작업 공간의 .vscode/mcp.json 파일에 다음을 추가할 수 있습니다( mcp 키 없음):

Docker를 사용하는 경우 다음과 같이 구성할 수 있습니다.