Interrogez BYOC Logs avec le Datadog MCP Server

Ce produit n'est pas pris en charge pour le site Datadog que vous avez sélectionné. ().

Présentation

Utilisez l’outil search_datadog_logs sur le Datadog MCP (Model Context Protocol) Server pour interroger les logs stockés dans les index BYOC (Bring Your Own Cloud) Logs. Vous pouvez accéder à l’outil via des outils et des intégrations basés sur l’IA.

Remarque : les index BYOC Logs sont uniquement pris en charge par search_datadog_logs. L’outil analyze_datadog_logs et le skill datadog/querying-patterns ne prennent pas en charge les index BYOC Logs.

Prérequis

Interrogation de BYOC Logs

Pour interroger les logs stockés dans les index BYOC Logs, utilisez search_datadog_logs et spécifiez le nom de votre index BYOC Logs en plus de votre requête de recherche de logs habituelle.

Pour obtenir de meilleurs résultats, votre prompt devrait également inclure :

  • (Recommandé) Plage temporelle (par exemple, « au cours de la dernière heure », « au cours des dernières 24 heures »).
  • (Recommandé) Filtres de requête (service, statut, contenu des logs).

Paramètres de requête

Le tableau suivant décrit les paramètres clés utilisés avec search_datadog_logs :

ParamètreDescriptionExemple
queryRequête de recherche de logs utilisant la syntaxe de requête Datadog"*" (tous les logs), "service:web", "status:error"
indexesTableau des noms d’index BYOC Logs à rechercher["byoc--dev--main"]
fromHeure de début de la requête"now-1h", "now-24h", "2024-01-15T00:00:00Z"
toHeure de fin de la requête"now", "2024-01-15T23:59:59Z"
sortOrdre de tri des résultats"-timestamp" (décroissant), "timestamp" (croissant)

Pour des exemples de requêtes paramétrées et en langage naturel, consultez Exemples de requêtes avancées.

Trouver le nom de votre index BYOC Logs

Pour trouver le nom de votre index BYOC Logs :

  1. Accédez à Datadog Log Explorer.
  2. Recherchez la section BYOC INDEXES dans le panneau des facettes à gauche.
  3. Vos index BYOC Logs y sont répertoriés, au format byoc--<cluster_name>--<index_name>.

Vous pouvez également trouver les noms de vos index dans la console BYOC Logs en sélectionnant un cluster et en cliquant sur View Indexes.

Exemples de requêtes avancées

Lorsque vous utilisez des outils basés sur l’IA avec search_datadog_logs, vous pouvez poser des questions en langage naturel. L’outil les traduit en requêtes BYOC Logs correctement formatées.

Logs d’erreur d’un service spécifique

Prompt : « Montrez-moi les logs d’erreur du service nginx dans l’index byoc–dev–main au cours de la dernière heure. »

Se traduit par :

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

Rechercher un contenu spécifique dans les logs

Prompt : « Trouvez les logs contenant ‘connection timeout’ provenant du service API dans l’index byoc–prod–main au cours des 24 dernières heures. »

Se traduit par :

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

Filtrer par code d’état HTTP

Prompt : « Trouvez tous les logs associés au code d’état 500 dans l’index byoc–prod–main au cours des dernières 24 heures. »

Se traduit par :

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

Remarques importantes

  • Le paramètre indexes doit contenir des noms d’index BYOC Logs valides (au format byoc--<cluster_name>--<index_name>).
  • Lorsque vous utilisez des requêtes en langage naturel, mentionnez explicitement le nom de votre index BYOC Logs dans votre prompt.
  • Les données BYOC Logs peuvent être interrogées en temps réel dès qu’elles sont indexées.
  • La syntaxe de requête suit la syntaxe de recherche de logs Datadog standard.

Pour aller plus loin