Rechercher et explorer des traces

La page Explorateur de traces vous permet de rechercher et d'examiner en détail des traces individuelles. 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 Explorateur de traces stocke et affiche 1 000 traces au maximum.

Trouver une trace

Pour afficher les traces récentes, procédez comme suit:

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Trace, puis Explorateur de traces:

   Accéder à Explorateur 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 la page Explorateur de traces:

   

   Le graphique à nuage de points 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.

   • Les informations d'erreur sont encodées dans la couleur d'un point. Le bleu indique une réussite, et le rouge indique un échec. Dans la capture d'écran précédente, la plupart des commandes ont bien été exécutées.

   • L'info-bulle qui s'active lorsque vous maintenez le pointeur sur un point, affiche la date, l'heure, l'URI et la latence:

     

2. Facultatif. Définissez l'intervalle de temps. Par défaut, l'heure la plus récente de données est affichée. Pour afficher un intervalle de temps personnalisé, procédez comme suit :

   1. Sélectionnez une option prédéfinie plus longue que l'intervalle de temps personnalisé souhaité.
   2. Placez votre pointeur sur le tracé Select a trace (Sélectionner une trace) à une extrémité de l'intervalle de temps et faites glisser le pointeur horizontalement vers l'autre extrémité de l'intervalle.

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

3. Facultatif. Pour afficher une plage personnalisée de valeurs de latence, placez le pointeur à une extrémité de la plage souhaitée et faites-le glisser verticalement vers l'autre extrémité.

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

4. Facultatif. Pour n'afficher que certaines traces, cliquez sur Ajouter un filtre de trace , sélectionnez une option de filtre, puis une valeur de filtre.

   Par exemple, pour afficher toutes les traces contenant une commande HTTP GET et dont la latence est d'au moins 2 secondes, ajoutez les filtres Method: GET et MinLatency: 2000.

   L'option de filtrage suivante est toujours disponible:

   • RootSpan : correspond au nom du délai racine.
   • SpanName : correspond au nom du délai.
   • Méthode: affiche les traces dont les délais racines sont annotés avec le libellé /http/method, et dont la valeur du libellé correspond à la valeur du filtre.
   • État: affiche les traces dont les délais racines sont annotés avec le libellé /http/status_code, les libellés de valeur correspondant à la valeur du filtre. La valeur de filtre 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 au moins égale à la valeur du filtre. La valeur du filtre doit être exprimée en millisecondes.
   • HasLabel: affiche les traces où le libellé spécifié par la valeur de filtre apparaît dans au moins un segment.

   • Service: affiche les traces qui contiennent au moins un segment dont le nom de service correspond à la valeur du filtre.

     Le nom du service d'un segment est extrait de l'attribut OpenTelemetry service.name, lorsque cet attribut est défini. Si cet attribut n'est pas défini et que le service s'exécute sur App Engine, le nom du service App Engine s'affiche. Sinon, le service n'est pas spécifié.

   • Version: (App Engine uniquement) affiche les traces qui contiennent au moins un segment dont la version de l'application correspond à la valeur du filtre.

   D'autres options de filtrage peuvent s'afficher, comme l'URL ou les étiquettes HTTP. Si l'un de vos libellés défini par l'utilisateur correspond à un filtre prédéfini, il porte le préfixe LABEL afin que vous puissiez le distinguer. Par exemple, si vous créez un libellé Service, Service et LABEL:Service s'affichent à la fois dans le menu de filtrage.

   Vous pouvez saisir manuellement la valeur du filtre. Autrement dit, vous n'avez pas besoin de sélectionner les valeurs disponibles.

   Remarque :Pour obtenir une correspondance exacte, faites précéder la valeur du filtre d'un signe plus (+). Si vous omettez le signe plus, une correspondance est déterminée en effectuant un test de préfixe avec la valeur du filtre. Pour en savoir plus sur les options de filtrage, consultez la section Filtres de traces.

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

Explorer une trace

Pour explorer une trace, cliquez sur un point du graphique en nuage de points. Lorsque vous cliquez sur un point du nuage de points, les modifications suivantes se produisent sur la page Explorateur de traces:

• Le graphique à nuage de points est actualisé et un cercle s'affiche autour du point sélectionné pour le mettre en évidence. Les points représentant toutes les autres traces sont grisés.

