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 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 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 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 Contrôlez 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.
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 à nuage de points affiche un point pour chaque requête dans le intervalle de temps:
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 encodées à la couleur d'un point. Le bleu indique une réussite et le rouge un échec. Lors de 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 segments affichés, effectuer 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 :
- Sélectionnez une option prédéfinie plus longue que votre valeur personnalisée l'intervalle de temps.
- 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é de la 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 dans l'intervalle de temps sélectionné s'affichent. 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 filter_list 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 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 Méthode: 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 paramètre
Étiquette
/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 paramètre
Le libellé
/http/status_code
, où le libellé de la valeur correspond la valeur du filtre. La valeur du filtre peut contenir des codes d'état spécifiques, comme301
, ou des plages de valeurs d'état, comme3xx
. - MinLatency: affiche les traces dont la latence est au moins égale à comme valeur du filtre. La valeur du filtre doit être exprimée en millisecondes.
- HasLabel: affiche les traces où le libellé spécifié par le filtre s'affiche. 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 de service d'un segment est extrait d'OpenTelemetry l'attribut
service.name
, lorsque cet attribut est défini. Si cet attribut n'est pas défini et si le service est exécuté sur App Engine, le nom du service App Engine est affiché. 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, telles que l'URL ou les étiquettes HTTP. Si une étiquette définie par l'utilisateur correspond à un filtre prédéfini, une étiquette définie par l'utilisateur est précédée de LABEL, ce qui vous permet de distinguer entre les deux. Par exemple, si vous créez un libellé
Service
, Service et LABEL:Service dans le menu des filtres.
Rechercher une trace par ID
Lorsque vous dépannez un incident ou une défaillance, vous connaissez peut-être ID de trace. Pour explorer cette trace, procédez comme suit:
-
Dans la console Google Cloud, accédez à la page 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 des traces contient les informations suivantes : des informations sur la trace et ses segments. 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 diagramme de dispersion, les changements suivants se produisent pour la page Explorateur de traces:
- Le graphique à nuage de points est actualisé et le point que vous avez sélectionné est mis en évidence. avec un cercle tracé autour du point. 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,
voir
Resource: Trace
. Une ligne récapitulative indiquant l'heure de début, la durée et le nombre segments.
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é à le délai de trace. Les cercles qui se chevauchent indiquent que le segment n'a plusieurs journaux ou événements. Pour afficher chaque journal ou événement sous forme de ligne dans la tableau, développer arrow_drop_down 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 du L'attribut OpenTelemetry
service.name
, lorsque cet attribut est défini Si cet attribut n'est pas défini et si le service est exécuté sur App Engine, le nom du service App Engine est affiché. Sinon, le service n'est pas spécifié.La colonne Latence fournit une représentation visuelle de la latence. l'état et, le cas échéant, les annotations d'événement. Une barre de latence bleue indique si l'opération réussit, 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.
- 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,
voir
Voici un exemple de volet Détails des traces:
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, net.sock.peer.port.
Pour rechercher les segments d'une trace, accédez à la barre d'outils du volet Détails des traces : saisissez le terme de recherche dans le champ Rechercher dans Trace, puis appuyez sur Entrée.
Trace recherche ensuite des champs sélectionnés de chaque segment dans 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
, alors un segment avec un attribut dont
La clé est /http/method
et dont la valeur est GET
est mise en surbrillance. De plus, les segments
avec des noms tels que CurrencyService/GetSupportedCurrencies
sont mis en surbrillance.
Vous ne pouvez pas rechercher à l'aide d'une expression régulière ni dans les 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 pour la première ligne du tableau, la ligne par le nom ID de trace, la table contient deux onglets: Récapitulatif et Journaux. La page Summary (Résumé) affiche 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 des informations sur la latence pour chaque segment 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 localiser un libellé spécifique ou un groupe de libellés, ajoutez un filtre. Par exemple, si vous ajoutez le filtre Clé: 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 é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 keyboard_arrow_down Afficher plus:
Pour connaître le nombre de traces de piles disponibles, 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 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 du tableau nommé Links (Liens) contient un lien entre l'intervalle actuel et un autre segment. Le champ Attributs répertorie les paires clé-valeur pour du segment associé. 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 liens, consultez les
Links
.
La capture d'écran suivante illustre cet onglet:
Étape suivante
- Ajouter des annotations d'événements aux délais de trace
- Afficher les traces de plusieurs projets
- Créer et afficher des rapports