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

Servidor MCP de Datadog

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Datadog.

Características

  • Monitoreo : acceda a los datos y configuraciones del monitor

  • Paneles de control : recuperar y ver definiciones de paneles de control

  • Métricas : consulta las métricas disponibles y sus metadatos

  • Eventos : busca y recupera eventos dentro de períodos de tiempo

  • Registros : Busque registros con opciones avanzadas de filtrado y clasificación

  • Incidentes : Acceso a datos de gestión de incidentes

  • Integración de API : Integración directa con las API v1 y v2 de Datadog

  • Manejo integral de errores : mensajes de error claros para problemas de API y autenticación

  • Puntos finales específicos del servicio : Compatibilidad con diferentes puntos finales para registros y métricas

Prerrequisitos

  1. Node.js (versión 16 o superior)

  2. Cuenta Datadog con:

    • Clave API: se encuentra en Configuración de la organización > Claves API

    • Clave de aplicación: se encuentra en Configuración de la organización > Claves de aplicación

Instalación

A través de npm (recomendado)

npm install -g datadog-mcp-server

De la fuente

  1. Clonar este repositorio

  2. Instalar dependencias:

    npm install

  3. Construir el proyecto:

    npm run build

Configuración

Puede configurar el servidor Datadog MCP utilizando variables de entorno o argumentos de línea de comandos.

Variables de entorno

Cree un archivo .env con sus credenciales de Datadog:

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

Nota : DD_LOGS_SITE y DD_METRICS_SITE son opcionales y tendrán como valor predeterminado el de DD_SITE si no se especifican.

Argumentos de la línea de comandos

Uso básico con configuración global del sitio:

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

Uso avanzado con puntos finales específicos del servicio:

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

Nota: Los argumentos del sitio no necesitan https:// - se agregará automáticamente.

Puntos finales regionales

Las diferentes regiones de Datadog tienen diferentes puntos finales:

  • EE. UU. (predeterminado): datadoghq.com

  • UE: datadoghq.eu

  • US3 (GovCloud): ddog-gov.com

  • US5: us5.datadoghq.com

  • AP1: ap1.datadoghq.com

Uso con Claude Desktop

Agregue esto a su 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)" ] } } }

Para configuraciones más avanzadas con puntos finales separados para registros y métricas:

{ "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>" ] } } }

Ubicaciones para el archivo de configuración de Claude Desktop:

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

  • Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Uso con MCP Inspector

Para utilizar con la herramienta Inspector MCP:

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

Herramientas disponibles

El servidor proporciona estas herramientas MCP:

  • get-monitors : Obtener monitores con filtrado opcional

  • get-monitor : obtiene detalles de un monitor específico por ID

  • get-dashboards : Lista todos los paneles

  • get-dashboard : Obtener un panel específico por ID

  • get-metrics : lista de métricas disponibles

  • get-metric-metadata : obtener metadatos para una métrica específica

  • get-events : recupera eventos dentro de un rango de tiempo

  • get-incidents : Lista de incidentes con filtrado opcional

  • registros de búsqueda : registros de búsqueda con filtrado avanzado de consultas

  • added-logs : Realiza análisis y agregaciones en datos de registro

Ejemplos

Ejemplo: Obtener monitores

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

Ejemplo: Obtener un panel de control

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

Ejemplo: Registros de búsqueda

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

Ejemplo: Registros agregados

{ "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" } } ] } } }

Ejemplo: Obtener incidentes

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

Solución de problemas

Si encuentra un error 403 Prohibido, verifique que:

  1. Su clave API y clave de aplicación son correctas

  2. Las claves tienen los permisos necesarios para acceder a los recursos solicitados

  3. Su cuenta tiene acceso a los datos solicitados

  4. Estás utilizando el punto final correcto para tu región (por ejemplo, datadoghq.eu para clientes de la UE)

Depuración

Si encuentra problemas, consulte los registros MCP de Claude Desktop:

# 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

Problemas comunes:

  • 403 Prohibido: Problema de autenticación con las claves API de Datadog

  • Formato de clave API o clave de aplicación no válido: asegúrese de estar utilizando las cadenas de clave completas

  • Errores de configuración del sitio: asegúrese de estar utilizando el dominio Datadog correcto

  • Desajustes de puntos finales: verifique que los puntos finales específicos del servicio estén configurados correctamente si está utilizando dominios separados para registros y métricas

Licencia

Instituto Tecnológico de Massachusetts (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

para rastreo y seguimiento

  1. Características
    1. Prerrequisitos
      1. Instalación
        1. A través de npm (recomendado)
        2. De la fuente
      2. Configuración
        1. Variables de entorno
        2. Argumentos de la línea de comandos
        3. Puntos finales regionales
        4. Uso con Claude Desktop
      3. Uso con MCP Inspector
        1. Herramientas disponibles
          1. Ejemplos
            1. Ejemplo: Obtener monitores
            2. Ejemplo: Obtener un panel de control
            3. Ejemplo: Registros de búsqueda
            4. Ejemplo: Registros agregados
            5. Ejemplo: Obtener incidentes
          2. Solución de problemas
            1. Depuración
              1. Licencia

                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