Comment Installer Et Utiliser Grafana Sur Raspberry Pi ?

Grafana est une solution logicielle intéressante qui vous permet de créer des tableaux de bord et des graphiques pour surveiller n’importe quoi à partir de n’importe quelle base de données. Avant Grafana, vous deviez être ou avoir un développeur pour transformer les données en quelque chose d’assez visuel pour les analyser. Vous pouvez désormais le faire facilement avec Grafana, et la bonne nouvelle est qu’il peut être installé sur un Raspberry Pi. Voyons comment cela fonctionne.

Grafana est un logiciel open-source qui peut être installé sur un Raspberry Pi en téléchargeant le paquet correspondant sur le site officiel. D’autres options sont disponibles, comme un conteneur Docker ou l’ajout d’un dépôt pour le gestionnaire de paquets (apt sur Debian).

Je vous montrerai la dernière option, car c’est le meilleur moyen de tout garder à jour. L’installation est plutôt simple, mais il y a quelques commandes à connaître. Ensuite, je vous donnerai une brève introduction pour commencer à utiliser vos premières sources de données et vos premiers tableaux de bord sur Grafana.

À propos, si vous débutez sur Raspberry Pi et que vous souhaitez accélérer les choses (tout en vous amusant), n’hésitez pas à télécharger mon e-book Maitrisez Raspberry Pi en 30 jours. Il s’agit d’un défi de 30 jours dans lequel vous apprendrez une nouvelle compétence chaque jour. Vous économiserez du temps et de l’argent et pourrez enfin profiter de votre Raspberry Pi à son plein potentiel. Je vous offre d’ailleurs 10% de remise aujourd’hui si vous utilisez ce lien !

Installer Grafana sur Raspberry Pi

Voici les étapes nécessaires pour installer Grafana sur votre Raspberry Pi :

• Installez Raspberry Pi OS et effectuez les mises à jour du système.
• Ajoutez le dépôt Grafana à votre système.
• Utilisez APT pour installer Grafana à partir du dépôt précédent.

Je vais maintenant expliquer chaque étape en détail.

Étape 1 – Installation de Raspberry Pi OS

Il existe plusieurs façons d’installer Grafana. L’architecture ARM du Raspberry Pi est bien prise en charge (armhf et arm64, d’ailleurs). Vous pouvez télécharger un paquet Debian, les fichiers sources, utiliser Docker ou encore ajouter le dépôt Grafana.

Parmi toutes ces options, j’ai tendance à préférer la dernière. En ajoutant un nouveau dépôt à votre système, vous simplifierez le processus d’installation et de mise à jour. Chaque fois que vous effectuerez une mise à niveau du système, Grafana sera mis à jour avec la dernière version disponible, ce qui est une bonne pratique.

J’ai donc créé ce tutoriel en utilisant Raspberry Pi OS Lite, 64 bits, et je vous recommande de faire de même.
Si vous avez besoin d’aide pour l’installation, vous pouvez lire mon guide d’installation de Raspberry Pi OS ici.

Une fois installé, assurez-vous de réaliser ces étapes :

• Être connecté à Internet.
• Mises à jour du système effectuées.
• Facultatif : SSH activé et connexion établie depuis votre ordinateur.

Une fois cela fait, vous pouvez passer à l’étape suivante pour ajouter le dépôt Grafana sur Raspberry Pi OS. Et si vous préférez les autres options d’installation, vous pouvez consulter leur site Web pour plus de détails.

Étape 2 – Ajouter le dépôt Grafana à votre système

Vous pouvez ajouter le dépôt Grafana à votre système avec seulement deux commandes :

• Ouvrez un terminal ou utilisez la connexion SSH depuis votre ordinateur.
• Téléchargez et installez la clé de sécurité :
  wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -
• Ajoutez l’URL de leur serveur à la liste des sources APT :
  echo "deb https://packages.grafana.com/oss/deb stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list

C’est tout, APT peut maintenant utiliser ce serveur comme source pour les futures installations et mises à jour. Nous pouvons passer à l’étape suivante.

