Rechercher et afficher des traces

Page Liste de traces (version classique)

La page Liste de traces vous permet de rechercher et d'examiner des traces individuelles en détail. Vous pouvez afficher et inspecter tous les délais d'une trace, afficher les informations récapitulatives d'une requête et afficher des informations détaillées sur chaque délai de la trace à partir de cette page. Pour limiter les traces analysées, vous pouvez ajouter des filtres. Par exemple, vous pouvez ajouter un filtre pour n'afficher que les traces dont la latence dépasse 1 seconde.

La page Liste de traces stocke et affiche au maximum 1 000 traces.

Pour afficher les traces récentes, dans Google Cloud Console, sélectionnez Trace, puis Liste de traces ou utilisez le bouton suivant :

Accéder à la liste de traces

Si vous utilisez Trace pour la première fois, l'affichage des traces peut prendre quelques minutes. La capture d'écran suivante montre un exemple de liste de traces pour une configuration Compute Engine :

Liste de traces Cloud pour Compute Engine.

Intervalle de temps

Par défaut, la page Liste de traces affiche les données de l'heure précédente. Vous pouvez redéfinir cet intervalle sur des valeurs prédéfinies à l'aide des boutons situés en haut de la page. Les options prédéfinies sont les suivantes :

  • 1 heure
  • 4 heures
  • 12 heures
  • 1 jour
  • 3 jours
  • 1 semaine
  • 1 mois

Par défaut, l'intervalle de temps est défini sur 1 heure.

Pour sélectionner une période personnalisée, utilisez votre pointeur pour mettre en surbrillance une section du graphique de latence. Cette sélection définit l'intervalle de temps et la plage de valeurs de latence pour les traces affichées. Par exemple, l'image suivante sélectionne un intervalle de temps compris entre 19:00 et 6:10 AM dont la latence est comprise entre 90 ms et 390 ms :

Sélectionner une période personnalisée dans le graphique des traces

Pour rétablir l'intervalle de temps prédéfini du graphique, cliquez sur Annuler le zoom.

Filtres

Vous utilisez des filtres pour masquer ou rechercher des traces individuelles. La section précédente explique comment mettre en surbrillance une section du graphique de latence pour afficher un sous-ensemble de traces plus en détail, tout en masquant les autres traces. Dans cette section, le filtre de requête et les menus de filtrage sont décrits.

Par défaut, les filtres sont configurés pour inclure toutes les traces.

Filtre Description
Filtre de requêtes Permet de spécifier une ou plusieurs conditions devant être remplies pour qu'une trace soit affichée. La syntaxe de filtrage vous permet de définir les correspondances sont exactes ou les tests de préfixe. Toutes les correspondances sont sensibles à la casse. Pour en savoir plus sur la syntaxe des filtres de trace, consultez la section Filtres de traces.

Par exemple, pour répertorier toutes les traces d'un projet dont le nom du délai racine est Recv, saisissez le nom du délai racine, Recv, ou un préfixe du nom du délai racine, tel que Re.

Lorsque vous souhaitez répertorier toutes les traces avec des délais annotés avec un libellé /http/status_code compris entre 200 et 299, où la latence est d'une seconde ou plus, et la trace contient un délai avec le nom exact /modules.GetNumInstances, vous utiliseriez le filtre suivant :

    +span:/modules.GetNumInstances latency:1s /http/status_code:2
Dans l'exemple précédent, le terme de filtre de trace +span force une correspondance exacte sur le nom du délai. Si vous souhaitez inclure toutes les traces où /modules.GetNumInstances est un préfixe pour un nom de délai, omettez le signe plus.

Vous n'avez pas besoin d'inclure le délimiteur de chaîne dans les filtres, sauf si votre expression de filtre contient un espace. Par exemple, Recv et "Recv" sont équivalents.
Méthode HTTP La valeur que vous sélectionnez pour ce filtre ne s'applique qu'aux tracés racine annotées avec le libellé /http/method. Vous pouvez inclure toutes les requêtes ou filtrer le type de méthode HTTP : GET, DELETE, POST ou PUT.
État HTTP La valeur que vous sélectionnez pour ce filtre ne s'applique qu'aux tracés racine annotées avec le libellé /http/status_code. Vous pouvez sélectionner des valeurs d'état individuelles, telles que 301, ou des plages de valeurs d'état, telles que 3xx.
Service (App Engine uniquement) Permet de sélectionner des traces en fonction de leur service. La valeur que vous sélectionnez pour le service est testée par rapport à tous les délais d'une trace. Lorsqu'un délai correspond au service, la trace est affichée.
Version (App Engine uniquement) Permet de sélectionner des traces en fonction de la version de l'application. La valeur que vous sélectionnez pour la version est testée par rapport à tous les délais d'une trace. Lorsqu'un délai correspond à la valeur, la trace est affichée.

