Traçage dans Explore - Amazon Managed Grafana

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Traçage dans Explore

Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.

Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. Travailler dans la version 9 de Grafana

Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Travailler dans la version 8 de Grafana

Vous pouvez utiliser Explore pour visualiser des traces à partir de sources de données de suivi.

Les sources de données suivantes sont prises en charge :

Pour plus d'informations sur la configuration des requêtes pour les sources de données répertoriées ci-dessus, reportez-vous à la documentation de la source de données spécifique.

Éditeur de requête

Vous pouvez interroger et rechercher des données de suivi à l'aide de l'éditeur de requêtes d'une source de données.

Chaque source de données peut avoir son propre éditeur de requêtes. L'éditeur de requêtes pour la source de données Tempo est légèrement différent de l'éditeur de requêtes pour la source de données Jaeger.

Pour plus d'informations sur l'interrogation de chaque source de données, reportez-vous à leur documentation.

Explication de Trace View

Cette section explique les éléments du tableau de bord Trace View.

En-tête

L'en-tête de la vue de trace comporte les éléments suivants :

  • Titre de l'en-tête — Affiche le nom de l'intervalle racine et l'ID de trace.

  • Rechercher : met en évidence les plages contenant le texte recherché.

  • Métadonnées : diverses métadonnées relatives à la trace.

Mini-carte

Affiche la vue condensée ou la chronologie du tracé. Faites glisser votre pointeur sur la mini-carte pour zoomer sur une plage de temps plus courte. Le zoom permet également de mettre à jour la chronologie principale, de sorte qu'il est facile de voir des plages plus courtes. Lorsque vous passez le curseur sur la minicarte, une fois zoomée, le bouton Réinitialiser la sélection permet de réinitialiser le zoom.

Filtres Span

À l'aide de filtres d'intervalle, vous pouvez filtrer vos intervalles dans l'afficheur de chronologie des traces. Plus vous ajoutez de filtres, plus les plages filtrées sont spécifiques.

Vous pouvez ajouter un ou plusieurs des filtres suivants :

  • Nom du service de ressources

  • Nom de l'Espagne

  • Durée

  • Balises (qui incluent les balises, les balises de processus et les champs de journal)

Pour afficher uniquement les intervalles auxquels vous avez fait correspondre, sélectionnez le bouton Afficher les correspondances uniquement.

Chronologie

Affiche la liste des intervalles contenus dans le tracé. Chaque ligne de span comprend les composants suivants :

  • Bouton Élargir les enfants : permet d'étendre ou de réduire toutes les tranches d'enfants de la période sélectionnée.

  • Nom du service : nom du service qui a enregistré l'intervalle.

  • Nom de l'opération : nom de l'opération représentée par cette plage.

  • Barre de durée de l'intervalle : représentation visuelle de la durée de l'opération dans le tracé.

Détails de l'envergure

Le choix de la ligne d'intervalle affiche les détails de l'intervalle, notamment les suivants.

  • Nom de l'opération

  • Métadonnées Span

  • Tags : tous les tags associés à cette plage.

  • Métadonnées du processus : métadonnées relatives au processus qui a enregistré cette période.

  • Journaux : liste des journaux enregistrés par cette plage et des valeurs clés associées. Dans le cas des journaux Zipkin, la section affiche les annotations Zipkin.

Trace vers les journaux

Vous pouvez accéder directement à une plage dans une vue de trace aux journaux correspondant à cette période. Ceci est disponible pour les sources de données Tempo, Jaeger et Zipkin. Reportez-vous à leur documentation pertinente pour obtenir des instructions sur la façon de configurer chaque source de données.

Cliquez sur l'icône du document pour ouvrir une vue fractionnée dans Explore avec la source de données configurée et recherchez les journaux pertinents pour la période.

Suivi des métriques

Note

Cette fonctionnalité est actuellement en version bêta

Vous pouvez passer d'une plage dans une vue de trace directement aux métriques pertinentes pour cette période. Cette fonctionnalité est disponible pour les sources de données Tempo, Jaeger et Zipkin. Reportez-vous à leur documentation appropriée pour plus de détails sur la configuration.

Trace jusqu'aux profils

En utilisant Trace to profiles, vous pouvez utiliser la capacité de Grafana à corréler différents signaux en ajoutant la fonctionnalité permettant de lier les traces aux profils.

Graphe de nœuds

Vous pouvez éventuellement développer le graphe de nœuds pour le tracé affiché. En fonction de la source de données, cela peut afficher les étendues de la trace sous forme de nœuds dans le graphe ou ajouter du contexte supplémentaire, notamment le graphe de service basé sur la trace actuelle.

Affichage du graphique des services

La vue Service Graph permet de visualiser les métriques de durée (trace les données relatives aux taux, aux taux d'erreur et aux durées (RED)) et les graphiques de service. Une fois les exigences définies, cette vue préconfigurée est immédiatement disponible.

Pour plus d'informations, consultez la page des sources de données Tempo. Vous pouvez également consulter la page d'affichage du graphique de service dans la documentation Tempo de Grafana Labs.

API de données

Cette visualisation nécessite une forme spécifique des données à renvoyer depuis la source de données afin de les afficher correctement.

La source de données doit renvoyer une trame de données et un ensembleframe.meta.preferredVisualisationType = 'trace'.

Structure du bloc de données

Les champs obligatoires ;

Nom de champ Type Description
ID de trace chaîne Identifiant de l'ensemble de la trace. Il ne doit y avoir qu'une seule trace dans le bloc de données.
ID d'Espagne chaîne Identifiant de la plage en cours. Les SpanID doivent être uniques par trace.
Panid des parents chaîne SpanID de l'espace parent pour créer une relation enfant-parent dans la vue de trace. Peut être undefined pour Root Span sans parent.
serviceName chaîne Nom du service dont fait partie cette période.
Étiquettes de service TraceKeyValuePair[] Liste des balises pertinentes pour le service.
startTime nombre Heure de début de la période en millisecondes.
duration nombre Durée de l'intervalle en millisecondes.

Champs facultatifs :

Nom de champ Type Description
journaux TraceLog[] Liste des journaux associés à la période en cours.
balises TraceKeyValuePair[] Liste des balises associées à l'intervalle actuel.
avertissements chaîne [] Liste des avertissements associés à la période en cours.
Stack Traces chaîne [] Liste des traces de pile associées à l'intervalle actuel.
errorIconColor chaîne Couleur de l'icône d'erreur au cas où span est marqué avecerror: true.

Pour plus de détails sur les types TraceSpanRow, voir, TraceKeyValuePairet ainsi de TraceLogsuite GitHub.