Outils pour développeurs
Grafana Cloud dans votre produit et vos agents IA, via une API
Le toolkit Grafana Cloud couvre les dashboards et les dossiers d'une stack : les lire, les créer à partir de JSON et les mettre à jour. Votre client se connecte une fois avec une API key, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke l'identifiant et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/grafana_create_dashboard/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"namespace": "<namespace>",
"metadata": {},
"spec": {}
}
}Fonctionnement
Du client connecté au premier appel à Grafana Cloud.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Grafana Cloud. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Grafana Cloud.
Provisionner les dashboards des clients
À l'intégration d'un client, créez un dossier et un dashboard à partir d'un modèle JSON dans sa stack, pour que la supervision soit prête dès le premier jour.
Garder les dashboards synchronisés
Lisez un dashboard, modifiez son spec et renvoyez-le avec le resourceVersion, pour que votre produit applique en sécurité des changements de panneaux ou de variables.
Découverte de dashboards par un agent
Laissez un agent IA lister dossiers et dashboards, lire les panneaux et la plage de temps d'un dashboard et décrire ce que la stack surveille déjà.
Tools
7 tools Grafana Cloud
- Lister les dashboardsGETListe les dashboards de la stack. Chaque élément contient metadata.name, l'uid que demandent les autres outils, l'uid du dossier dans l'annotation grafana.app/folder du metadata et tout le JSON du dashboard dans spec, avec son title. Gardez limit petit ; quand metadata.continue arrive, envoyez-le comme continue pour la page suivante.
- Obtenir un dashboardGETRenvoie un dashboard : metadata, avec l'uid dans name, le resourceVersion et l'annotation de dossier, et le JSON du dashboard dans spec, avec title, panels, variables et plage de temps.
- Créer un dashboardPOSTCrée un dashboard à partir de son JSON dans spec, à la racine ou dans un dossier. Envoyez metadata.name avec l'uid voulu, ou metadata.generateName avec un préfixe pour un uid aléatoire. Un uid déjà utilisé répond 409.
- Mettre à jour un dashboardPUTRemplace un dashboard par une nouvelle version de son JSON. Lisez-le d'abord avec Get dashboard, modifiez spec et renvoyez le spec entier, car les champs omis sont supprimés. Envoyez le resourceVersion lu pour ne pas écraser un changement plus récent ; un resourceVersion périmé répond 409.
- Lister les dossiersGETListe les dossiers de la stack que le jeton peut voir, chacun avec metadata.name, l'uid que demandent les champs de dossier des autres outils, le dossier parent dans l'annotation grafana.app/folder du metadata et le titre dans spec. Quand metadata.continue arrive, envoyez-le comme continue pour la page suivante.
- Créer un dossierPOSTCrée un dossier à la racine ou dans un autre dossier. Envoyez metadata.name avec l'uid voulu, ou metadata.generateName avec un préfixe pour un uid aléatoire.
- Mettre à jour un dossierPUTRenomme un dossier ou le déplace sous un autre. Envoyez le titre et, s'il y en a un, le parent dans l'annotation grafana.app/folder, car l'appel remplace le dossier.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {stack} : l'adresse de son compte sur l'API de l'app.
Questions sur le toolkit Grafana Cloud
Dois-je intégrer l'API Grafana Cloud moi-même ?
Non. Connect fournit 7 tools Grafana Cloud décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Grafana Cloud ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
