Rechercher et explorer des traces

Pour rechercher et explorer des traces individuelles en détail, utilisez la page Explorateur de traces. Cette page affiche les traces pour lesquelles votre projet Google Cloud stocke au moins un intervalle. Les données affichées pour chaque trace et intervalle affichés incluent des informations récapitulatives, telles que la latence et le type de commande, ainsi que des informations détaillées. Les informations détaillées incluent les journaux, les événements et d'autres informations.

La page Explorateur de traces affiche au maximum 1 000 traces.

Avant de commencer

Pour obtenir les autorisations nécessaires pour afficher les données de trace à l'aide de la console Google Cloud, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur Cloud Trace (roles/cloudtrace.user) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles, consultez la section Contrôler les accès avec Identity and Access Management.

Afficher les traces récentes

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

1. Dans la console Google Cloud, accédez à la page Explorateur Trace.

   Accéder à Explorateur Trace

   Vous pouvez également accéder à cette page à l'aide de la barre de recherche.

   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 Trace Explorer (Explorateur de traces) :

   

   Le graphique en 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 codées en fonction de la couleur d'un point. Le bleu indique la réussite et le rouge l'échec. Dans la capture d'écran précédente, la plupart des commandes ont bien été exécutées.

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

     

2. Facultatif: Pour filtrer les traces et les segments affichés, effectuez l'une des opérations suivantes:

   • Filtrez par période. Par défaut, l'heure de données la plus récente est affichée. 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é.
     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.

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

   • Filtrez par latence. Par défaut, toutes les traces de l'intervalle de temps sélectionné sont affichées. Pour limiter l'affichage aux traces dont la latence se situe dans un intervalle, placez le pointeur à une extrémité de la valeur de latence, puis 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.

   • Cliquez sur Ajouter un filtre de trace, sélectionnez une option de filtre, puis sélectionnez ou saisissez une valeur de filtre. Si vous ajoutez plusieurs filtres, seules les traces correspondant à tous les filtres sont affichées. 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 racine sont annotés avec le libellé /http/method, où 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, où le libellé de valeur correspond à la valeur du filtre. La valeur du 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 d'au moins 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 du filtre apparaît dans au moins un intervalle.

     • Service: affiche les traces contenant au moins un délai 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 est en cours d'exécution 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 contenant au moins un délai dont la version de l'application correspond à la valeur du filtre.

     D'autres options de filtre peuvent s'afficher, telles que URL ou des libellés HTTP. Si un libellé défini par l'utilisateur correspond à un filtre prédéfini, il est précédé de LABEL afin que vous puissiez les distinguer. Par exemple, si vous créez un libellé Service, les options Service et LABEL:Service s'affichent dans le menu des filtres.

     Remarque :Pour effectuer une correspondance exacte, préfixez 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.

Trouver une trace par ID

Lorsque vous dépannez un incident ou une défaillance, vous pouvez connaître l'ID de trace. Pour explorer cette trace, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Explorateur Trace.

   Accéder à Explorateur Trace

   Vous pouvez également accéder à cette page à l'aide de la barre de recherche.

2. Sélectionnez un projet Google Cloud à partir duquel afficher les données de trace.

   Vous devez sélectionner le projet Google Cloud qui stocke les données de trace, sauf si votre projet fait partie d'une organisation. Lorsqu'un projet fait partie d'une organisation, vous pouvez configurer le traçage inter-projets, ce qui vous permet d'afficher les données de trace de n'importe quel projet de l'organisation. Pour en savoir plus, consultez la section Afficher les traces de plusieurs projets.

3. Saisissez l'ID dans le champ ID de trace.

   Lorsque vous saisissez un ID valide, le volet Détails de la trace est renseigné avec des informations sur la trace et ses délais. Vous pouvez utiliser les options de ce volet pour explorer la trace.

Explorer une trace

