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

Rechercher et explorer des traces

Pour rechercher et explorer les 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 délai. Les données affichées pour chaque trace et chaque segment affichés incluent des informations récapitulatives, telles que la latence, le type de commande et 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 attribuer 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 section Gérer les accès.

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 page 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 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 cette requête.
- Les informations d'erreur sont encodées à la couleur d'un point. Le bleu indique une réussite et le rouge un échec. Dans la capture d'écran précédente, la plupart des commandes ont abouti.
- Info-bulle qui s'active lorsque vous maintenez le pointeur sur un point et affiche la date, l'heure, l'URI et la latence:
(Facultatif) Pour filtrer les traces et les délais affichés, effectuez l'une des opérations suivantes :
- Filtrez par heure. 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 plus longue que votre intervalle de temps personnalisé.
  2. Placez votre pointeur sur le tracé Select a trace (Sélectionner une trace) à une extrémité de l'intervalle de temps, puis faites-le glisser 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.
- 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 comprise dans un intervalle, placez votre pointeur à une extrémité de la valeur de latence 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.
- 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 qui répondent à 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 deux secondes, ajoutez les filtres Method: GET et MinLatency: 2000.
  
  L'option de filtre 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, 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 la valeur correspond à 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ù l'étiquette spécifiée par la valeur du filtre apparaît dans au moins un délai.
  - Service: affiche les traces contenant au moins un délai dont le nom de service correspond à la valeur du filtre.
    
    Le nom de 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 contenant au moins un délai dont la version de l'application correspond à la valeur du filtre.
  D'autres options de filtrage peuvent s'afficher, telles que l'URL ou les étiquettes HTTP. Si une étiquette définie par l'utilisateur correspond à un filtre prédéfini, elle porte le préfixe LABEL pour que vous puissiez la distinguer. Par exemple, si vous créez un libellé Service, Service et LABEL:Service s'affichent dans le menu de filtre.
  
  Remarque :Pour effectuer une correspondance exacte, ajoutez un signe plus (+) avant la valeur du filtre. Si vous omettez le signe plus, une correspondance est déterminée en effectuant un test de préfixe avec la valeur de filtre. Pour en savoir plus sur les options de filtrage, consultez la section Filtres de traces.

Rechercher une trace par ID

Lorsque vous dépannez un incident ou une défaillance, vous connaissez peut-ê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, vous pouvez configurer le traçage multiprojet, ce qui 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 des traces contient des informations sur la trace et ses segments. Vous pouvez utiliser les options de ce volet 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 nuage de points, les modifications suivantes se produisent sur la page Explorateur de traces:

Le graphique à nuage de points est actualisé, et le point que vous avez sélectionné est mis en évidence par un cercle tracé autour de celui-ci. Les points qui représentent toutes les autres traces sont grisés.
Le volet Détails des traces affiche les éléments suivants:
- Identifiant de trace. Cet identifiant unique global pour 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.
- Une ligne récapitulative qui indique l'heure de début, la durée et le nombre de délais.
- Un menu Journaux et événements La sélection dans le 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 du tableau, 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 pour chaque segment de la trace.
  
  Pour les segments, le tableau répertorie le nom du délai et le service qui lui 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 exécution réussie, une barre de latence rouge indique une erreur. 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 Détails des traces:

Exemples du volet Détails de Cloud Trace.

Rechercher des segments dans une trace

Vous pouvez rechercher des mots clés dans les segments 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, à savoir net.sock.peer.port.

Pour rechercher les segments d'une trace, saisissez le terme de recherche dans le champ Find in Trace (Rechercher dans la trace) dans la barre d'outils du volet Détails des traces, puis appuyez sur Entrée.

Trace recherche ensuite des champs sélectionnés de chaque délai dans la trace affichée. Une correspondance est établie lorsqu'un champ recherché contient le terme de recherche, en ignorant 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 segment avec un attribut dont la clé est /http/method et la valeur GET est mis en surbrillance. De plus, les objets Span avec des noms tels que CurrencyService/GetSupportedCurrencies sont mis en surbrillance.

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

Afficher les détails du délai

Pour afficher des informations détaillées sur la trace ou sur un délai spécifique, cliquez sur la barre de latence de l'entrée dans le volet Détails des traces. 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 pour la première ligne de la table, la ligne portant le nom ID de trace, la table contient deux onglets: Récapitulatif et Journaux. L'onglet Summary (Résumé) fournit 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 délai de la trace.

Si vous sélectionnez la barre de latence pour d'autres lignes de la table (c'est-à-dire une ligne pour un segment), la table 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 en savoir plus 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 répertorie tous les libellés dont la clé d'étiquette contient g.co.
Pour afficher des informations sur les entrées de journal et les événements associés, le cas échéant, accédez à l'onglet Journaux et événements. Pour en savoir plus sur les annotations d'événements, 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, cliquez sur Show more (Afficher plus) pour afficher les détails d'une entrée de journal:
Pour connaître le nombre de traces de pile disponibles et obtenir des informations détaillées sur une trace de pile capturée, accédez à l'onglet Traces de la pile.
Pour obtenir des informations générales sur le segment et un tableau des liens vers d'autres segments, consultez l'onglet Métadonnées et liens. Voici quelques exemples:
- ID du délai
  
  L'ID de délai 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 de la table nommée Links (Liens) contient un lien entre le segment actuel et un autre délai. Le champ Attributs répertorie les paires clé/valeur du délai associé. Le champ Trace renvoie à la trace du délai associé. Lorsque ce champ contient Trace actuelle, le délai associé 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: