Comment installer Grafana sur Ubuntu : Guide complet de configuration et d’installation

Grafana est l’une des plateformes open-source les plus puissantes pour la visualisation des données et la surveillance de l’infrastructure. Que vous suiviez les performances des serveurs, les métriques des applications ou les KPI commerciaux, les tableaux de bord flexibles de Grafana et son large support des sources de données en font un outil indispensable pour tout administrateur système ou ingénieur DevOps.

Ce guide complet vous accompagne à chaque étape de l’installation de Grafana sur Ubuntu — de la préparation initiale du système à la configuration des sources de données, la création de votre premier tableau de bord, la mise en place des alertes et la sécurisation de votre déploiement.

> Prérequis : Un serveur Ubuntu en cours d’exécution (20.04 ou 22.04 LTS recommandé), des privilèges sudo et une connexion Internet stable. Si vous avez besoin d’un serveur fiable pour héberger votre instance Grafana, envisagez un VPS Hosting d’AlexHost — optimisé pour les charges de travail de surveillance critiques en termes de performance.

Table des matières

1. Mettre à jour les paquets système
2. Installer Grafana via le référentiel APT officiel
3. Démarrer et activer le service Grafana
4. Accéder à l’interface Web de Grafana
5. Configurer les sources de données
6. Créer votre premier tableau de bord
7. Configurer les alertes
8. Sécuriser Grafana avec HTTPS et les contrôles d’accès
9. Gérer et mettre à jour Grafana

