Installer Prometheus, Node Exporter et Grafana sur Debian ou Ubuntu

Par Ariful Islam Date : 2 août 2026 Type : guide Catégorie : DevOps Tags : prometheus, grafana, node-exporter, monitoring, systemd

Guide pas à pas pour monter une pile de supervision sur un serveur Debian/Ubuntu. Les versions utilisées ci-dessous sont les dernières stables au moment de la rédaction (août 2026) : Prometheus 3.13.1, Node Exporter 1.12.1, Grafana 13.1.1. Consultez les pages de publication avant de lancer quoi que ce soit, au cas où de plus récentes seraient sorties.

Gardez trois références amont ouvertes à côté de ce guide : la référence de configuration de Prometheus, la liste des collecteurs de Node Exporter avec ce que coûte chacun d'eux, et la documentation d'installation de Grafana sur Debian.

Architecture

+----------------+   scrapes :9100   +----------------+
|  Node Exporter | <---------------- |   Prometheus   |
|   :9100        |                   |   :9090        |
+----------------+                   +--------+-------+
                                              |
                                              | PromQL queries :9090
                                              v
                                     +----------------+
                                     |    Grafana     |
                                     |   :3000        |
                                     +----------------+
                                              |
                                              v
                                        Browser / user

Prérequis

Un serveur Debian ou Ubuntu avec un accès sudo
curl et tar installés
Un accès SSH pour un tunnel. Gardez les ports 9090, 9100 et 3000 fermés sur internet ; les trois services écouteront uniquement sur la boucle locale.

Partie 1 : installer Prometheus

Étape 1 : créer l'utilisateur système prometheus

bash

sudo useradd --no-create-home --shell /bin/false prometheus

Étape 2 : créer les répertoires

bash

sudo mkdir -p /etc/prometheus /var/lib/prometheus

Étape 3 : télécharger Prometheus

bash

cd /tmp
curl -LO https://github.com/prometheus/prometheus/releases/download/v3.13.1/prometheus-3.13.1.linux-amd64.tar.gz
tar -xvf prometheus-3.13.1.linux-amd64.tar.gz

Étape 4 : installer les binaires

bash

sudo cp prometheus-3.13.1.linux-amd64/prometheus /usr/local/bin/
sudo cp prometheus-3.13.1.linux-amd64/promtool /usr/local/bin/
sudo chown prometheus:prometheus /usr/local/bin/prometheus /usr/local/bin/promtool

Étape 5 : installer les modèles de console et définir le propriétaire

bash

sudo cp -r prometheus-3.13.1.linux-amd64/consoles /etc/prometheus
sudo cp -r prometheus-3.13.1.linux-amd64/console_libraries /etc/prometheus
sudo chown -R prometheus:prometheus /etc/prometheus /var/lib/prometheus

Étape 6 : créer le fichier de configuration

bash

sudo tee /etc/prometheus/prometheus.yml > /dev/null <<EOF
global:
  scrape_interval: 10s

scrape_configs:
  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090']
EOF

La tâche de collecte de Node Exporter est ajoutée en partie 3, une fois qu'il est installé.

Étape 7 : créer le service systemd

bash

sudo tee /etc/systemd/system/prometheus.service > /dev/null <<EOF
[Unit]
Description=Prometheus
Wants=network-online.target
After=network-online.target

[Service]
User=prometheus
Group=prometheus
Type=simple
ExecStart=/usr/local/bin/prometheus \\
  --config.file=/etc/prometheus/prometheus.yml \\
  --storage.tsdb.path=/var/lib/prometheus \\
  --web.listen-address=127.0.0.1:9090 \\
  --web.console.templates=/etc/prometheus/consoles \\
  --web.console.libraries=/etc/prometheus/console_libraries \\
  --storage.tsdb.retention.time=365d
ExecReload=/bin/kill -HUP \$MAINPID

[Install]
WantedBy=multi-user.target
EOF

ExecReload est ce qui fait fonctionner systemctl reload prometheus en partie 3. Sans lui, systemd refuse le rechargement avec "Job type reload is not applicable", et il ne vous reste qu'un redémarrage complet. Notez la barre oblique inverse dans \$MAINPID : ce heredoc n'est pas entre guillemets, sinon le shell développerait la variable en rien au moment d'écrire le fichier.

