Suivis - Amazon Managed Grafana
Ajout d'un panneau avec des visualisations de traçageAjout de TraceQL avec des visualisations de tables

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

Les visualisations de traces vous permettent de suivre une demande au fur et à mesure qu'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 :

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.

Prérequis

Avant de commencer, vous avez besoin des éléments suivants :

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.

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.

  2. Choisissez Ajouter une visualisation à partir d'un nouveau tableau de bord ou choisissez Ajouter un panneau sur un tableau de bord existant.

  3. Sélectionnez la source de données de suivi appropriée.

  4. Dans le coin supérieur droit de l'éditeur de panneaux, choisissez l'onglet Visualisations, puis sélectionnez Traces.

  5. Dans les options du panneau, entrez un titre pour votre panneau de suivi. Pour plus d'informations sur l'éditeur de panneaux, voirConfigurer les options du panneau.

  6. Dans l'éditeur de requêtes, sélectionnez l'onglet Type de requête TraceQL.

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

  8. Choisissez Appliquer dans l'éditeur de panneau pour ajouter le panneau au tableau de bord.

  9. Accédez aux paramètres du tableau de bord et ajoutez une nouvelle variable appeléetraceId, de type variable Custom, en lui donnant une étiquette, si nécessaire. Choisissez Appliquer pour ajouter la variable au tableau de bord.

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

Prérequis

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.

  2. Sélectionnez la même source de données de trace que celle que vous avez utilisée dans la section précédente.

  3. Dans le coin supérieur droit de l'éditeur de panneaux, sélectionnez l'onglet Visualisations, puis choisissez Table.

  4. Dans l'éditeur de requêtes, choisissez l'onglet TraceQL.

  5. Dans les options du panneau, entrez un titre pour votre panneau de suivi.

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

  2. Ajoutez un titre pour le lien de données.

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

  4. 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'traceIdutilisation 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"]}

  5. Choisissez Enregistrer pour enregistrer le lien de données.

  6. Choisissez Appliquer dans l'éditeur de panneaux pour appliquer le panneau au tableau de bord.

  7. 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 queStart time, ouDuration) suit automatiquement le lien de donnéesName, en remplissant la variable du tableau de traceId bord, puis en affichant la trace correspondante dans le panneau de suivi.