Étape 1 : Mettre à jour les paquets système {#step-1}

Avant d’installer un nouveau logiciel, il est essentiel de synchroniser votre index de paquets et d’appliquer toutes les mises à jour disponibles. Cela garantit la compatibilité et réduit le risque de conflits de dépendances.

sudo apt update && sudo apt upgrade -y

Attendez que le processus se termine avant de continuer. Sur un serveur nouvellement provisionné, cela peut prendre quelques minutes.

Étape 2 : Installer Grafana via le référentiel APT officiel {#step-2}

Grafana maintient un référentiel APT officiel pour les systèmes basés sur Debian, y compris Ubuntu. L’utilisation du référentiel officiel garantit que vous avez toujours accès aux dernières versions stables et aux correctifs de sécurité.

Étape 2a : Installer les dépendances requises

Tout d’abord, installez le paquet software-properties-common, qui fournit l’utilitaire add-apt-repository :

sudo apt install -y software-properties-common apt-transport-https wget gnupg2

Étape 2b : Importer la clé de signature GPG de Grafana

L’ajout de la clé GPG permet à votre système de vérifier l’authenticité des paquets téléchargés à partir du référentiel Grafana :

wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -

Étape 2c : Ajouter le référentiel APT officiel de Grafana

sudo add-apt-repository "deb https://packages.grafana.com/oss/deb stable main"

Étape 2d : Mettre à jour la liste des paquets et installer Grafana

sudo apt update
sudo apt install grafana -y

Une fois l’installation terminée, vérifiez la version installée :

grafana-server -v

Étape 3 : Démarrer et activer le service Grafana {#step-3}

Après l’installation, démarrez le démon du serveur Grafana et configurez-le pour qu’il se lance automatiquement au démarrage du système :

sudo systemctl start grafana-server
sudo systemctl enable grafana-server

Vérifiez que le service s’exécute correctement :

sudo systemctl status grafana-server

Vous devriez voir une sortie similaire à celle-ci, confirmant que le service est actif (en cours d’exécution) :

● grafana-server.service - Grafana instance
     Loaded: loaded (/lib/systemd/system/grafana-server.service; enabled)
     Active: active (running) since ...

Si le service ne démarre pas, vérifiez les journaux pour les erreurs :

sudo journalctl -u grafana-server -f

Étape 4 : Accéder à l’interface Web de Grafana {#step-4}

Par défaut, Grafana écoute sur le port 3000. Ouvrez votre navigateur Web et accédez à :

http://your_server_ip:3000

Remplacez your_server_ip par l’adresse IP réelle ou le nom d’hôte de votre serveur.

Identifiants de connexion par défaut

Lors de votre première connexion, Grafana vous demandera immédiatement de définir un nouveau mot de passe sécurisé. Ne sautez pas cette étape — laisser les identifiants par défaut en place est un risque de sécurité important.

> Remarque sur le pare-feu : Si vous utilisez UFW ou un autre pare-feu, ouvrez le port 3000 pour autoriser l’accès au navigateur :

> “`bash

> sudo ufw allow 3000/tcp

> sudo ufw reload

> “`

Étape 5 : Configurer les sources de données {#step-5}

Grafana est une couche de visualisation — elle ne stocke pas les métriques elle-même. Au lieu de cela, elle se connecte à des sources de données externes telles que Prometheus, InfluxDB, Elasticsearch, MySQL, PostgreSQL et bien d’autres. La configuration d’une source de données est l’étape essentielle avant de pouvoir créer un tableau de bord.

Étape 5a : Accéder aux sources de données

1. Dans la barre latérale gauche, cliquez sur l’icône d’engrenage (⚙) pour ouvrir le menu Configuration.
2. Sélectionnez Sources de données.

Étape 5b : Ajouter une nouvelle source de données

1. Cliquez sur Ajouter une source de données.
2. Parcourez la liste et sélectionnez le type de source de données souhaité (par exemple, Prometheus, InfluxDB, MySQL).

Étape 5c : Entrer les détails de connexion

Remplissez les paramètres de connexion pour votre source de données choisie. Par exemple, si vous vous connectez à une instance Prometheus s’exécutant localement :

• URL : http://localhost:9090
• Accès : Server (default)
• Intervalle de scrape : 15s (correspond à votre configuration de scrape Prometheus)

Pour une instance InfluxDB distante, vous fournirez l’URL de l’hôte, le nom de la base de données et les identifiants d’authentification.

Étape 5d : Enregistrer et tester la connexion

Cliquez sur Enregistrer et tester. Grafana tentera de se connecter à la source de données et affichera un message de succès ou d’erreur. Une confirmation verte « La source de données fonctionne » signifie que vous êtes prêt à créer des tableaux de bord.

Étape 6 : Créer votre premier tableau de bord Grafana {#step-6}

Avec une source de données connectée, vous pouvez maintenant créer des tableaux de bord pour visualiser vos métriques en temps réel.

Étape 6a : Créer un nouveau tableau de bord

1. Dans la barre latérale gauche, cliquez sur l’icône + (plus).
2. Sélectionnez Tableau de bord.
3. Cliquez sur Ajouter un nouveau panneau.

Étape 6b : Configurer le panneau

L’éditeur de panneau s’ouvre, vous donnant un contrôle total sur les données affichées et leur visualisation.

• Source de données : Sélectionnez la source de données que vous avez configurée à l’étape 5.
• Requête : Écrivez votre requête de métrique. Pour Prometheus, utilisez PromQL. Par exemple, pour visualiser l’utilisation du CPU :

  100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

• Type de visualisation : Choisissez parmi Série temporelle, Jauge, Graphique en barres, Tableau, Stat, Carte thermique et bien d’autres — selon la nature de vos données.
• Titre du panneau : Donnez à votre panneau un nom descriptif (par exemple, « Utilisation du CPU — Dernière 1 heure »).

Étape 6c : Personnaliser et enregistrer

Utilisez les options du panneau de droite pour configurer les seuils, les schémas de couleurs, les étiquettes des axes et les légendes. Une fois satisfait :

1. Cliquez sur Appliquer pour ajouter le panneau à votre tableau de bord.
2. Répétez le processus pour ajouter plusieurs panneaux — chacun suivant une métrique différente.
3. Cliquez sur l’icône Enregistrer le tableau de bord (disquette) dans le coin supérieur droit, donnez un nom à votre tableau de bord et cliquez sur Enregistrer.

> Conseil professionnel : La bibliothèque de tableaux de bord officielle de Grafana propose des centaines de tableaux de bord préconfigurés et contribués par la communauté pour les piles populaires comme Node Exporter, Kubernetes, MySQL et NGINX. Vous pouvez les importer directement en utilisant un ID de tableau de bord.

Étape 7 : Configurer les alertes {#step-7}

Le moteur d’alerte intégré de Grafana vous permet de définir des règles basées sur des seuils et de recevoir des notifications lorsque les métriques dépassent les niveaux critiques — vous tenant informé avant que les petits problèmes ne deviennent des pannes majeures.

Étape 7a : Créer une règle d’alerte

1. Ouvrez le panneau que vous souhaitez surveiller et cliquez sur Modifier.
2. Accédez à l’onglet Alerte dans l’éditeur de panneau.
3. Cliquez sur Créer une alerte.

Étape 7b : Définir les conditions d’alerte

Configurez les conditions qui déclenchent l’alerte. Par exemple :

• Condition : WHEN avg() OF query(A, 5m, now) IS ABOVE 90
• Cela déclenche une alerte lorsque la valeur moyenne de votre métrique dépasse 90 au cours des 5 dernières minutes.

Définissez les champs Évaluer tous les et Pendant pour contrôler la fréquence d’évaluation de la règle et la durée pendant laquelle la condition doit persister avant de se déclencher.

Étape 7c : Configurer les canaux de notification

1. Allez à Alertes → Canaux de notification dans la barre latérale gauche.
2. Cliquez sur Ajouter un canal et choisissez votre méthode préférée :

• Email — nécessite une configuration SMTP dans grafana.ini
• Slack — nécessite une URL de webhook Slack
• PagerDuty, OpsGenie, Webhook et bien d’autres

Assignez le canal de notification à votre règle d’alerte pour que les bonnes personnes soient notifiées lorsque les seuils sont dépassés.

Étape 8 : Sécuriser Grafana avec HTTPS et les contrôles d’accès {#step-8}

Exécuter Grafana dans un environnement de production sans durcissement de sécurité approprié est un risque sérieux. Suivez ces bonnes pratiques pour protéger votre infrastructure de surveillance.

8a : Activer HTTPS avec un certificat SSL

Le chiffrement du trafic vers votre instance Grafana est essentiel, surtout s’il est accessible sur l’Internet public. Vous aurez besoin d’un certificat SSL valide — AlexHost propose des certificats SSL abordables et faciles à déployer.

Une fois que vous avez votre certificat et votre clé privée, modifiez le fichier de configuration de Grafana :

sudo nano /etc/grafana/grafana.ini

Localisez la section [server] et mettez à jour les paramètres suivants :

[server]
protocol = https
http_port = 3000
cert_file = /etc/grafana/ssl/grafana.crt
cert_key = /etc/grafana/ssl/grafana.key

Enregistrez le fichier et redémarrez Grafana :

sudo systemctl restart grafana-server

Grafana sera maintenant accessible via HTTPS sur le port 3000.

> Alternative recommandée : Placez Grafana derrière un proxy inverse (par exemple, Nginx ou Apache) et terminez SSL au niveau du proxy. C’est une approche plus flexible et largement adoptée dans les environnements de production.

8b : Restreindre l’accès administrateur et gérer les utilisateurs

1. Accédez à Admin du serveur → Utilisateurs dans l’interface utilisateur de Grafana.
2. Examinez et ajustez les rôles des utilisateurs :

• Admin — accès complet
• Éditeur — peut créer et modifier des tableaux de bord
• Lecteur — accès en lecture seule

1. Désactivez ou supprimez les comptes inutilisés.
2. Envisagez d’activer LDAP ou OAuth (Google, GitHub, GitLab) pour l’authentification centralisée.

8c : Recommandations de durcissement supplémentaires

• Désactiver l’accès anonyme dans grafana.ini :

  [auth.anonymous]
  enabled = false

• Modifier le port HTTP par défaut si Grafana est exposé publiquement.
• Restreindre les connexions sortantes du serveur Grafana à l’aide de règles de pare-feu.
• Activer l’enregistrement d’audit pour suivre l’activité des utilisateurs.

Étape 9 : Gérer et mettre à jour Grafana {#step-9}

Maintenir Grafana à jour est essentiel pour la sécurité et l’accès aux nouvelles fonctionnalités. Comme vous avez installé Grafana à partir du référentiel APT officiel, les mises à jour sont simples.

Mettre à jour Grafana

sudo apt update
sudo apt upgrade grafana -y

Commandes courantes de gestion des services

Sauvegarder les données de Grafana

Grafana stocke sa configuration, ses tableaux de bord et ses données utilisateur dans une base de données SQLite par défaut, située à :

/var/lib/grafana/grafana.db

Sauvegardez ce fichier régulièrement, en particulier avant d’effectuer des mises à jour :

sudo cp /var/lib/grafana/grafana.db /var/lib/grafana/grafana.db.backup-$(date +%F)

Pour les déploiements plus importants, envisagez de migrer vers un backend MySQL ou PostgreSQL dédié pour une meilleure fiabilité et une gestion plus facile des sauvegardes.

Dépannage des problèmes courants