Graphique de latence

Chaque point du graphique de latence correspond à une requête spécifique. Les coordonnées (x,y) d'une requête correspondent à l'heure et à la latence de la requête.

Lorsque vous placez le pointeur sur un point, une boîte de dialogue s'affiche avec la date, l'heure et la latence :

    5/15/2019, 9:25:02 AM - 69 ms

Lorsque vous cliquez sur un point, les modifications suivantes se produisent :

  • Le tableau est mis à jour pour mettre en surbrillance la requête sélectionnée.
  • Un volet s'ouvre et affiche une chronologie des informations de latence entre les services pour cette requête.
  • Un volet s'affiche. Il contient une table Résumé contenant des informations sur la requête et un tableau Détails contenant des informations sur le délai racine.

Lorsque vous cliquez sur un délai dans la chronologie, le volet Détails affiche des informations supplémentaires sur ce délai. À partir de ce volet, vous pouvez ouvrir et afficher les entrées de journal lorsqu'elles sont disponibles. Pour en savoir plus, consultez la section Afficher les détails des traces.

Tableau des requêtes récentes

Par défaut, le tableau des requêtes récentes affiche les cinq requêtes les plus récentes. Le tableau stocke 1 000 traces.

Attribut Description
Latence Temps de bout en bout pour que l'application traite la requête.
Méthode HTTP Type de méthode HTTP, le cas échéant. Ce champ est vide pour les requêtes non HTTP.
URI URI relatif de la requête.
Rapport d'analyse
Lien vers le rapport d'analyse associé, le cas échéant.
Time Date de début de la requête.

Vous pouvez modifier les requêtes affichées dans le tableau en utilisant l'une des méthodes suivantes :

  • Sélectionnez une période.
  • Parcourez la liste à l'aide des boutons Précédent et Suivant .
  • Cliquez sur l'en-tête d'une colonne pour modifier l'ordre des lignes.
  • Cliquez sur un point dans le graphique de latence.

Étape suivante

La page Liste de traces vous permet de rechercher et d'examiner des traces individuelles en détail. Vous pouvez afficher et inspecter tous les délais d'une trace, afficher les informations récapitulatives d'une requête et afficher des informations détaillées sur chaque délai de la trace à partir de cette page. Pour limiter les traces analysées, vous pouvez ajouter des filtres. Par exemple, vous pouvez ajouter un filtre pour n'afficher que les traces dont la latence dépasse 1 seconde.

La page Liste de traces stocke et affiche au maximum 1 000 traces.

Pour afficher les traces récentes, dans Google Cloud Console, sélectionnez Trace, puis Liste de traces ou utilisez le bouton suivant :

Accéder à la liste de traces

Si vous utilisez Trace pour la première fois, l'affichage des traces peut prendre quelques minutes. La capture d'écran suivante montre un exemple de liste de traces pour une configuration Compute Engine :

Liste de traces Cloud pour Compute Engine.

Intervalle de temps

Par défaut, la page Liste de traces affiche les données de l'heure précédente. Vous pouvez redéfinir cet intervalle sur des valeurs prédéfinies à l'aide des boutons situés en haut de la page. Les options prédéfinies sont les suivantes :

  • 1 heure
  • 6 heures
  • 12 heures
  • 1 jour
  • 2 jours
  • 4 jours
  • 7 jours
  • 14 jours
  • 30 jours

Pour afficher un intervalle de temps personnalisé, procédez comme suit :

  1. Sélectionnez une option prédéfinie qui dépasse l'intervalle de temps personnalisé souhaité.
  2. Placez le pointeur sur le point Sélectionner une trace à une extrémité de l'intervalle de temps et faites-le glisser horizontalement jusqu'à l'autre extrémité de l'intervalle.
  3. (Facultatif) Pour afficher une plage personnalisée de valeurs de latence, placez le pointeur à une extrémité de la plage souhaitée, puis faites-le glisser verticalement vers l'autre extrémité.

Vous pouvez répéter ces actions jusqu'à ce que vous ayez sélectionné l'intervalle de temps et les plages de latence souhaités.

Pour rétablir l'intervalle de temps prédéfini du graphique, cliquez sur Réinitialiser.

Filtres

Vous utilisez des filtres pour masquer ou rechercher des traces individuelles. Chaque filtre est spécifié par une valeur OPTION prédéfinie associée à VALUE. La syntaxe générale est la suivante :

[OPTION] : [VALUE]

