Skip to main content
Glama
enesjakozh

datadog mcp

by GeLi2001
npmGitHub
TypeScript
MIT License
4,316
55
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Datadog MCP 서버

Datadog API와 상호작용하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

  • 모니터링 : 모니터 데이터 및 구성에 액세스

  • 대시보드 : 대시보드 정의 검색 및 보기

  • 메트릭 : 사용 가능한 메트릭 및 해당 메타데이터 쿼리

  • 이벤트 : 기간 내 이벤트 검색 및 검색

  • 로그 : 고급 필터링 및 정렬 옵션을 사용하여 로그 검색

  • 사고 : 사고 관리 데이터 접근

  • API 통합 : Datadog의 v1 및 v2 API와 직접 통합

  • 포괄적인 오류 처리 : API 및 인증 문제에 대한 명확한 오류 메시지

  • 서비스별 엔드포인트 : 로그 및 메트릭에 대한 다양한 엔드포인트 지원

필수 조건

  1. Node.js(버전 16 이상)

  2. Datadog 계정에는 다음이 포함됩니다.

    • API 키 - 조직 설정 > API 키에서 찾을 수 있습니다.

    • 애플리케이션 키 - 조직 설정 > 애플리케이션 키에서 찾을 수 있습니다.

설치

npm을 통해 (권장)

지엑스피1

출처에서

  1. 이 저장소를 복제하세요

  2. 종속성 설치:

    npm install

  3. 프로젝트를 빌드하세요:

    npm run build

구성

환경 변수나 명령줄 인수를 사용하여 Datadog MCP 서버를 구성할 수 있습니다.

환경 변수

Datadog 자격 증명으로 .env 파일을 만듭니다.

DD_API_KEY=your_api_key_here DD_APP_KEY=your_app_key_here DD_SITE=datadoghq.com DD_LOGS_SITE=datadoghq.com DD_METRICS_SITE=datadoghq.com

참고 : DD_LOGS_SITE 및 DD_METRICS_SITE 는 선택 사항이며 지정하지 않으면 DD_SITE 값이 기본값으로 사용됩니다.

명령줄 인수

글로벌 사이트 설정을 사용한 기본 사용법:

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.eu

서비스별 엔드포인트를 사용한 고급 사용:

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.com --logsSite=logs.datadoghq.com --metricsSite=metrics.datadoghq.com

참고: 사이트 인수에는 https:// 필요하지 않습니다. 자동으로 추가됩니다.

지역별 엔드포인트

Datadog 지역마다 엔드포인트가 다릅니다.

  • 미국(기본값): datadoghq.com

  • EU: datadoghq.eu

  • US3(GovCloud): ddog-gov.com

  • US5: us5.datadoghq.com

  • AP1: ap1.datadoghq.com

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

{ "mcpServers": { "datadog": { "command": "npx", "args": [ "datadog-mcp-server", "--apiKey", "<YOUR_API_KEY>", "--appKey", "<YOUR_APP_KEY>", "--site", "<YOUR_DD_SITE>(e.g us5.datadoghq.com)" ] } } }

로그와 메트릭에 대한 별도의 엔드포인트를 갖춘 고급 구성의 경우:

{ "mcpServers": { "datadog": { "command": "npx", "args": [ "datadog-mcp-server", "--apiKey", "<YOUR_API_KEY>", "--appKey", "<YOUR_APP_KEY>", "--site", "<YOUR_DD_SITE>", "--logsSite", "<YOUR_LOGS_SITE>", "--metricsSite", "<YOUR_METRICS_SITE>" ] } } }

Claude Desktop 구성 파일의 위치:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • 윈도우: %APPDATA%/Claude/claude_desktop_config.json

MCP Inspector와 함께 사용

MCP Inspector 도구와 함께 사용하려면:

npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key

사용 가능한 도구

서버는 다음과 같은 MCP 도구를 제공합니다.

  • get-monitors : 선택적 필터링을 사용하여 모니터 가져오기

  • get-monitor : ID로 특정 모니터의 세부 정보를 가져옵니다.

  • get-dashboards : 모든 대시보드 나열

  • get-dashboard : ID로 특정 대시보드 가져오기

  • get-metrics : 사용 가능한 메트릭 나열

  • get-metric-metadata : 특정 메트릭에 대한 메타데이터를 가져옵니다.

  • get-events : 시간 범위 내에서 이벤트를 가져옵니다.

  • get-incidents : 선택적 필터링을 사용하여 인시던트 나열

  • 검색 로그 : 고급 쿼리 필터링을 사용한 검색 로그

  • aggregate-logs : 로그 데이터에 대한 분석 및 집계를 수행합니다.

예시

예: 모니터 가져오기

{ "method": "tools/call", "params": { "name": "get-monitors", "arguments": { "groupStates": ["alert", "warn"], "limit": 5 } } }

예: 대시보드 가져오기

{ "method": "tools/call", "params": { "name": "get-dashboard", "arguments": { "dashboardId": "abc-def-123" } } }

예: 검색 로그

{ "method": "tools/call", "params": { "name": "search-logs", "arguments": { "filter": { "query": "service:web-app status:error", "from": "now-15m", "to": "now" }, "sort": "-timestamp", "limit": 20 } } }

예: 집계 로그

{ "method": "tools/call", "params": { "name": "aggregate-logs", "arguments": { "filter": { "query": "service:web-app", "from": "now-1h", "to": "now" }, "compute": [ { "aggregation": "count" } ], "groupBy": [ { "facet": "status", "limit": 10, "sort": { "aggregation": "count", "order": "desc" } } ] } } }

예: 사고 가져오기

{ "method": "tools/call", "params": { "name": "get-incidents", "arguments": { "includeArchived": false, "query": "state:active", "pageSize": 10 } } }

문제 해결

403 Forbidden 오류가 발생하면 다음 사항을 확인하세요.

  1. API 키와 애플리케이션 키가 정확합니다.

  2. 키에는 요청된 리소스에 액세스하는 데 필요한 권한이 있습니다.

  3. 귀하의 계정은 요청된 데이터에 액세스할 수 있습니다.

  4. 귀하는 귀하의 지역에 맞는 올바른 엔드포인트를 사용하고 있습니다(예: EU 고객의 경우 datadoghq.eu ).

디버깅

문제가 발생하면 Claude Desktop의 MCP 로그를 확인하세요.

# On macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # On Windows Get-Content -Path "$env:APPDATA\Claude\Logs\mcp*.log" -Tail 20 -Wait

일반적인 문제:

  • 403 금지됨: Datadog API 키 인증 문제

  • API 키 또는 앱 키 형식이 잘못되었습니다. 전체 키 문자열을 사용하고 있는지 확인하세요.

  • 사이트 구성 오류: 올바른 Datadog 도메인을 사용하고 있는지 확인하세요.

  • 엔드포인트 불일치: 로그 및 메트릭에 대해 별도의 도메인을 사용하는 경우 서비스별 엔드포인트가 올바르게 설정되었는지 확인하세요.

특허

MIT

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

추적 및 모니터링을 위해

  1. 특징
    1. 필수 조건
      1. 설치
        1. npm을 통해 (권장)
        2. 출처에서
      2. 구성
        1. 환경 변수
        2. 명령줄 인수
        3. 지역별 엔드포인트
        4. Claude Desktop과 함께 사용
      3. MCP Inspector와 함께 사용
        1. 사용 가능한 도구
          1. 예시
            1. 예: 모니터 가져오기
            2. 예: 대시보드 가져오기
            3. 예: 검색 로그
            4. 예: 집계 로그
            5. 예: 사고 가져오기
          2. 문제 해결
            1. 디버깅
              1. 특허

                Related Resources

                Related MCP Servers

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/GeLi2001/datadog-mcp-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server