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.
# Suivis
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 12.x de Grafana, voir. [Travailler dans la version 12 de Grafana](using-grafana-v12.md)
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Les visualisations de traces vous permettent de suivre une demande lorsqu'elle traverse les services de votre infrastructure. La visualisation des traces affiche les données des traces dans un diagramme qui vous permet de les interpréter facilement.
Pour plus d'informations sur les traces et leur utilisation, consultez la documentation suivante :
+ [Traçage dans Explore](v10-explore-tracing.md)
+ [Source de données Tempo](tempo-data-source.md)
+ [Commencer à utiliser Tempo](https://grafana.com/docs/tempo/latest/getting-started/) dans la documentation *Tempo de Grafana Labs*.
## Ajout d'un panneau avec des visualisations de traçage
Une fois que les données de suivi sont disponibles dans votre stack Grafana, vous pouvez ajouter des panneaux de suivi à vos tableaux de bord Grafana.
L'utilisation d'une variable de tableau de bord vous permet de créer une requête pour afficher des traces spécifiques pour un ID de trace donné. `traceID` Pour plus d'informations sur les variables de tableau de bord, consultez la [documentation sur les variables](v10-dash-variables.md).
**Conditions préalables**
Avant de commencer, vous avez besoin des éléments suivants :
+ Un espace de travail Grafana géré par Amazon.
+ Une [source de données Tempo](tempo-data-source.md) connectée à votre espace de travail.
Pour afficher et analyser les données de traces dans un tableau de bord, vous devez ajouter la visualisation des traces à votre tableau de bord et définir une requête à l'aide de l'éditeur de panneaux. La requête détermine les données affichées dans la visualisation. Pour plus d'informations sur l'éditeur de panneaux, reportez-vous à la [documentation de l'éditeur de panneaux](v10-panels-editor-overview.md).
Cette procédure utilise des variables et des modèles de tableau de bord pour vous permettre de saisir des identifiants de trace qui peuvent ensuite être visualisés. Vous allez utiliser une variable appelée `traceId` et l'ajouter en tant que modèle de requête.
**Pour ajouter une requête de visualisation des traces**
1. Dans votre espace de travail, créez un nouveau tableau de bord ou accédez à un tableau de bord existant dans lequel vous souhaitez ajouter des visualisations de traces.
1. Choisissez **Ajouter une visualisation** à partir d'un nouveau tableau de bord ou choisissez **Ajouter un panneau** sur un tableau de bord existant.
1. Sélectionnez la source de données de suivi appropriée.
1. **Dans le coin supérieur droit de l'éditeur de panneaux, choisissez l'onglet **Visualisations**, puis sélectionnez Traces.**
1. Dans les **options du panneau**, entrez un **titre** pour votre panneau de suivi. Pour plus d'informations sur l'éditeur de panneaux, voir[Configurer les options du panneau](v10-panels-configure-panel-options.md).
1. Dans l'éditeur de requêtes, sélectionnez l'onglet Type de requête **TraceQL**.
1. Entrez `${traceId}` dans le champ de requête TraceQL pour créer une variable de tableau de bord. Cette variable est utilisée comme modèle de requête.
1. Choisissez **Appliquer** dans l'éditeur de panneau pour ajouter le panneau au tableau de bord.
1. Accédez aux **paramètres** du tableau de bord et ajoutez une nouvelle variable appelée`traceId`, de type variable **Custom**, en lui donnant une étiquette, si nécessaire. Choisissez **Appliquer** pour ajouter la variable au tableau de bord.
1. Vérifiez que le panneau fonctionne en utilisant un ID de trace valide pour la source de données utilisée pour le panneau de suivi et en modifiant l'ID dans la variable du tableau de bord.
## Ajout de TraceQL avec des visualisations de tables
Bien que vous puissiez ajouter une visualisation de trace à un tableau de bord, il est fastidieux d'ajouter manuellement des identifiants de trace en tant que variable de tableau de bord. Il est plus utile de pouvoir utiliser des requêtes TraceQL pour rechercher des types de traces spécifiques, puis de sélectionner les traces appropriées parmi les résultats correspondants.
**Conditions préalables**
Cette procédure suppose que vous avez terminé la procédure précédente.
**Pour ajouter TraceQL avec des visualisations de tables**
1. Dans le tableau de bord où vous avez ajouté la visualisation de trace, choisissez **Ajouter un panneau** pour ajouter un nouveau panneau de visualisation.
1. Sélectionnez la même source de données de trace que celle que vous avez utilisée dans la section précédente.
1. **Dans le coin supérieur droit de l'éditeur de panneaux, sélectionnez l'onglet **Visualisations**, puis choisissez Table.**
1. Dans l'éditeur de requêtes, choisissez l'onglet **TraceQL**.
1. Dans les **options du panneau**, entrez un **titre** pour votre panneau de suivi.
1. Ajoutez une requête TraceQL appropriée pour rechercher les traces que vous souhaitez visualiser dans le tableau de bord. Par exemple, voici une requête statique simple provenant d'un serveur appelé{{my-server}}.
```
{ .service.name = "{{my-server}}" && .http.status_code=500 }
```
Vous pouvez écrire la requête TraceQL sous forme de requête modèle pour tirer parti des autres variables du tableau de bord, si elles existent. Cela vous permet de créer des requêtes dynamiques basées sur ces variables.
Lorsque des résultats sont renvoyés par une requête, ils sont affichés dans le tableau du panneau.
Les résultats de la visualisation des traces incluent des liens vers la page **Explore** qui affiche la trace. Vous pouvez ajouter d'autres liens vers des traces dans le tableau qui renseignent la variable du `traceId` tableau de bord lorsqu'elle est sélectionnée, afin que la trace soit visualisée dans le même tableau de bord.
Pour créer un ensemble de liens de données dans le panneau, procédez comme suit.
**Pour utiliser une variable pour ajouter d'autres liens aux traces**
1. Dans le menu de droite, sous Liaisons de **données**, choisissez **Ajouter un lien**.
1. Ajoutez un **titre** pour le lien de données.
1. Trouvez le chemin d'accès au tableau de bord en consultant la barre d'adresse de votre navigateur lorsque le tableau de bord complet est affiché. Comme il s'agit d'un lien vers un tableau de bord de la même pile Grafana, seul le chemin du tableau de bord est requis.
Par exemple, si votre chemin est :
```
https://g-example.grafana-workspace.us-east-1.amazonaws.com{{/d/1234abcd5/my-dashboard?orgId=1}}
```
Le chemin d'accès au tableau de bord est alors le suivant :
```
/d/1234abcd5/my-dashboard?orgId=1
```
1. Dans le champ **URL**, faites référence au tableau de bord qui contient les deux panneaux. Cette autoréférence utilise la valeur de la trace sélectionnée dans le tableau pour renseigner la variable du tableau de bord. Utilisez le chemin du tableau de bord indiqué à l'étape précédente, puis saisissez la valeur d'`traceId`utilisation des résultats sélectionnés dans la table TraceQL. L'ID de trace est exposé à l'aide du champ de `traceID` données dans les résultats renvoyés. Utilisez-le donc comme valeur pour la variable du tableau de bord. Par exemple :
```
/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
```
1. Choisissez **Enregistrer** pour enregistrer le lien de données.
1. Choisissez **Appliquer** dans l'éditeur de panneaux pour appliquer le panneau au tableau de bord.
1. Enregistrez le tableau de bord.
Vous devriez maintenant voir une liste des traces correspondantes dans la visualisation du tableau. Lorsque vous sélectionnez les champs **TraceID** ou **SpanID**, vous pouvez soit ouvrir la page **Explore** pour visualiser la trace, soit suivre le lien de données, sélectionner un autre champ (tel que`Start time`, ou`Duration`) suit automatiquement le lien de données`Name`, en remplissant la variable du tableau de `traceId` bord, puis en affichant la trace correspondante dans le panneau de suivi.