Consulta los registros de CloudPrem con el servidor MCP de Datadog

Este producto no es compatible con el sitio Datadog seleccionado. ().
CloudPrem está en vista previa

Únete a la vista previa de CloudPrem para acceder a nuevas funciones de gestión de registros autohospedadas.

Request Access

Resumen

El servidor MCP de Datadog (Modelo de Protocolo de Contexto) te permite consultar tus registros de Datadog, incluidos los registros almacenados en los índices de CloudPrem, directamente a través de herramientas e integraciones impulsadas por IA. Consultar los registros de CloudPrem con el servidor MCP de Datadog desbloquea varias capacidades valiosas, incluyendo:

  • Solución de problemas unificada con reconocimiento de contexto: Consulta y correlaciona registros, métricas y trazas de cualquier entorno en un solo lugar, y pivota entre tipos de telemetría para identificar las causas raíz más rápido.
  • Interacción en Lenguaje Natural: Haz preguntas en lenguaje sencillo y deja que la IA genere las consultas de registro apropiadas sin necesidad de recordar la sintaxis.

Requisitos previos

Consultando los registros de CloudPrem

Para consultar los registros almacenados en los índices de CloudPrem, tú debes especificar dos parámetros críticos además de tu consulta estándar de registros:

  • (Requerido) indexes: El/los nombre(s) de tus índices de CloudPrem.
  • (Requerido) storage_tier: Debe establecerse en "cloudprem".

Sin ambos parámetros, las consultas se predeterminarán a buscar en los índices de registros estándar de Datadog en lugar de CloudPrem.

Para obtener los mejores resultados, tu solicitud también debería incluir:

  • (Recomendado) Rango de tiempo (por ejemplo, “en la última hora”, “de las últimas 24 horas”).
  • (Recomendado) Filtros de consulta (servicio, estado, contenido del registro).

Parámetros de consulta

La siguiente tabla describe los parámetros clave utilizados al consultar registros con el servidor MCP:

ParámetroDescripciónEjemplo
queryConsulta de búsqueda de registros utilizando la sintaxis de consulta de Datadog"*" (todos los registros), "service:web", "status:error"
indexesArreglo de nombres de índices de CloudPrem a buscar["cloudprem--dev--main"]
storage_tierNivel de almacenamiento a consultar (debe ser "cloudprem" para los registros de CloudPrem)"cloudprem"
fromHora de inicio para la consulta"now-1h", "now-24h", "2024-01-15T00:00:00Z"
toHora de finalización para la consulta"now", "2024-01-15T23:59:59Z"
sortOrden de clasificación para los resultados"-timestamp" (descendente), "timestamp" (ascendente)

Para ejemplos de parámetros y consultas en lenguaje natural, consulte Ejemplos avanzados de consultas.

Encontrando el nombre de tu índice de CloudPrem

Para encontrar el nombre de tu índice de CloudPrem:

  1. Navega a Datadog Log Explorer.
  2. Busca la sección ÍNDICES DE CLOUDPREM en el panel de facetas a la izquierda.
  3. Tus índices de CloudPrem están listados allí, en el formato cloudprem--<cluster_name>--<index_name>.

También puedes encontrar los nombres de tus índices en la consola de CloudPrem seleccionando un clúster y haciendo clic en Ver índices.

Ejemplos avanzados de consultas

Al utilizar herramientas impulsadas por IA con el servidor MCP de Datadog, puedes hacer preguntas en lenguaje natural. El servidor MCP traducirá automáticamente estas en consultas de CloudPrem correctamente formateadas.

Registros de errores de un servicio específico

Indicación: “Muéstrame los registros de errores del servicio nginx en el índice cloudprem–dev–main en la última hora.”

Se traduce a:

{
  "query": "service:nginx status:error",
  "indexes": ["cloudprem--dev--main"],
  "storage_tier": "cloudprem",
  "from": "now-1h",
  "to": "now"
}

Busca contenido específico de registros

Indicación: “Encuentra registros que contengan ’tiempo de conexión agotado’ del servicio API en cloudprem–prod–main de las últimas 24 horas.”

Se traduce a:

{
  "query": "service:api \"connection timeout\"",
  "indexes": ["cloudprem--prod--main"],
  "storage_tier": "cloudprem",
  "from": "now-24h",
  "to": "now"
}

Filtra por código de estado HTTP

Indicación: “Obtén todos los registros con código de estado 500 del índice cloudprem–prod–main en el último día.”

Se traduce a:

{
  "query": "status:500",
  "indexes": ["cloudprem--prod--main"],
  "storage_tier": "cloudprem",
  "from": "now-1d",
  "to": "now"
}

Notas importantes

  • Tanto storage_tier como indexes son requeridos al consultar registros de CloudPrem. Sin estos parámetros, las consultas buscarán en los índices estándar de Datadog en su lugar.
  • storage_tier debe establecerse siempre en "cloudprem".
  • El parámetro indexes debe contener nombres de índices de CloudPrem válidos (en el formato cloudprem--<cluster_name>--<index_name>).
  • Al usar consultas en lenguaje natural, menciona explícitamente el nombre de tu índice de CloudPrem en tu indicación.
  • Los registros de CloudPrem son consultables en tiempo real tan pronto como son indexados.
  • La sintaxis de consulta sigue la sintaxis estándar de búsqueda de registros de Datadog.

Lectura adicional

Más enlaces, artículos y documentación útiles:

Presentamos el servidor MCP de DatadogBLOG more more Extensión de Datadog para VS Code y CursorDOCUMENTATION more more Buscar registros en CloudPremDOCUMENTATION more more