데이터독 MCP

Datadog MCP 서버

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

특징

모니터링 : 모니터 데이터 및 구성에 액세스
대시보드 : 대시보드 정의 검색 및 보기
메트릭 : 사용 가능한 메트릭 및 해당 메타데이터 쿼리
이벤트 : 기간 내 이벤트 검색 및 검색
로그 : 고급 필터링 및 정렬 옵션을 사용하여 로그 검색
사고 : 사고 관리 데이터 접근
API 통합 : Datadog의 v1 및 v2 API와 직접 통합
포괄적인 오류 처리 : API 및 인증 문제에 대한 명확한 오류 메시지
서비스별 엔드포인트 : 로그 및 메트릭에 대한 다양한 엔드포인트 지원

필수 조건

Node.js(버전 16 이상)
Datadog 계정에는 다음이 포함됩니다.
- API 키 - 조직 설정 > API 키에서 찾을 수 있습니다.
- 애플리케이션 키 - 조직 설정 > 애플리케이션 키에서 찾을 수 있습니다.

설치

npm을 통해 (권장)

지엑스피1

출처에서

이 저장소를 복제하세요
종속성 설치:
npm install
프로젝트를 빌드하세요:
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 오류가 발생하면 다음 사항을 확인하세요.

API 키와 애플리케이션 키가 정확합니다.
키에는 요청된 리소스에 액세스하는 데 필요한 권한이 있습니다.
귀하의 계정은 요청된 데이터에 액세스할 수 있습니다.
귀하는 귀하의 지역에 맞는 올바른 엔드포인트를 사용하고 있습니다(예: 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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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

추적 및 모니터링을 위해

Related Resources

Reddit Discussion about this server

Related MCP Servers

PyTorch HUD MCP Server
izaitsevfb
-
security
F
license
-
quality
Provides access to PyTorch CI/CD analytics data including workflows, jobs, test runs, and log analysis through an MCP interface.
Last updated -
Python
SolarWinds Logs MCP Server
jakenuts
A
security
F
license
A
quality
An MCP server for searching and visualizing SolarWinds Observability logs, allowing users to query log data with filtering options and generate visual representations of log events over time.
Last updated -
2
15
TypeScript
System Resource Monitor MCP Server
abhinav7895
-
security
A
license
-
quality
Provides Claude with real-time system monitoring capabilities, including CPU, memory, disk, network, battery, and internet speed metrics.
Last updated -
TypeScript
MIT License
MCP System Info Server
allenbijo
-
security
A
license
-
quality
A lightweight server that provides real-time system information including CPU, memory, disk, and GPU statistics for monitoring and diagnostic purposes.
Last updated -
Python
MIT License

View all related MCP servers

datadog mcp