Étape 8 : démarrer et activer Prometheus

bash

sudo systemctl daemon-reload
sudo systemctl enable --now prometheus

Étape 9 : vérifier

bash

sudo systemctl status prometheus
curl -s http://localhost:9090/-/healthy

Depuis votre ordinateur, ouvrez un tunnel SSH et laissez-le fonctionner :

bash

ssh -N -L 9090:127.0.0.1:9090 -L 3000:127.0.0.1:3000 user@server

Remplacez user@server par votre destination SSH, puis ouvrez http://localhost:9090 dans le navigateur de votre ordinateur.

Nettoyer le téléchargement de Prometheus

bash

rm -rf /tmp/prometheus-3.13.1.linux-amd64*

Partie 2 : installer Node Exporter

Étape 1 : créer l'utilisateur système node_exporter

bash

sudo useradd --no-create-home --shell /bin/false node_exporter

Étape 2 : télécharger Node Exporter

bash

cd /tmp
curl -LO https://github.com/prometheus/node_exporter/releases/download/v1.12.1/node_exporter-1.12.1.linux-amd64.tar.gz
tar -xvf node_exporter-1.12.1.linux-amd64.tar.gz

Étape 3 : installer le binaire

bash

sudo cp node_exporter-1.12.1.linux-amd64/node_exporter /usr/local/bin/
sudo chown node_exporter:node_exporter /usr/local/bin/node_exporter

Étape 4 : créer le service systemd

bash

sudo tee /etc/systemd/system/node_exporter.service > /dev/null <<EOF
[Unit]
Description=Node Exporter
Wants=network-online.target
After=network-online.target

[Service]
User=node_exporter
Group=node_exporter
Type=simple
ExecStart=/usr/local/bin/node_exporter --web.listen-address=127.0.0.1:9100

[Install]
WantedBy=multi-user.target
EOF

Étape 5 : démarrer et activer Node Exporter

bash

sudo systemctl daemon-reload
sudo systemctl enable --now node_exporter

Étape 6 : vérifier

bash

curl -s http://localhost:9100/metrics | head

Nettoyer le téléchargement de Node Exporter

bash

rm -rf /tmp/node_exporter-1.12.1.linux-amd64*

Partie 3 : pointer Prometheus vers Node Exporter

Étape 1 : ajouter la tâche de collecte

bash

sudo vim /etc/prometheus/prometheus.yml

Ajoutez sous scrape_configs :

yaml

  - job_name: "node_exporter"
    static_configs:
      - targets: ['localhost:9100']

Étape 2 : valider la configuration

bash

promtool check config /etc/prometheus/prometheus.yml

Étape 3 : recharger Prometheus

bash

sudo systemctl reload prometheus

Étape 4 : vérifier que la cible répond

À travers le tunnel SSH, ouvrez http://localhost:9090/targets : les tâches prometheus et node_exporter devraient toutes deux afficher State = UP.

Partie 4 : installer Grafana

Méthode officielle : dépôt APT. apt-get update actualise les listes de paquets ; apt-get install --only-upgrade grafana installe une mise à jour disponible. Source : https://grafana.com/docs/grafana/latest/setup-grafana/installation/debian/

Étape 1 : installer les prérequis

bash

sudo apt-get install -y apt-transport-https wget gnupg

Étape 2 : importer la clé GPG

bash

sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
sudo chmod 644 /etc/apt/keyrings/grafana.asc

Étape 3 : ajouter le dépôt stable

bash

echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list

Étape 4 : mettre à jour la liste des paquets

bash

sudo apt-get update

Étape 5 : installer Grafana OSS

bash

sudo apt-get install -y grafana

Étape 6 : démarrer et activer Grafana

bash

sudo mkdir -p /etc/systemd/system/grafana-server.service.d
printf '[Service]\nEnvironment=GF_SERVER_HTTP_ADDR=127.0.0.1\n' | sudo tee /etc/systemd/system/grafana-server.service.d/listen.conf
sudo systemctl daemon-reload
sudo systemctl enable grafana-server
sudo systemctl restart grafana-server

Étape 7 : vérifier

bash

sudo systemctl status grafana-server

À travers le tunnel SSH, ouvrez http://localhost:3000. Les identifiants par défaut sont admin / admin, et il vous sera demandé de les changer à la première connexion.

