Rechercher et afficher des traces

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.

Afficher les traces récentes

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 cette page :

Volet de traces récentes dans Cloud Trace.

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 la syntaxe de filtrage, consultez la page Filtres de traces.

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

Ajouter un filtre

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 la touche return de 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.

Modifier un filtre

Pour modifier une valeur de filtre, double-cliquez sur la puce et placez le pointeur sur la valeur de filtre :

  • Vous pouvez effectuer une sélection différente dans le menu des valeurs de filtre.
  • Vous pouvez effacer le texte.
  • Vous pouvez saisir du texte.

Lorsque vous modifiez la valeur d'un filtre, le style du filtre change brièvement.

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