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: