Recherche de traces
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Recherche de traces

Barre de recherche

Tous les paramètres de recherche sont contenus dans l’URL de la page. Il est donc très facile de partager votre vue.

Syntaxe de recherche

Une requête est composée de termes et d’opérateurs.

Il existe deux types de *termes* :

Pour combiner plusieurs termes dans une requête complexe, utilisez l’un des opérateurs booléens suivants :

OpérateurDescriptionExemple
ANDIntersection : les deux termes figurent dans les événements sélectionnés (si aucun opérateur n’est ajouté, AND est utilisé par défaut).authentication AND failure
ORUnion : un des deux termes figure dans les événements sélectionnés.authentication OR password
-Exclusion : le terme suivant ne figure PAS dans les événements sélectionnés.authentication AND -password

Recherche de facettes

Pour effectuer une recherche en fonction d’une facette spécifique, vous devez d’abord l’ajouter comme facette puis utiliser @ pour spécifier que vous faites une recherche à partir d’une facette.

Par exemple, si le nom de votre facette est url et que vous souhaitez filtrer en fonction de la valeur www.datadoghq.com, il vous suffit de saisir :

@url:www.datadoghq.com

Recherche de tags

Vos traces héritent des tags des hosts et des intégrations qui les génèrent. Elles peuvent être utilisées dans une recherche ainsi que sous la forme de facettes :

RequêteRésultat
("env:prod" OR test)Toutes les traces avec le tag #env:prod ou le tag #test
(service:srvA OR service:srvB) ou (service:(srvA OR srvB))Toutes les traces qui contiennent les tags #service:srvA ou #service:srvB.
("env:prod" AND -"version:beta")Toutes les traces qui contiennent #env:prod et qui ne contiennent pas #version:beta

Si vos tags ne respectent pas les recommandations relatives aux tags et n’utilisent pas la syntaxe key:value, utilisez cette requête de recherche :

  • tags:<MON_TAG>

Wildcards

Afin d’effectuer une recherche générique avec plusieurs caractères, utilisez le symbole * comme illustré ci-dessous :

  • service:web* renvoie toutes les traces dont le service commence par web.
  • @url:data* renvoie toutes les traces dont l’adresse url commence par data.

Valeurs numériques

Utilisez les caractères <, >, <= ou >= pour effectuer une recherche avec des attributs numériques. Par exemple, pour récupérer toutes les traces avec un délai de réponse supérieur à 100 ms :

@http.response_time:>100

Vous pouvez également effectuer une recherche d’attribut numérique dans une plage spécifique. Par exemple, pour récupérer toutes les erreurs 4xx :

@http.status_code:[400 TO 499]

Saisie automatique

La saisie de requête complexe peut être fastidieuse. Utilisez la fonctionnalité de saisie automatique de la barre de recherche pour compléter votre requête en utilisant des valeurs existantes :

Échappement de caractères spéciaux

Les attributs suivants sont considérés comme spéciaux : ?, >, <, :, =,", ~, /, et \. Ils requièrent par conséquent le caractère d’échappement \. Par exemple, pour rechercher les traces qui contiennent user=AliceMartin dans leur url, saisissez la recherche suivante :

@url:*user\=AliceMartin*

La même logique s’applique aux espaces dans les attributs de trace. Les attributs de trace ne sont pas supposés contenir d’espaces, mais s’ils en ont, les espaces doivent être précédées du caractère d’échappement. Si un attribut est appelé user.first name, effectuez une recherche sur cet attribut en ajoutant un caractère d’échappement devant l’espace :

@user.first\ name:mavaleur

Recherches enregistrées

Ne perdez pas de temps à créer les mêmes vues tous les jours. Les recherches enregistrées contiennent votre requête de recherche, les colonnes et l’horizon temporel. Pour retrouver une recherche enregistrée, saisissez son nom ou sa requête dans la barre de recherche et utilisez la saisie automatique.

Pour supprimer une recherche enregistrée, cliquez sur l’icône en forme de corbeille sous le menu déroulant de recherche de traces.

Intervalle

L’intervalle vous permet d’afficher les traces correspondant à une période donnée. Changez rapidement l’intervalle en sélectionnant une durée prédéfinie dans la liste déroulante. Vous pouvez également saisir un intervalle personnalisé :

Flux de traces

Le flux de traces regroupe la liste des traces qui correspondent au contexte sélectionné. Un contexte est défini par un filtre de barre de recherche et un intervalle.

Traces et spans analysées

Dans le flux de traces, sélectionnez View in App Analytics pour consulter les traces et les spans analysées. Pour afficher un échantillon de trace associé à vos spans analysées, cliquez sur le bouton Traces dans le coin supérieur droit :

Si vous sélectionnez l’option Traces, les spans analysées affichées dans le flux de traces sont associées à un échantillon de trace. Si vous sélectionnez l’option Analyzed Spans, le flux de traces affiche uniquement les spans analysées.

Lorsqu’une requête parvient à un service (par exemple, un serveur Web ou une base de données), l’Agent Datadog crée une span analysée. Il s’agit d’un enregistrement de la requête qui inclut sa durée, le code de réponse et toutes les métadonnées personnalisées. Une span analysée correspond à une span unique accompagnée de métadonnées concernant la requête gérée. Pour chaque service qui reçoit une requête, l’Agent crée une span analysée. Si une requête transite par un service Web, un service de référencement et un service de base de données, cette requête génère 3 spans analysées. Pour réduire le nombre de spans analysées générées, activez ou désactivez explicitement toute collecte de spans analysées pour un service spécifique. Pour commencer à recueillir des spans analysées, activez la fonction App Analytics pour vos services.

Afficher une trace complète

Cliquez sur une trace pour l’examiner plus en détail :

Colonnes

Pour ajouter plus d’informations de tracing à la liste, cliquez sur le bouton Options et sélectionnez les facettes que vous souhaitez visualiser :

La colonne Origin resource est affichée par défaut. Elle indique la ressource à la racine de la trace donnée. Pour ajouter un service d’origine ou un nom d’opération d’origine, cliquez sur le bouton Options et sélectionnez @trace.origin.operation_name ou @trace.origin.service.

Affichage multiligne

Choisissez d’afficher une, trois ou dix lignes à partir de vos traces. L’affichage de trois et dix lignes vous offre davantage d’informations sur l’attribut error.stack.

  • Avec une ligne affichée :

  • Avec trois lignes affichées :

  • Avec dix lignes affichées :

Facettes

Une facette présente toutes les valeurs distinctes d’un attribut ou d’un tag, en plus de proposer des analyses de base, comme la quantité de traces représentées. Son activation permet également de filtrer vos données.

Les facettes vous permettent de faire pivoter ou de filtrer vos ensembles de données en fonction d’un attribut donné. Les facettes peuvent correspondre à des utilisateurs, des services, etc.

Facettes quantitatives : les mesures

Les mesures vous permettent d’accomplir les tâches suivantes : * Agréger des valeurs à partir de plusieurs traces. Vous pouvez par exemple créer une mesure sur le nombre de lignes dans Cassandra et visualiser le 95e centile ou les principaux référents selon la somme des tailles de fichiers demandée. * Calculer les services avec la plus forte latence pour les paniers dépassant 1 000 €. * Filtrer des valeurs continues, par exemple la taille en octets de chaque bloc de charge utile d’un flux vidéo.

Types

Les mesures disposent d’un nombre entier (long) ou d’une double valeur. Ces deux types de valeurs proposent des fonctionnalités équivalentes.

Unités

Les mesures ont une unité (le temps est exprimé en secondes ou les tailles en octets) afin de gérer les ordres de grandeur au moment de la requête et de l’affichage. L’unité est une propriété de la mesure, et non du champ. Prenons l’exemple d’une mesure « duration » exprimée en nanosecondes. Vous disposez de tags de span du service service:A, pour lesquels duration:1000 désigne la durée 1000 milliseconds, et d’autres tags de span du service service:B, pour lesquels duration:500 désigne la durée de 500 microseconds : Grâce au processeur arithmétique, vous pouvez faire en sorte que les durées de tous vos tags de span transmis soient exprimées en nanosecondes. Pour ce faire, ajoutez le multiplicateur *1000000 aux tags de span de service:A et le multiplicateur *1000 aux tags de span de service:B. Appliquez le filtre duration:>20ms (voir la syntaxe de recherche pour en savoir plus) pour interroger systématiquement les tags de span des deux services à la fois et pour afficher un résultat agrégé ayant pour valeur maximale une minute.

Créer une facette

Pour commencer à utiliser un attribut en tant que facette ou dans une recherche, cliquez dessus et ajoutez-le en tant que facette :

Lorsque vous avez terminé, la valeur de cet attribut est stockée pour toutes les nouvelles traces et peut être utilisée dans la barre de recherche, le volet Facettes et la requête de graphique de trace.

Volet Facettes

Utilisez les facettes pour filtrer vos traces. La barre de recherche et l’URL s’adaptent automatiquement à vos sélections.

Pour aller plus loin