Partie 5 : configuration Grafana optionnelle (domaine propre / HTTPS)

Le tunnel SSH suffit pour un accès privé. Pour publier le tableau de bord, faites pointer grafana.example.com vers le serveur et terminez TLS dans nginx. Grafana reste en HTTP sur la boucle locale ; n'activez pas HTTPS sur son port interne.

Étape 1 : modifier grafana.ini

bash

sudo vim /etc/grafana/grafana.ini

ini

[server]
http_addr = 127.0.0.1
http_port = 3000
domain = grafana.example.com
root_url = https://grafana.example.com/
enforce_domain = true
protocol = http

Étape 2 : redémarrer Grafana

bash

sudo systemctl restart grafana-server

Étape 3 (optionnelle) : proxy inverse Nginx

nginx

map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

server {
    listen 80;
    listen [::]:80;

    server_name grafana.example.com;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://127.0.0.1:3000;
    }

    location /api/live {
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://127.0.0.1:3000;
    }
}

Installez nginx et Certbot, puis enregistrez la configuration ci-dessus dans /etc/nginx/sites-available/grafana.example.com. Remplacez le domaine d'exemple partout :

bash

sudo apt-get install -y nginx certbot python3-certbot-nginx
sudo ln -s /etc/nginx/sites-available/grafana.example.com /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d grafana.example.com
sudo certbot renew --dry-run

Ouvrez les ports 80 et 443 pour nginx, pas le 3000. Certbot configure TLS et le minuteur de renouvellement. Gardez l'authentification Grafana activée et changez le mot de passe initial via le tunnel SSH avant de publier le domaine.

Partie 6 : connecter Grafana à Prometheus

Étape 1 : ajouter la source de données

Dans Grafana : Connections > Data sources > Add data source > Prometheus.

Renseignez l'URL :

http://localhost:9090

Cliquez sur Save & test, vous devriez voir "Successfully queried the Prometheus API."

Étape 2 : importer le tableau de bord Node Exporter

Dashboards > New > Import, puis saisissez l'ID du tableau de bord :

Sélectionnez votre source de données Prometheus quand on vous le demande, puis cliquez sur Import. C'est le tableau de bord communautaire "Node Exporter Full", et il couvre le processeur, la mémoire, le disque et le réseau d'emblée.

Aide-mémoire de gestion des services

service          start                 status                enable
---------------  --------------------  --------------------  -------------------------------
prometheus       systemctl start       systemctl status       systemctl enable prometheus
node_exporter    systemctl start       systemctl status       systemctl enable node_exporter
grafana-server   systemctl start       systemctl status       systemctl enable grafana-server

Recharger les configurations sans interruption :

bash

sudo systemctl reload prometheus
sudo systemctl restart grafana-server

La suite