Note : Grafana a deux versions : OSS et Enterprise. Je vous montre comment installer et utiliser l’édition open-source uniquement. Consultez leur site Web pour plus de détails sur les différences entre les deux versions. Il existe également une version Cloud où vous n’avez pas besoin d’une installation locale.

Étape 3 – Installer Grafana

Une fois le système prêt et le référentiel ajouté, l’installation de Grafana est simple.
Il suffit d’ouvrir un terminal et de taper ces commandes :
sudo apt update
sudo apt install grafana

Après quelques secondes, Grafana sera installé sur votre système. Grafana fonctionne comme un service, mais il n’est pas lancé automatiquement. Il y a une étape supplémentaire pour le démarrer, et le configurer pour qu’il démarre automatiquement au démarrage. Les commandes sont données à la fin de l’installation :
sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable grafana-server
sudo /bin/systemctl start grafana-server

Vous pouvez utiliser la commande « status » pour vous assurer que le serveur a bien démarré :
sudo /bin/systemctl start grafana-server

Ça a l’air bien ! Voyons maintenant comment s’en servir.

Si les commandes Linux ce n’est pas trop votre truc, n’hésitez pas à jeter un œil à cet article qui vous explique les commandes qu’il faut absolument connaître. Je vous donne aussi une antisèche à télécharger pour les avoir toujours sous la main !

Premiers pas avec Grafana sur Raspberry Pi

Le service Grafana dispose d’une interface web pour tout surveiller et configurer. Bonne nouvelle, vous n’avez plus besoin du terminal ;-).

Premier accès

Par défaut, Grafana fonctionne sur le port 3000, vous pouvez donc y accéder à partir de votre navigateur Web, sur n’importe quel ordinateur du même réseau :
http://<RASPBERRYPI_IP>:3000

Si vous ne connaissez pas l’adresse IP de votre Raspberry Pi, je vous recommande de commencer par lire cet article.

La première chose que vous verrez est ce formulaire de connexion :

Utiliser les informations d’identification par défaut : admin / admin.
Il vous sera alors demandé de modifier le mot de passe par défaut, ce qui est fortement recommandé.
Une fois cela fait, vous devriez avoir accès à l’interface complète de Grafana :

La prise en main de Grafana peut sembler compliquée. Je vous donnerai quelques conseils pour bien démarrer dans les prochains paragraphes. Cependant, je vous encourage à consulter tous les conseils et la documentation qu’ils ont pour vous sur leur site.

Comme vous pouvez le voir sur ma capture d’écran, ils vous montrent les premières étapes, avec un lien vers un tutoriel, et vous demandent de créer des sources de données et des tableaux de bord.

Ajouter une source de données

Avant de créer un tableau de bord et un graphique, vous devez avoir une source de données connectée.

Une source de données peut être n’importe quoi. Par exemple, disons que vous avez un capteur qui enregistre la température actuelle toutes les minutes. Si la base de données où vous stockez ces informations est compatible, vous pouvez facilement la connecter à Grafana pour y afficher l’historique des températures.

Grafana gère de manière native de nombreuses bases de données :

• Séries : Prometheus, Graphite, OpenTSDB, InfluxDB.
• Indexé : Loki, Elasticsearch.
• Distribué : Jaeger, Zipkin, Tempo.
• SQL : MySQL, PostgreSQL, SQL Server.
• Cloud : Google Cloud Monitoring, CloudWatch, AzureMonitor, Grafana Cloud.
• Solutions d’entreprise : Wavefront, Splunk, Snowflake, ServiceNow, SalesForce. New Relic, MongoDB, Jira, GitLab, etc.

Et vous pouvez également trouver des plugins pour Grafana sur leur site Web, pour utiliser encore plus de sources de données.
Voici un exemple d’installation du plugin JSON API de Marcus Olsson :
sudo grafana-cli plugins install marcusolsson-json-datasource
sudo /bin/systemctl restart grafana-server

Attention : tous les plugins ne sont pas compatibles avec la dernière version de Grafana.

Une fois installé, vous trouverez le nouveau plugin dans le sous-menu Configuration > Plugins de l’interface Grafana :

Il sera également ajouté à la liste des types de sources disponibles lorsque vous cliquerez sur « Add new data source » :

