Rechercher des logs

Présentation

Le Log Explorer vous permet de rechercher et d’afficher des logs individuels sous forme de liste. Cependant, les informations les plus précieuses proviennent souvent de l’agrégation des logs à grande échelle. À l’aide de la fonctionnalité de recherche, vous pouvez filtrer les logs et les visualiser sous forme de graphiques de séries temporelles, de listes top, de treemaps, de graphiques circulaires ou de tableaux pour mieux comprendre les tendances, les modèles et les valeurs aberrantes dans vos données de log.

Requêtes en langage naturel

Les requêtes en langage naturel ne sont pas disponibles sur le site Datadog ().

Utilisez les requêtes en langage naturel (NLQ) pour décrire ce que vous recherchez en anglais simple. Datadog traduit automatiquement votre demande en une requête de log structurée, ce qui facilite l’exploration des logs sans avoir à écrire une syntaxe complexe. Pour accéder à cette fonctionnalité, cliquez sur Ask dans le champ de recherche.

Le système traduit les entrées en langage naturel en requêtes Datadog et comprend le contexte tel que les services, les attributs, les tags et les plages temporelles. Il détecte également automatiquement les champs pertinents et permet aux utilisateurs de créer des visualisations à l’aide de descriptions simples, par exemple : « Top 20 des services par erreurs » ou « Afficher les erreurs du service X au cours des 24 dernières heures ».

Pour désactiver NLQ, vous devez disposer des org_management autorisations. Accédez à Organization Settings > Preferences et désactivez la fonctionnalité Requêtes en langage naturel.

Requête de recherche

Une recherche dans le Log Explorer se compose d’une plage temporelle et d’une requête de recherche, combinant key:value et recherche plein texte. Vous pouvez choisir une fenêtre temporelle pour votre recherche à l’aide du sélecteur de plage temporelle situé en haut à droite du Log Explorer. Pour plus de détails sur la définition d’une plage temporelle personnalisée, consultez la documentation sur les plages temporelles personnalisées.

Pour filtrer les logs produits par un service de boutique en ligne, avec un statut d’erreur, au cours des quinze dernières minutes, créez une requête personnalisée comme service:payment status:error rejected et définissez la plage temporelle sur Past 15 minutes :

Créez une requête de recherche dans le Log Explorer qui filtre les logs d'erreur des paiements rejetés pour un service de boutique en ligne

Indexed Logs prennent en charge à la fois la recherche plein texte et les requêtes de recherche key:value.

Remarque : les requêtes key:value ne nécessitent pas que vous déclariez une facette au préalable.

Pour une référence complète sur la syntaxe des requêtes, consultez la documentation sur la syntaxe de recherche.

Fonctionnalités de la barre de recherche

La barre de recherche du Log Explorer inclut plusieurs fonctionnalités pour vous aider à rédiger des requêtes plus efficacement et avec plus de précision.

Coloration syntaxique et validation des erreurs

La coloration syntaxique différencie clairement les types d’entrée : clés, valeurs, texte libre et caractères de contrôle. Par exemple, service et status sont des clés, auth-dotnet et error sont des valeurs, 500 et check-token sont du texte libre, et les parenthèses sont des caractères de contrôle. Les attributs de statut sont codés par couleur selon le statut (rouge pour error, bleu pour info).

La barre de recherche du Log Explorer affichant `service:auth-dotnet status:error 500 (check-token OR create-user)` comme requête avec une coloration syntaxique différenciable

La validation des erreurs identifie les erreurs de syntaxe et suggère des corrections, telles que des valeurs manquantes dans les paires key:value, des requêtes de plage incomplètes ou des parenthèses non fermées.

La barre de recherche du Log Explorer affichant `service:(web-store OR auth-dotnet` comme requête avec le message `Caractère de parenthèse fermante manquant`

Saisie semi-automatique

La fonctionnalité de saisie semi-automatique de la barre de recherche vous aide à compléter vos requêtes en utilisant les clés et valeurs existantes dans vos logs, vos recherches récentes et vos vues enregistrées.

La barre de recherche du Log Explorer affichant service: comme requête et emailer, balancer-checker, ad-server et vpc comme options de saisie semi-automatique

La saisie semi-automatique suggère des facettes et des valeurs en fonction de votre saisie, affichées dans l’ordre dans lequel elles apparaissent dans le panneau des facettes. Après avoir sélectionné une facette et saisi :, les valeurs apparaissent par ordre décroissant selon le nombre de logs des 15 dernières minutes.

La barre de recherche du Log Explorer affichant `network` comme requête et les facettes @network.bytes_written, @network.client.ip et @network.interface comme options de saisie semi-automatique

Vos 100 recherches les plus récentes sont conservées et suggérées au fur et à mesure que vous tapez. Les vues enregistrées qui correspondent à votre requête sont également suggérées, affichées dans le même ordre que dans le panneau Saved Views.

La barre de recherche des logs affichant `service:web-store status:error` comme requête et des recherches récentes pour différentes erreurs du service web-store comme options de saisie semi-automatique

Cliquez sur le bouton à droite de la barre de recherche pour effectuer une recherche en mode brut et ainsi désactiver la coloration syntaxique, la mise en forme des boutons de recherche et la complétion automatique :

La barre de recherche des logs affichant `service:auth-dotnet status:error 500 (check-token OR create-user)` comme requête en mode de recherche brute

Vous pouvez interagir avec la barre de recherche à l’aide de votre souris, ainsi qu’en utilisant des commandes clavier. Par exemple, utilisez CMD-A pour sélectionner du texte, CMD-C pour copier du texte, CMD-X pour couper du texte et CMD-V pour coller du texte.

Pour aller plus loin