API Grafana : dashboards, alertes et annotations avec des agents IA
Grafana dispose d'une API HTTP pour gérer les dashboards, les dossiers, les sources de données, les alertes, les annotations et les utilisateurs. Les équipes d'ingénierie et d'exploitation s'en servent pour automatiser l'observabilité. L'accès se fait par un jeton de compte de service créé dans Grafana.
Ce que propose l’API Grafana
Dashboards et dossiers
Créer, mettre à jour, rechercher et versionner des dashboards.
Sources de données
Déclarer et consulter les connexions aux bases de données et aux services de métriques.
Alertes
Gérer les règles d'alerte, les points de contact et les mises en sourdine.
Annotations
Marquer des événements, comme les déploiements et les incidents, sur les graphiques.
Requêtes
Exécuter des requêtes sur les sources de données configurées.
Utilisateurs et équipes
Gérer les accès et les organisations.
Comment accéder à l’API Grafana
- Avec les identifiants de votre entrepriseJeton de compte de service créé dans Grafana, avec un rôle défini, envoyé dans l'en-tête d'autorisation.
- Utilisez le rôle lecteur dès que l'agent ne fait que lire.
- Mettre des alertes en sourdine peut masquer un incident : exigez une approbation.
- Des requêtes lourdes peuvent surcharger les sources de données.
Documentation officielle: grafana.com/docs/grafana/latest/developers/http_api
Ce qu’un agent iTeam fait avec l’API Grafana
Synthèse des alertes
Quand une alerte se déclenche, l'agent consulte les panneaux et envoie dans Slack un résumé de ce qui a changé.
Annotation des déploiements
À chaque déploiement, l'agent crée une annotation pour faciliter l'analyse d'impact.
Sourdine pendant la maintenance
L'agent met les alertes en sourdine pendant la fenêtre de maintenance approuvée.
Rapport hebdomadaire de SLO
L'agent consulte les métriques et envoie la synthèse de disponibilité et de latence.
De l’identifiant à l’agent au travail, avec validation
Compte de service
Créez dans Grafana un compte de service avec le rôle minimal, par exemple lecteur.
Coffre et actions autorisées
Conservez le jeton dans le coffre d'iTeam et n'autorisez l'écriture que là où c'est nécessaire, comme les annotations.
Test avec approbation
Les modifications d'alertes et de dashboards passent par une approbation humaine, avec audit.
Équipes IA prêtes à l’emploi pour ce travail
Analyse de données
Posez une question métier dans Slack ou Teams : l'équipe écrit la requête, vérifie le résultat et vous répond avec le chiffre et sa source.
Support informatique interne
Mot de passe, accès, matériel : la demande est posée dans Slack ou Teams, l'agent répond ou ouvre un ticket Jira complet.
Questions sur l’API Grafana
L'API de Grafana est-elle gratuite ?
Grafana open source ne facture pas l'API. Sur Grafana Cloud, l'usage suit l'offre souscrite.
Faut-il savoir programmer pour utiliser l'API Grafana avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation de l'API et apprend les endpoints, et l'équipe de déploiement configure avec vous les identifiants, les permissions et les tests.
L'API de Grafana fonctionne-t-elle avec Grafana Cloud ?
Oui. L'API HTTP existe aussi bien dans Grafana installé en propre que dans Grafana Cloud, avec un jeton de compte de service.