Un serveur, c'est le point de départ, pas l'arrivée. Les deux étapes suivantes sont généralement les alertes (Alertmanager, pour qu'un disque plein vous réveille à 3 h du matin au lieu de vous surprendre à 9 h) et un deuxième exporter pour ce que la machine fait réellement tourner. Si cette machine est un site web, auto-héberger WordPress avec Docker et Redis est l'autre moitié du même montage.

La supervision à plus grande échelle représente une bonne part de mon travail : observabilité avec Grafana et Prometheus, y compris un banc d'essai qui a envoyé dix millions de requêtes en quinze minutes. Volontiers pour en parler.

Désinstaller

Supprimer Prometheus

bash

sudo systemctl disable --now prometheus
sudo rm -f /usr/local/bin/prometheus /usr/local/bin/promtool
sudo rm -rf /etc/prometheus /var/lib/prometheus /etc/systemd/system/prometheus.service
sudo userdel prometheus
sudo systemctl daemon-reload

Supprimer Node Exporter

bash

sudo systemctl disable --now node_exporter
sudo rm -f /usr/local/bin/node_exporter /etc/systemd/system/node_exporter.service
sudo userdel node_exporter
sudo systemctl daemon-reload

Supprimer Grafana

bash

sudo systemctl stop grafana-server
sudo apt-get remove -y grafana
sudo rm -i /etc/apt/sources.list.d/grafana.list

Installer Prometheus, Node Exporter et Grafana sur Debian ou Ubuntu ​

Architecture ​

Prérequis ​

Partie 1 : installer Prometheus ​

Étape 1 : créer l'utilisateur système prometheus ​

Étape 2 : créer les répertoires ​

Étape 3 : télécharger Prometheus ​

Étape 4 : installer les binaires ​

Étape 5 : installer les modèles de console et définir le propriétaire ​

Étape 6 : créer le fichier de configuration ​

Étape 7 : créer le service systemd ​

Étape 8 : démarrer et activer Prometheus ​

Étape 9 : vérifier ​

Nettoyer le téléchargement de Prometheus ​

Partie 2 : installer Node Exporter ​

Étape 1 : créer l'utilisateur système node_exporter ​

Étape 2 : télécharger Node Exporter ​

Étape 3 : installer le binaire ​

Étape 4 : créer le service systemd ​

Étape 5 : démarrer et activer Node Exporter ​

Étape 6 : vérifier ​

Nettoyer le téléchargement de Node Exporter ​

Partie 3 : pointer Prometheus vers Node Exporter ​

Étape 1 : ajouter la tâche de collecte ​

Étape 2 : valider la configuration ​

Étape 3 : recharger Prometheus ​

Étape 4 : vérifier que la cible répond ​

Partie 4 : installer Grafana ​

Étape 1 : installer les prérequis ​

Étape 2 : importer la clé GPG ​

Étape 3 : ajouter le dépôt stable ​

Étape 4 : mettre à jour la liste des paquets ​

Étape 5 : installer Grafana OSS ​

Étape 6 : démarrer et activer Grafana ​

Étape 7 : vérifier ​

Partie 5 : configuration Grafana optionnelle (domaine propre / HTTPS) ​

Étape 1 : modifier grafana.ini ​

Étape 2 : redémarrer Grafana ​

Étape 3 (optionnelle) : proxy inverse Nginx ​

Partie 6 : connecter Grafana à Prometheus ​

Étape 1 : ajouter la source de données ​

Étape 2 : importer le tableau de bord Node Exporter ​

Aide-mémoire de gestion des services ​

La suite ​

Désinstaller ​

Supprimer Prometheus ​

Supprimer Node Exporter ​

Supprimer Grafana ​

Installer Prometheus, Node Exporter et Grafana sur Debian ou Ubuntu

Architecture

Prérequis

Partie 1 : installer Prometheus

Étape 1 : créer l'utilisateur système prometheus

Étape 2 : créer les répertoires

Étape 3 : télécharger Prometheus

Étape 4 : installer les binaires

Étape 5 : installer les modèles de console et définir le propriétaire

Étape 6 : créer le fichier de configuration

Étape 7 : créer le service systemd

Étape 8 : démarrer et activer Prometheus

Étape 9 : vérifier

Nettoyer le téléchargement de Prometheus

Partie 2 : installer Node Exporter

Étape 1 : créer l'utilisateur système node_exporter

Étape 2 : télécharger Node Exporter

Étape 3 : installer le binaire

Étape 4 : créer le service systemd

Étape 5 : démarrer et activer Node Exporter

Étape 6 : vérifier

Nettoyer le téléchargement de Node Exporter

Partie 3 : pointer Prometheus vers Node Exporter

Étape 1 : ajouter la tâche de collecte

Étape 2 : valider la configuration

Étape 3 : recharger Prometheus

Étape 4 : vérifier que la cible répond

Partie 4 : installer Grafana

Étape 1 : installer les prérequis

Étape 2 : importer la clé GPG

Étape 3 : ajouter le dépôt stable

Étape 4 : mettre à jour la liste des paquets

Étape 5 : installer Grafana OSS

Étape 6 : démarrer et activer Grafana

Étape 7 : vérifier

Partie 5 : configuration Grafana optionnelle (domaine propre / HTTPS)

Étape 1 : modifier grafana.ini

Étape 2 : redémarrer Grafana

Étape 3 (optionnelle) : proxy inverse Nginx

Partie 6 : connecter Grafana à Prometheus

Étape 1 : ajouter la source de données

Étape 2 : importer le tableau de bord Node Exporter

Aide-mémoire de gestion des services

La suite

Désinstaller

Supprimer Prometheus

Supprimer Node Exporter

Supprimer Grafana