Afficher les détails des traces

Si vous sélectionnez une trace, Cloud Trace en affiche les détails sur la page Liste de traces. Il présente un récapitulatif des détails de la requête, un historique graphique indiquant le délai racine de la requête et les sous-délais de tous les appels RPC, ainsi qu'un écran détaillé des données de latence recueillies pour les délais.

Afficher les détails des traces

  1. Dans Google Cloud Console, accédez à la page Liste de traces :

    Accéder à la liste de traces

  2. Il existe plusieurs façons d'afficher des informations détaillées sur une trace :

    • Cliquez sur son URI répertorié dans le tableau.
    • Cliquez sur son point dans le graphique.
    • Dans la vue Détails de la trace sélectionnée, saisissez l'ID de trace au format hexadécimal. Si vous saisissez un ID de trace, un message Selected trace may not match current filters ou Selected trace is outside the current time range peut s'afficher. Ces messages d'information indiquent que la trace affichée ne correspond pas à vos filtres ou aux paramètres de période.

Volet des détails de la trace sélectionnée

Si vous choisissez une trace à examiner, les détails de la trace sélectionnée sont affichés :

  • La zone de texte Détails de la trace sélectionnée affiche l'identifiant de cette trace.

  • Un volet affiche une représentation graphique des données de latence de la requête à l'aide d'un graphique en cascade. Par défaut, le délai racine de la trace sélectionnée est mis en surbrillance.

  • Un volet affiche, dans une série de tables, des informations détaillées sur le délai mis en surbrillance dans le graphique en cascade.

Ces champs sont actualisés avec de nouvelles données chaque fois que vous sélectionnez une trace à examiner. La capture d'écran suivante illustre ces volets :

Volet de détails de Cloud Trace.

Graphique en cascade

Chaque ligne du graphique en cascade correspond à un délai de la trace :

  • Si le symbole s'affiche, Cloud Trace a détecté un délai dont l'heure de début est antérieure à l'heure de début de son parent. Cloud Trace compense automatiquement cette incohérence lors de l'affichage du délai. Cependant, les données de délai ne sont pas modifiées.

    L'incohérence d'horodatage peut se produire lorsqu'un service repose sur plusieurs sources d'horloge ou différentes bibliothèques de langages.

  • Si le symbole est affiché, cela signifie que le délai contient une erreur HTTP.

  • Nom de l'appel RPC au format nom_du_service.nom_de_l'appel. Exemple :datastore_v3.RunQuery

    Pour l'environnement standard App Engine, le nom interne indiqué ici peut ne pas correspondre à celui d'une API de service spécifique à un langage.

  • Temps nécessaire pour effectuer l'appel RPC aller-retour.

Case à cocher Afficher les événements

Si vous cochez la case Afficher les événements, le graphique en cascade est redessiné et les annotations d'événement sont incluses sous forme de lignes dans le graphique. Pour en savoir plus sur les annotations, consultez la page Annoter des délais.

Cliquer pour copier

Vous pouvez copier l'URL de la vue détaillée d'une trace spécifique dans le presse-papiers en cliquant sur Copier .

Tables contenant des détails sur les délais

Ces tables contiennent des informations détaillées sur la ligne en surbrillance dans le graphique en cascade. Chaque ligne du graphique en cascade correspond à un délai de trace.

Si vous mettez en surbrillance une ligne, les détails de ce délai incluent son nom d'URI, l'heure de début relative et le nom de l'appel RPC.

Les données affichées dans les tables varient en fonction de l'élément mis en surbrillance. Toutefois, les données répertoriées dans le tableau suivant sont toujours affichées :

Valeur Description
Heure de début relative La première entrée correspond à l'heure de début relative du délai.

Pour les délais racine, cette valeur est toujours @0 ms.

Pour les sous-délais, il s'agit du moment où le sous-délai a commencé par rapport au début de la requête. Autrement dit, cette valeur indique le temps écoulé entre le début de la requête globale et le début de cet appel RPC.
Nom L'entrée suivante est le nom de l'appel RPC. Les noms sont au format suivant : service_name.call_name. Par exemple, datastore_v3.RunQuery.

Pour l'environnement standard App Engine, le nom interne indiqué ici peut ne pas correspondre à celui d'une API de service spécifique à un langage.

Si un délai racine est mis en surbrillance et que la requête est une requête HTTP, une table nommée Récapitulatif s'affiche. La table contient une ligne pour le délai racine et une ligne pour chaque RPC :

Tableau récapitulatif
Colonne
Description
Nom Nom de l'appel RPC au format nom_du_service.nom_de_l'appel. Cette information est affichée dans le libellé de délai.
RPC Nombre d'appels de la procédure.
Durée totale Temps total passé à exécuter les RPC.

La table intitulée Détails répertorie les métadonnées sur le délai. Les propriétés suivantes sont toujours affichées :

Tableau Détails
Propriété
Description
Temporel Heure à laquelle l'application a reçu la requête entrante.
Journal Lien vers une entrée de journal si des données de journal sont disponibles. Si aucune donnée de journal n'est disponible, cette ligne est omise.
Rapport Lien vers le rapport d'analyse le plus récent incluant cette trace. Si aucun rapport n'inclut cette trace, cette ligne est omise.
ID de la trace Pour afficher ce champ, cliquez sur le menu Détails .

