Cette page a été traduite par l'API Cloud Translation.

Rechercher et explorer des traces

Pour rechercher et explorer des traces individuelles en détail, utilisez le Explorateur de traces . Cette page affiche les traces pour lesquelles votre projet Google Cloud stocke au moins un segment. 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 et des traces, etc.

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 :

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 d'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 aux 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. Lors de capture d'écran, la plupart des commandes ont été exécutées avec succès.
- L'info-bulle qui s'active lorsque vous maintenez le pointeur sur un point affiche la date, l'heure, l'URI et la latence:
Facultatif : Pour filtrer les traces et les plages affichées, effectuez l'une des opérations suivantes :
- Filtrez par heure. Par défaut, l'heure de données la plus récente s'affiche. 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 votre pointeur sur le tracé Select a trace (Sélectionner une trace) à une extrémité du temps. un intervalle et faites glisser le pointeur horizontalement jusqu'à l'autre extrémité 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 est de dans un intervalle, placez votre pointeur à une extrémité de la valeur de latence, et faites glisser le pointeur verticalement jusqu'à 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 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, lorsqu'il 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 :

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.
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 dans laquelle vous pouvez configurer le traçage multiprojet, vous permet d'afficher les données de trace de n'importe quel projet de l'organisation. Pour en savoir plus, consultez Afficher les traces de plusieurs projets.
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 pour explorer la trace.

Explorer une trace

Pour explorer une trace, cliquez sur un point dans le 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 qui représentent tous les autres sont grisées.
Le volet Détails des traces affiche les éléments suivants:
- Identifiant de trace. Cet identifiant unique global pour la trace est 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 qui indique l'heure de début, la durée et le nombre de périodes.
- A Journaux et des événements. La sélection dans le menu contrôle la manière dont les journaux et les événements sont affichées. 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 le segment n'a plusieurs journaux ou événements. Pour afficher chaque journal ou événement sur une ligne dans la tableau, développer Journaux et les événements et sélectionnez Afficher la vue développée.
- Un tableau. La première ligne de la table correspond à la trace. Une ligne est ajoutée pour chaque segment de la trace.
  
  Le tableau répertorie le nom des segments et le service associé avec le segment. Le nom du service est extrait de l'attribut OpenTelemetry service.name, lorsqu'il 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 cet espace est représentée par un cercle la barre de latence.

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

Exemples du volet Détails de Cloud Trace.

Rechercher des plages 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, certains segments et une clé d'attribut sont mis 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.

Trace recherche ensuite des champs sélectionnés de chaque segment dans trace affichée. Une correspondance se produit lorsqu'un champ de recherche contient le terme de recherche, sans tenir compte de la casse. La recherche porte sur les champs suivants:

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

Une fois la recherche terminée, le volet Détails des traces 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 délai

Pour afficher des informations détaillées sur la trace ou sur un segment spécifique, Dans le volet Détails des traces, cliquez sur la barre de latence de l'entrée. Lorsque vous sélectionnez la barre de latence, le volet 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 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 un segment, le tableau contient quatre onglets: Attributs, Journaux et événements, traces de la pile, métadonnées et Liens:

Pour trouver les libellés associés à un segment, consultez l'onglet Attributs. Pour des informations sur les étiquettes, consultez la section Étiquettes 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 événements associés, le cas échéant, consultez la page Journaux et des é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 connaître le nombre de traces de piles disponibles et, des informations détaillées sur une trace de la pile capturée, utilisez l'outil Traces de la pile .
Pour obtenir des informations générales sur le segment et un tableau de liens vers d'autres segments, consultez la section Métadonnées et Liens. Ces informations incluent les suivantes:
- 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 listant 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 de la associé au segment. Lorsque ce champ contient Current trace (Trace actuelle), le qui se trouve dans la même trace que le segment actuel. 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 :