Meteostat et JSON API sont deux plugins que j’ai ajoutés en suivant le même processus.

Pour créer une source, vous remplirez alors le formulaire correspondant au type de source que vous choisissez dans cette liste. Par exemple, une API JSON de base peut fonctionner avec simplement l’URL et la chaîne de requête. J’ai testé avec la même API que celle utilisée dans mon livre sur Python, où j’ai synchronisé mes lumières intelligentes avec les heures de coucher et de lever du soleil :

Créez votre premier tableau de bord

Un tableau de bord est une page, avec un ou plusieurs graphiques, connectés à l’une de vos sources de données pour afficher les données, ce qui facilite leur analyse pour vous. Dans Grafana, chaque tableau de bord peut comporter plusieurs lignes et panneaux pour afficher tout ce dont vous avez besoin dans un but précis.

Ainsi, la création d’un tableau de bord varie beaucoup en fonction de vos objectifs, mais continuons avec mon exemple débile :

• Sur la page d’accueil, cliquez sur « Create your first dashboard ».
• Ensuite, cliquez sur « Add new panel ».
• Vous devez ensuite choisir votre source de données et remplir le formulaire pour afficher exactement ce que vous voulez dans le panneau correspondant.
  
  Cette étape sera entièrement différente pour chaque source de données.
  Avec Meteostat, vous choisissez la station météo et les données que vous souhaitez afficher.
  Et avec l’API JSON, la requête est déjà construite dans la source de données, il suffit de choisir une valeur dans le résultat :
  
  Le format des champs est un peu bizarre, mais il y a une autocomplétion, donc vous y arriverez rapidement.

Comme votre expérience variera beaucoup en fonction du plugin ou de la source de données que vous utilisez et des valeurs que vous souhaitez afficher, je vous recommande vivement de consulter la documentation correspondante à ce stade. Je ne peux pas tout couvrir dans cet article.

J’ai trouvé que la documentation des plugins est généralement suffisante pour comprendre comment ils fonctionnent, et aide beaucoup à créer vos premiers graphiques. Peut-être que j’ai eu de la chance avec mes choix de plugins, mais je n’ai eu aucun problème pour créer les premiers graphiques.

Évidemment, Grafana va beaucoup plus loin, ceci n’était qu’une introduction. Si vous voulez voir tout le potentiel, vous pouvez vérifier leur site de demonstration ici. C’est la même interface, accessible gratuitement, avec des tonnes de sources de données déjà connectées, pour que vous puissiez jouer avec.

Ressources supplémentaires pour votre Raspberry Pi

Initiation au Raspberry Pi en vidéo
Si vous débutez et voulez passer rapidement à la vitesse supérieure, j’ai exactement ce qu’il vous faut.
Regardez ma formation vidéo qui vous aidera à démarrer du bon bien, choisir votre matériel, installer les meilleures applications et vous lancer directement dans vos premiers projets avec mon aide.
Regarder les vidéos dès maintenant

Maîtrisez votre Raspberry Pi en 30 jours
Vous avez besoin de plus ? Si vous êtes à la recherche des meilleures astuces pour devenir expert sur Raspberry Pi, ce livre est fait pour vous. Développez vos compétences sous Linux et pratiquez via de nombreux projets en suivant mes guides étape par étape. 10% de remise aujourd’hui !
Télécharger le livre au format PDF ici

Maîtrisez Python sur Raspberry Pi
Pas besoin d’être un génie pour coder quelques lignes pour votre Raspberry Pi.
Je vous apprends juste ce qu’il faut sur Python afin de réaliser n’importe quel projet. La seconde partie du livre est d’ailleurs consacrée à des exemples de projets où je vous guide pas à pas.
Ne perdez pas de temps, apprenez le strict nécessaire et économisez 10% avec ce lien :
Télécharger maintenant

Autres ressources pour profiter de votre Raspberry Pi
J’ai regroupé toutes mes recommandations de logiciels, sites utiles et de matériel sur cette page de ressources. Je vous invite à la consulter régulièrement pour faire les bons choix et rester à jour.
Visiter les pages ressources