Identifiant global unique de la trace. Cet identifiant est une forme numérique de 128 bits représentée sous la forme d'une chaîne hexadécimale de 32 octets. Pour plus d'informations, consultez la section Resource: Trace.

ID du délai Pour afficher ce champ, cliquez sur le menu Détails .

Identifiant du délai. Cet identifiant est un entier numérique de 64 bits autre que 0. Pour plus d'informations, consultez la section TraceSpan.

Conteneur GKE

Lorsque cette table s'affiche, le délai contient des libellés canoniques pour un conteneur GKE. Chaque ligne de la table correspond à un libellé spécifique. La valeur est un lien que vous pouvez utiliser pour afficher plus de détails sur la ressource. Pour obtenir des informations détaillées sur tous les libellés, consultez la page Libellés de trace.

Les libellés et leur signification sont répertoriés dans le tableau suivant :

Libellé Value
Project ID Projet Google Cloud hébergeant le cluster GKE. Cliquez sur le nom du projet pour accéder au tableau de bord GKE dans Google Cloud Console.
Cluster Name Identifie le cluster GKE. Pour accéder à la page de configuration Clusters, cliquez sur cette valeur.
Namespace Identifie l'espace de noms. Pour accéder à la page Charges de travail de GKE, cliquez sur cette valeur.
Pod Name Identifie le pod GKE. Pour accéder au tableau de bord Informations sur les pods, cliquez sur cette valeur.
Container Name Identifie le conteneur GKE. Pour accéder à la page de détails du conteneur, cliquez sur cette valeur.
Libellés Table de libellés et de valeurs dans la requête. Les libellés sont spécifiques à l'application. Pour obtenir des informations détaillées sur tous les libellés, consultez la page Libellés de trace.

Quelques libellés courants et leur signification sont répertoriés dans le tableau suivant :

Libellé Value
http/host Nom de l'hôte où l'application s'exécute.
http/response/size Nombre d'octets dans le corps de la réponse HTTP.
http/url URL relative à la requête.
gae/request_log_id ID de la requête App Engine interne.

Des propriétés supplémentaires peuvent être répertoriées lorsque votre requête est de type HTTP ou lorsque votre application s'exécute sur App Engine. Le tableau suivant affiche une liste partielle de certaines propriétés fréquemment observées :

Valeur Description
Temps tracé (HTTP uniquement) Temps total nécessaire à l'exécution de tous les appels RPC.
Temps non tracé (HTTP uniquement) Temps pendant lequel aucun appel RPC n'a été effectué. Autrement dit, cela mesure le temps passé localement dans l'application. Notez qu'un temps non tracé plus long que la normale au début d'une requête est souvent dû à une instance créée pour gérer la charge.
Méthode HTTP (HTTP uniquement) Méthode HTTP de la requête.
Service (App Engine uniquement) Service App Engine qui a traité la requête. Pour en savoir plus, consultez la page App Engine.
Version (App Engine uniquement) Version de l'application qui a traité la requête.

Si vous mettez en surbrillance un événement, les détails de l'événement s'affichent dans le volet des détails. Par défaut, les événements ne sont pas affichés dans le graphique en cascade. Pour les inclure dans le graphique en cascade, cliquez sur Afficher les événements.

Insights

Les insights sur les performances de la requête sont affichés sous la chronologie, lorsqu'ils sont disponibles.

Pour en savoir plus, consultez la section Insights.

Annoter des délais

Vous pouvez annoter une trace à l'aide de l'API Cloud Trace v1 ou de l'API Cloud Trace v2. Cette section décrit les différentes options disponibles.

Pour associer une trace à un objet LogEntry Cloud Logging, utilisez des annotations. Pour en savoir plus sur l'intégration entre Cloud Trace et Cloud Logging, consultez la section Intégration à Cloud Logging.

Annoter avec des libellés

Vous pouvez ajouter des annotations aux délais en créant un objet labels et en l'associant à l'objet TraceSpan lorsque vous utilisez l'API Cloud Trace v1 patchTraces.

Ces annotations sont affichées sous forme de libellés lorsque vous affichez les détails d'une trace. Pour en savoir plus sur les libellés, consultez la section Libellés Trace.

Annoter avec des attributs

Vous pouvez annoter des délais en créant un objet attributes et en l'associant à l'objet Span lorsque vous utilisez l'API Cloud Trace v2 batchWrite.

Ces annotations sont affichées sous forme de libellés lorsque vous affichez les détails d'une trace. Pour en savoir plus, consultez la section Afficher les détails des traces sur cette page.

Annoter avec des événements temporels

Vous pouvez ajouter des annotations et des événements de message aux délais en créant un objet TimeEvents et en l'associant à l'objet Span lorsque vous utilisez l'API Cloud Trace v2 batchWrite.

L'objet TimeEvents est un tableau d'objets TimeEvent, chacun contenant un événement de message et une annotation.

Pour afficher le TimeEvents d'une trace, accédez au graphique en cascade de traces et cliquez sur Afficher les événements. Si vous sélectionnez un TimeEvent, ses détails s'affichent dans le volet de détails.

Étape suivante