Datadog MCP 서버

영어(본 문서) |日本語

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

특징

• 로그 검색 : 유연한 쿼리 옵션을 사용하여 Datadog에서 로그를 검색하고 검색합니다.

• 추적 범위 검색 : 다양한 필터링 옵션을 사용하여 분산 추적 범위를 검색합니다.

• 추적 범위 집계 : 분석을 위해 다양한 차원별로 추적 범위를 집계합니다.

Related MCP server: 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를 사용하는 경우 다음과 같이 구성할 수 있습니다.