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 délai. Les données affichées pour chaque trace et segment affichés incluent des informations récapitulatives, telles que la latence et le type de commande, ainsi que des informations détaillées. Ces 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 dont vous avez besoin 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:

  1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Trace, puis Explorateur Trace:

    Accéder à Explorateur Trace

    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:

    Volet de traces récentes dans Cloud Trace.

    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 la requête.

    • Les informations d'erreur sont encodées selon 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.

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

      Afficher une info-bulle de trace présentant des informations de latence.

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

    • Filtrer 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 et faites glisser le pointeur 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 correspondent à 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.

      Les options de filtrage suivantes sont toujours disponibles:

      • 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 à celle 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 du filtre peut contenir des codes d'état spécifiques, tels que 301, ou des plages de valeurs d'état, telles que 3xx.
      • MinLatency (Latence minimale) : 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ù le libellé spécifié par la valeur du filtre apparaît dans au moins un délai.
      • 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 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 qui contiennent au moins un délai dont la version de l'application correspond à la valeur du filtre.

      D'autres options de filtrage peuvent s'afficher, comme URL ou les étiquettes HTTP. Si un libellé défini par l'utilisateur correspond à un filtre prédéfini, le libellé défini par l'utilisateur porte le préfixe LABEL, ce qui permet de distinguer les deux. Par exemple, si vous créez un libellé Service, vous verrez à la fois Service et LABEL:Service dans le menu de filtre.

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:

  1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Trace, puis Explorateur Trace:

    Accéder à Explorateur Trace

  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 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.

  3. 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 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 graphique en nuage de points. Lorsque vous cliquez sur un point du 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 à l'aide d'un cercle dessiné autour de celui-ci. Les points représentant toutes les autres traces sont grisés.
  • Le volet Trace details (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 segments.

    • Un 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é 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 sous forme de ligne dans le tableau, développez Journaux et événements , puis sélectionnez Afficher les données développées.

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

      Le tableau liste le nom des segments et le service qui leur 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 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énements. Une barre de latence bleue indique une achèvement réussie et 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.

Voici un exemple de volet Détails des traces:

Exemples du volet "Détails" de Cloud Trace.

Afficher les détails du délai

Pour afficher des informations détaillées sur la trace ou sur un délai 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 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 portant le nom ID de trace, le tableau contient deux onglets: Résumé 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 du tableau, c'est-à-dire une ligne pour un segment, le tableau contient quatre onglets : Attributs, Journaux et événements, Traces de pile et Métadonnées et liens:

  • Pour trouver les étiquettes associées à un segment, consultez l'onglet Attributs. Pour plus d'informations sur les étiquettes, consultez la section Étiquettes de trace. La capture d'écran suivante illustre cet onglet:

    Exemple de tableau d'attributs Cloud Trace

    Pour localiser un libellé ou un groupe de libellés spécifique, ajoutez un filtre. Par exemple, si vous ajoutez le filtre Key: g.co, le tableau liste tous les libellés dont la clé de libellé contient g.co.

  • Pour afficher des informations sur les entrées et les événements de journal associés, lorsqu'ils existent, consultez 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:

    Exemple de l'onglet Cloud Tracelogs et événements

    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:

    Exemple de journal développé

  • 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, accédez à l'onglet Traces de pile.

  • Pour obtenir des informations générales sur le segment et une table de liens vers d'autres segments, consultez l'onglet Métadonnées et liens. Voici quelques exemples:

    • ID du délai

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

    • Table répertoriant les liens vers d'autres objets Span

      Chaque ligne de la table nommée Links (Liens) indique un lien entre le segment actuel et un autre segment. Le champ Attributs répertorie les paires clé/valeur du segment associé. Le champ Trace est associé à la trace du délai lié au délai. Lorsque ce champ contient Current trace (Trace actuelle), le délai lié à 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 la documentation de référence de l'API Links.

    La capture d'écran suivante illustre cet onglet:

    Exemple de liste de métadonnées et de tableau des liens Cloud Trace

Étapes suivantes