For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/databases/grafana-tuto-using-api.md.

Dashboards - Tutoriel - Comment utiliser l'API Grafana®

Voir en Markdown

Découvrez comment utiliser l'API Grafana®

Objectif

L'utilisation de l'API Grafana® n'est pas évidente et n'est pas encore clairement documentée. Ce tutoriel explique comment configurer Grafana® pour utiliser l'API et comment effectuer des appels vers l'API exposée.

Prérequis

  • Un projet Public Cloud dans votre compte OVHcloud
  • Un service Dashboards exécuté sur votre projet Public Cloud OVHcloud (consultez ce guide pour créer un service Dashboards managé)

En pratique

Créer un compte de service Grafana®

Dans le menu de configuration, affichez l'onglet Service accounts :

Onglet des comptes de service Grafana

Créez un nouveau compte de service sa-editor avec le rôle Editor :

Création d'un compte de service Grafana

Cliquez sur Add service account token :

Bouton de token de compte de service Grafana

Saisissez le nom du token souhaité, grafana-sa-token-editor, puis cliquez sur Generate token :

Génération d'un token de compte de service Grafana

Copiez le token généré :

Token de compte de service Grafana généré
Warning

Après avoir fermé la pop-up, vous ne pourrez plus afficher le token !

Le token créé apparaît dans la liste des tokens :

Liste des tokens de comptes de service Grafana

Vous êtes prêt à utiliser ce token avec l'API Grafana®.

Utiliser l'API Grafana®

Info

Des instructions détaillées sur l'utilisation de l'API et les actions possibles sont disponibles dans la documentation officielle : https://grafana.com/docs/grafana/latest/developers/http_api/

Warning

N'oubliez pas de définir les Authorised IP addresses dans la configuration de Dashboards. Consultez notre guide Configurer votre instance Grafana pour accepter les connexions entrantes pour plus de détails.

Pour envoyer une requête à l'API, vous devez utiliser le token créé précédemment et le renseigner dans l'en-tête de la requête en tant que « Bearer token » :

export GRAFANA_API_TOKEN=042footoken420

curl -H "Authorization: Bearer $GRAFANA_API_TOKEN" https://grafana-xxxxxxxxx-yyyyyyyyy.database.cloud.ovh.net/api/folders    
[
    {
        "id":11,
        "uid":"HnDCAp-4k",
        "title":"foo 1"
    },
    {
        "id":5,
        "uid":"cb_S6Pb4k",
        "title":"foo 2"
    },
    {
        "id":9,
        "uid":"Xav55taVk",
        "title":"foo 3"
    },
    {
        "id":10,
        "uid":"AH8sApaVz",
        "title":"foo 4"
    }
]

Et voilà, vous pouvez désormais exploiter toute la puissance de l'API Grafana®.

Nous voulons vos retours !

Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Vous êtes sur Discord ? Rejoignez notre chaîne via https://discord.gg/ovhcloud et interagissez directement avec l’équipe qui développe notre service de bases de données !

Cette page vous a-t-elle aidé ?