Par exemple, la capture d'écran suivante illustre un seul filtre. L'option de filtre est RootSpan et Recv. est la valeur du filtre. Avec ce filtre, seules les traces dont le délai racine est précédé de Recv. sont affichées.

Affichez un filtre.

Pour afficher les traces qui correspondent exactement à Recv., utilisez +Recv. comme valeur de filtre. L'utilisation du signe plus + indique que vous souhaitez obtenir une correspondance exacte. Pour en savoir plus sur les options de filtrage, consultez la page Filtres de traces.

Si vous ajoutez plusieurs filtres, seules les traces correspondant à tous les filtres sont affichées.

Pour ajouter un filtre, procédez comme suit :

  1. Cliquez sur Ajouter un filtre de trace pour afficher un menu d'options de filtre, puis sélectionnez une OPTION. Vous disposez toujours des options suivantes :

    • rootSpan : correspond au nom du délai racine.
    • SpanName : correspond au nom du délai.
    • Méthode : affiche les traces dont les délais racine sont annotés avec le libellé /http/method, où la valeur du libellé correspond à VALUE.
    • État : affiche les traces dont les délais racines sont annotés avec le libellé /http/status_code, où le libellé de valeur correspond à VALUE. Dans ce cas, VALUE peut contenir des codes d'état spécifiques, tels que 301, ou des plages de valeurs d'état, telles que 3xx.
    • MinLatency : affiche les traces dont la latence est d'au moins VALUE millisecondes.
    • hasLabel : affiche les traces où le libellé spécifié par VALUE apparaît dans au moins un délai.
    • Service : (App Engine uniquement) Affiche les traces contenant au moins un délai dont le nom de service correspond à VALUE.
    • Version : (App Engine uniquement) Affiche les traces contenant au moins un délai dont la version de l'application correspond à VALUE.

    D'autres options peuvent s'afficher, telles que URL et LABEL : Client.

  2. (Facultatif) Si vous souhaitez une correspondance exacte, saisissez le signe plus +. Par défaut, une correspondance est déterminée en effectuant un test de préfixe avec VALUE. Pour en savoir plus sur les options de filtrage, consultez la page Filtres de traces.

  3. Spécifiez le filtre VALUE en effectuant l'une des opérations suivantes :

    • Sélection dans le menu VALUE. Les options du menu de valeur ne sont pas garanties comme étant complètes.
    • Saisissez une valeur manuellement, puis appuyez sur return sur votre clavier.

Par exemple, pour afficher toutes les traces contenant une commande HTTP POST et dont la latence est d'au moins 2 secondes, ajoutez un filtre avec l'option MinLatency dont la valeur est 2000.

Graphique de latence

Le graphique intitulé Sélectionner une trace affiche un point pour chaque requête dans l'intervalle de temps sélectionné. Les coordonnées (x,y) d'une requête correspondent à l'heure et à la latence de la requête.

Lorsque vous placez le curseur sur un point, une info-bulle contenant la date, l'heure, l'URI et la latence s'affiche :

Afficher une info-bulle de trace présentant des informations de latence.

Lorsque vous cliquez sur un point, les modifications suivantes se produisent :

  • Le graphique est actualisé et le point que vous avez sélectionné est mis en évidence par un cercle autour du point.
  • Le tableau de requêtes met en surbrillance l'URI sélectionné.
  • Deux nouveaux panneaux peuvent s'ouvrir sur la page Liste de traces. Le graphique en cascade affiche chaque délai dans un URI. Le volet des détails affiche des informations détaillées sur l'URI et inclut des liens vers les journaux et les rapports d'analyse lorsqu'ils sont disponibles. Si ces panneaux sont déjà ouverts, cliquez sur un point pour actualiser les données affichées dans ces derniers.

Tableau des requêtes récentes

Par défaut, le tableau des requêtes récentes affiche les cinq requêtes les plus récentes. Le tableau stocke 1 000 traces.

Attribut Description
Latence Temps de bout en bout pour que l'application traite la requête.
Méthode HTTP Type de méthode HTTP, le cas échéant. Ce champ est vide pour les requêtes non HTTP.
URI URI relatif de la requête.
Rapport d'analyse Lien vers le rapport d'analyse associé, le cas échéant.
Time Date de début de la requête.

Vous pouvez modifier les requêtes affichées dans le tableau en utilisant l'une des méthodes suivantes :

  • Sélectionnez une période.
  • Parcourez la liste à l'aide des boutons Précédent et Suivant .
  • Cliquez sur l'en-tête d'une colonne pour modifier l'ordre des lignes.
  • Cliquez sur un point dans le graphique de latence.

Étape suivante