• Le volet Trace details (Détails des traces) affiche les éléments suivants:

  • Identifiant de trace. Cet identifiant unique global de la trace est un entier de 128 bits représenté par une chaîne hexadécimale de 32 octets. Pour en savoir plus, consultez Resource: Trace.

  • Ligne récapitulative indiquant l'heure de début, la durée et le nombre de délais.

  • Un menu Journaux et événements La sélection du menu contrôle l'affichage des journaux et des événements. Par défaut, lorsqu'un journal ou un événement existe, un cercle est ajouté au délai de trace. Les cercles qui se chevauchent indiquent que le segment comporte plusieurs journaux ou événements. Pour afficher chaque journal ou événement sur une ligne de la table, développez Journaux et événements, puis sélectionnez Afficher les éléments développés.

  • Un tableau. La première ligne de la table correspond à la trace. Une ligne est ajoutée à la table pour chaque délai de la trace.

    Le tableau indique le nom des segments et le service qui leur est associé. Le nom du service est extrait de l'attribut OpenTelemetry service.name, lorsque cet attribut est défini. Si cet attribut n'est pas défini et que le service s'exécute sur App Engine, le nom du service App Engine s'affiche. Sinon, le service n'est pas spécifié.

    La colonne Latence fournit une représentation visuelle de la latence, de l'état et, le cas échéant, des annotations d'événements. Une barre de latence bleue indique une opération réussie, une barre de latence rouge indique qu'une erreur s'est produite. Chaque annotation d'événement dans l'espace est représentée par un cercle sur la barre de latence.

Voici un exemple de volet Trace details (Détails des traces) :

Afficher les détails du délai

Remarque :Pour développer le volet Trace details (Détails des traces) afin de remplir la page Trace explorer (Explorateur de traces), accédez à la barre d'outils du volet Trace details (Détails des traces), puis cliquez sur Développer les détails de trace.

Pour afficher des informations détaillées sur la trace ou sur un délai spécifique, dans le volet Détails de la trace, cliquez sur la barre de latence de l'entrée. Lorsque vous sélectionnez la barre de latence, le volet Trace details (Détails des traces) est redessiné et affiche un tableau à onglets qui fournit des informations supplémentaires sur l'entrée.

Si vous sélectionnez la barre de latence pour la première ligne du tableau, la ligne portant le nom ID de trace, le tableau contient deux onglets: Résumé et Journaux. L'onglet Summary (Résumé) répertorie les informations générales sur la trace. Par exemple, pour les commandes HTTP, cet onglet affiche le type de commande HTTP, le service et les informations de latence pour chaque délai de la trace.

Si vous sélectionnez la barre de latence pour d'autres lignes du tableau (c'est-à-dire une ligne pour un segment), le tableau contient quatre onglets : Attributes (Attributs), Logs & events (Journaux et événements), Stacktraces (Traces de pile), Metadata & Links (Métadonnées et liens) :

• Pour trouver les libellés associés à un segment, consultez l'onglet Attributs. Pour plus d'informations sur les étiquettes, consultez la section Étiquettes de trace. La capture d'écran suivante illustre cet onglet:

  

  Pour localiser un libellé spécifique ou un groupe de libellés, ajoutez un filtre. Par exemple, si vous ajoutez le filtre Key: g.co, le tableau liste tous les libellés dont la clé de libellé contient g.co.

• Pour afficher des informations sur les entrées de journal et les événements associés, consultez l'onglet Journaux et événements lorsqu'ils existent. Pour en savoir plus sur les annotations d'événement, consultez la section Annoter les délais de trace. La capture d'écran suivante illustre cet onglet:

  

  Lorsque des données de journal sont disponibles, pour afficher les détails d'une entrée de journal, cliquez sur Show more (Afficher plus) :

  

• Pour en savoir plus sur le nombre de traces de piles disponibles et sur une trace de pile capturée, accédez à l'onglet Stacktraces (Traces de piles).

• Pour obtenir des informations générales sur le segment et une table de liens vers d'autres segments, consultez l'onglet Métadonnées et liens. Ces informations incluent les éléments suivants:

  • ID du délai

    L'ID de segment est un entier de 64 bits autre que 0. Pour en savoir plus, consultez TraceSpan.

  • ID de segment parent

  • ID du projet

  • Heures de début et de fin

  • Table répertoriant les liens vers d'autres segments

    Chaque ligne de la table Liens répertorie un lien entre le délai actuel et un autre délai. Le champ Attributes (Attributs) répertorie les paires clé/valeur du segment associé. Le champ Trace renvoie à la trace du délai lié au délai. Lorsque ce champ contient Trace actuelle, le délai associé au délai se trouve dans la même trace que le délai actuel. Sinon, le champ contient un ID de trace. Pour en savoir plus sur les liens, consultez la page de référence de l'API Links.

  La capture d'écran suivante illustre cet onglet:

  

Étapes suivantes

• Ajouter des annotations d'événement aux délais de trace
• Créer et afficher des rapports
• Afficher les traces de plusieurs projets