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