Pour explorer une trace, cliquez sur un point du nuage de points. Lorsque vous cliquez sur un point dans le graphique en nuage de points, les modifications suivantes sont apportées à 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 de la trace) affiche les informations suivantes:

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

  • Ligne récapitulative qui indique l'heure de début, la durée et le nombre de périodes.

  • 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é à la période de suivi. Les cercles qui se chevauchent indiquent que la période comporte plusieurs journaux ou événements. Pour afficher chaque journal ou événement sous forme de ligne dans le tableau, développez Journaux et événements, puis sélectionnez Afficher développé.

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

    Pour les segments, le tableau indique le nom du segment et le service 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 est en cours d'exécution 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énement. Une barre de latence bleue indique une réussite, tandis qu'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.

L'exemple suivant illustre un volet Détails de la trace:

Rechercher des segments dans une trace

Vous pouvez rechercher des mots clés dans les plages et les attributs d'une trace. Par exemple, dans la capture d'écran précédente, certaines plages et une clé d'attribut sont mises en évidence. Ces champs sont mis en surbrillance, car ils correspondent au terme de recherche, qui était net.sock.peer.port.

Pour rechercher des plages dans une trace, dans la barre d'outils du volet Informations sur la trace, saisissez le terme de recherche dans le champ Rechercher dans la trace, puis appuyez sur Entrée.

La trace recherche ensuite certains champs de chaque étendue dans la trace affichée. Une correspondance se produit lorsqu'un champ de recherche contient le terme de recherche, sans tenir compte de la casse. Les champs suivants sont recherchés:

• Nom du segment.
• Nom du service.
• Clés et valeurs des attributs.

Une fois la recherche terminée, le volet Détails de la trace est actualisé et les champs correspondants sont mis en surbrillance.

Par exemple, si vous saisissez le terme get, un intervalle avec un attribut dont la clé est /http/method et la valeur GET est mis en surbrillance. De plus, les plages portant des noms tels que CurrencyService/GetSupportedCurrencies sont mises en surbrillance.

Vous ne pouvez pas effectuer de recherche à l'aide d'une expression régulière, ni rechercher des journaux, des événements ou des métadonnées.

Afficher les détails du segment

Remarque :Pour développer le volet Détails de la trace afin qu'il remplisse la page Explorateur de traces, accédez à la barre d'outils du volet Détails de la trace, puis cliquez sur Développer les détails de la trace.

Pour afficher des informations détaillées sur la trace ou sur un segment 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 Détails de la trace est redessiné et affiche un tableau à onglets fournissant des informations supplémentaires sur l'entrée.

Si vous sélectionnez la barre de latence de la première ligne du tableau (celle intitulée ID de trace), le tableau contient deux onglets: Résumé et Journaux. L'onglet Summary (Résumé) répertorie des 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 intervalle de la trace.

Si vous sélectionnez la barre de latence pour d'autres lignes du tableau, c'est-à-dire une ligne pour une période, le tableau contient quatre onglets : Attributs, Journaux et événements, Traces de pile et Métadonnées et liens:

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

  

  Pour rechercher un libellé ou un groupe de libellés spécifiques, ajoutez un filtre. Par exemple, si vous ajoutez le filtre Clé: g.co, le tableau répertorie 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, le cas échéant, consultez l'onglet Journaux et événements. Pour en savoir plus sur les annotations d'événements, consultez la section Annoter des 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 Afficher plus:

  

• Pour obtenir des informations sur le nombre de traces de pile disponibles et des informations détaillées sur une trace de pile capturée, utilisez l'onglet Traces de pile.

• Pour obtenir des informations générales sur la période et un tableau de liens vers d'autres périodes, consultez l'onglet Métadonnées et liens. Ces informations incluent les éléments suivants:

  • ID du délai

    L'ID de span 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

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

    Chaque ligne du tableau nommé Links (Liens) liste un lien entre le délai actuel et un autre délai. Le champ Attributs liste les paires clé-valeur pour la portée associée. Le champ Trace renvoie vers la trace du segment associé. Lorsque ce champ contient Trace actuelle, la portée associée se trouve dans la même trace que la portée actuelle. Sinon, le champ contient un ID de trace. Pour en savoir plus sur les associations, consultez la page de référence de l'API Links.

  La capture d'écran suivante illustre cet onglet:

  

Étape suivante

• Ajouter des annotations d'événements aux plages de suivi
• Afficher les traces de plusieurs projets
• Créer et afficher des rapports