Annoter des visualisations

Les annotations permettent de marquer des points sur le graphique à l'aide d'événements riches. Lorsque vous survolez une annotation, vous pouvez obtenir la description de l'événement et les balises de l'événement. Le champ de texte peut inclure des liens vers d'autres systèmes plus détaillés.

Annotations natives

Grafana est doté d'un magasin d'annotations natif et de la possibilité d'ajouter des événements d'annotation directement depuis le panneau graphique ou via l'API HTTP.

Ajouter une annotation

Sinon, pour ajouter une annotation, Ctrl+Click ou dans Cmd+Click le panneau Série chronologique, la fenêtre contextuelle Ajouter une annotation apparaîtra.

Ajouter une annotation de région

Modification d'une annotation

Supprimer une annotation

Requête intégrée

Une fois que vous avez ajouté une annotation, elle sera toujours visible. Cela est dû à la requête d'annotation intégrée qui existe sur tous les tableaux de bord. Cette requête d'annotation récupérera tous les événements d'annotation provenant du tableau de bord actuel et les affichera sur le panneau dans lequel ils ont été créés. Cela inclut les annotations de l'historique de l'état des alertes. Vous pouvez empêcher l'extraction et le dessin des annotations en ouvrant les paramètres des annotations (via le menu des rouages du tableau de bord) et en modifiant le nom de la requête. Annotations & Alerts (Built-in)

Lorsque vous copiez un tableau de bord à l'aide de la fonctionnalité Enregistrer sous, il reçoit un nouvel identifiant de tableau de bord, de sorte que les annotations créées sur le tableau de bord source ne seront plus visibles sur la copie. Vous pouvez toujours les afficher si vous ajoutez une nouvelle requête d'annotation et que vous filtrez par balises. Cela ne fonctionne que si les annotations du tableau de bord source contenaient des balises à filtrer.

Interrogation par tag

Vous pouvez créer de nouvelles requêtes pour récupérer des annotations depuis le magasin d'annotations natif via la source de -- Grafana -- données en définissant Filter by sur. Tags

Grafana v8.1 et les versions ultérieures prennent également en charge la saisie anticipée des balises existantes, en fournissant au moins une balise.

Par exemple, créez un nom de requête d'annotation outages et spécifiez une baliseoutage. Cette requête affichera toutes les annotations (depuis n'importe quel tableau de bord ou via une API) avec la balise de panne. Si plusieurs balises sont définies dans une requête d'annotation, Grafana n'affichera que les annotations correspondant à toutes les balises. Pour modifier le comportementMatch any, activez et Grafana affichera les annotations contenant l'une des balises que vous avez fournies.

Dans Grafana v5.3+, il est possible d'utiliser des variables de modèle dans la requête de balise. Ainsi, si vous disposez d'un tableau de bord affichant les statistiques de différents services et d'une variable de modèle qui indique les services à afficher, vous pouvez désormais utiliser la même variable de modèle dans votre requête d'annotation pour n'afficher que les annotations relatives à ces services.

Interrogation d'autres sources de données

Les événements d'annotation sont récupérés par le biais de requêtes d'annotation. Pour ajouter une nouvelle requête d'annotation à un tableau de bord, ouvrez le menu des paramètres du tableau de bord, puis sélectionnez Annotations. Cela ouvrira la vue des paramètres des annotations du tableau de bord. Pour créer une nouvelle requête d'annotation, cliquez sur le bouton Nouveau.

Spécifiez le nom de la requête d'annotation. Ce nom est donné à la bascule (case à cocher) qui vous permettra d'activer ou de désactiver l'affichage des événements d'annotation issus de cette requête. Par exemple, vous pouvez avoir deux requêtes d'annotation nommées Deploys etOutages. Le bouton vous permettra de choisir les annotations à afficher.

Détails de la requête d'annotation

Les options de requête d'annotation sont différentes pour chaque source de données. Pour plus d'informations sur les annotations dans une source de données spécifique, consultez la rubrique relative à la source de données spécifique.