Datadog MCP Server

Servidor MCP de Datadog

Inglés (Este documento) |日本語

Servidor MCP para API de Datadog, que permite funcionalidades de búsqueda de registros, búsqueda de tramos de seguimiento y agregación de tramos de seguimiento.

Características

• Búsqueda de registros : busque y recupere registros de Datadog con opciones de consulta flexibles
• Búsqueda de tramos de seguimiento : busque tramos de seguimiento distribuidos con varias opciones de filtrado
• Agregación de tramos de seguimiento : agregue tramos de seguimiento por diferentes dimensiones para su análisis

Herramientas

1. search_logs
   • Buscar registros en Datadog
   • Entradas:
     • filterQuery (cadena opcional): cadena de consulta para buscar registros (valor predeterminado: "*")
     • filterFrom (número opcional): hora de inicio de la búsqueda como marca de tiempo UNIX en segundos (valor predeterminado: hace 15 minutos)
     • filterTo (número opcional): hora de finalización de la búsqueda como marca de tiempo UNIX en segundos (valor predeterminado: hora actual)
     • pageLimit (número opcional): Número máximo de registros a recuperar (predeterminado: 25, máximo: 1000)
     • pageCursor (cadena opcional): cursor de paginación para recuperar resultados adicionales
   • Devuelve: Texto formateado que contiene:
     • Condiciones de búsqueda (consulta y rango de tiempo)
     • Número de registros encontrados
     • Cursor de página siguiente (si está disponible)
     • Detalles del registro que incluyen:
       • Nombre del servicio
       • Etiquetas
       • Marca de tiempo
       • Estado
       • Mensaje (truncado a 300 caracteres)
       • Anfitrión
       • Atributos importantes (http.method, http.url, http.status_code, error)
2. search_spans
   • Búsqueda de tramos de seguimiento en Datadog
   • Entradas:
     • filterQuery (cadena opcional): cadena de consulta para buscar intervalos (valor predeterminado: "*")
     • filterFrom (número opcional): hora de inicio de la búsqueda como marca de tiempo UNIX en segundos (valor predeterminado: hace 15 minutos)
     • filterTo (número opcional): hora de finalización de la búsqueda como marca de tiempo UNIX en segundos (valor predeterminado: hora actual)
     • pageLimit (número opcional): Número máximo de intervalos a recuperar (predeterminado: 25, máximo: 1000)
     • pageCursor (cadena opcional): cursor de paginación para recuperar resultados adicionales
   • Devuelve: Texto formateado que contiene:
     • Condiciones de búsqueda (consulta y rango de tiempo)
     • Número de tramos encontrados
     • Cursor de página siguiente (si está disponible)
     • Detalles del tramo que incluyen:
       • Nombre del servicio
       • Marca de tiempo
       • Nombre del recurso
       • Duración (en segundos)
       • Anfitrión
       • Ambiente
       • Tipo
       • Atributos importantes (http.method, http.url, http.status_code, error)
3. aggregate_spans
   • Agrupar intervalos de seguimiento en Datadog según dimensiones específicas
   • Entradas:
     • filterQuery (cadena opcional): cadena de consulta para filtrar intervalos para la agregación (valor predeterminado: "*")
     • filterFrom (número opcional): hora de inicio como marca de tiempo UNIX en segundos (valor predeterminado: hace 15 minutos)
     • filterTo (número opcional): hora de finalización como marca de tiempo UNIX en segundos (predeterminado: hora actual)
     • groupBy (cadena opcional[]): Dimensiones por las que agrupar (por ejemplo, ["servicio", "nombre_del_recurso", "estado"])
     • aggregation (cadena opcional): Método de agregación: "count", "avg", "sum", "min", "max", "pct" (predeterminado: "count")
     • interval (cadena opcional): intervalo de tiempo para datos de series temporales (solo cuando el tipo es "series temporales")
     • type (cadena opcional): Tipo de resultado, ya sea "serie temporal" o "total" (predeterminado: "serie temporal")
   • Devuelve: Texto formateado que contiene:
     • La agregación da como resultado grupos, cada uno de los cuales incluye:
       • Identificación del depósito
       • Agrupar por valores (si se especifica groupBy)
       • Valores calculados según el método de agregación
     • Metadatos adicionales:
       • Tiempo de procesamiento (transcurrido)
       • ID de solicitud
       • Estado
       • Advertencias (si las hay)

Configuración

Debe configurar la API de Datadog y las claves de aplicación:

1. Obtenga su clave API y clave de aplicación desde la página Claves API de Datadog
2. Instalar dependencias en el proyecto datadog-mcp:
   npm install # or pnpm install
3. Construya el proyecto TypeScript:
   npm run build # or pnpm run build

Configuración de Docker

Puedes construir usando Docker con el siguiente comando:

Uso con Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su claude_desktop_config.json :

Si estás usando Docker, puedes configurarlo de la siguiente manera:

Uso con VS Code

Para una instalación rápida en VS Code, configure sus ajustes:

1. Abrir configuración de usuario (JSON) en VS Code ( Ctrl+Shift+P → Preferences: Open User Settings (JSON) )
2. Agregue la siguiente configuración:

Si estás usando Docker, puedes configurarlo de la siguiente manera:

Alternativamente, puede agregar esto a un archivo .vscode/mcp.json en su espacio de trabajo (sin la clave mcp ):

Si estás usando Docker, puedes configurarlo de la siguiente manera: