Grafana : provisionner des dashboards par fichier

Le provisioning charge des dashboards depuis le disque au démarrage, sans intervention dans l’interface.

Prérequis

• Accès au système de fichiers du serveur Grafana.
• Un ou plusieurs dashboards exportés en JSON.

1. Déclarer le provider

Créer /etc/grafana/provisioning/dashboards/default.yml :

apiVersion: 1
providers:
  - name: "fichiers"
    orgId: 1
    folder: "Infrastructure"
    type: file
    disableDeletion: false
    updateIntervalSeconds: 30
    allowUiUpdates: false
    options:
      path: /var/lib/grafana/dashboards
      foldersFromFilesStructure: true

2. Déposer les fichiers JSON

mkdir -p /var/lib/grafana/dashboards
cp dashboard.json /var/lib/grafana/dashboards/
chown -R grafana:grafana /var/lib/grafana/dashboards

Le champ id du JSON doit être null pour éviter les conflits :

{ "id": null, "uid": "node-overview", "title": "Vue noeuds" }

3. Recharger

systemctl restart grafana-server

Vérification

journalctl -u grafana-server | grep -i provisioning

Le dossier Infrastructure contient les dashboards et ils apparaissent en lecture seule.

Dépannage

• Dashboard absent : vérifier les droits du fichier et la présence de uid unique.
• Erreur version mismatch : retirer le champ version du JSON.
• Modification écrasée : allowUiUpdates: false rend les fichiers prioritaires ; passer à true pour autoriser l’édition.