FR

Applications

Installer Prometheus et Grafana

Installez Prometheus, node_exporter et Grafana sans Docker sur Debian ou Ubuntu, avec tableaux de bord, accès HTTPS protégé, mises à jour et sauvegardes.

7 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide vous explique comment installer une plateforme de supervision complète, sans Docker, sur un VPS ou un serveur dédié sous Debian 12/13 ou Ubuntu 22.04/24.04.

Composant Rôle Port Écoute
node_exporter Expose les métriques du système 9100 127.0.0.1
Prometheus Collecte et stocke les métriques 9090 127.0.0.1
Grafana Affiche les tableaux de bord 3000 127.0.0.1
Nginx Publie Grafana en HTTPS 80, 443 Public

Seul Grafana est publié, derrière Nginx, en HTTPS et avec un compte. Prometheus et node_exporter ne sont jamais exposés sur Internet.

Commander un serveur

Pour héberger votre supervision, HostMyServers propose plusieurs offres :

Prérequis

  • Un serveur sous Debian 12/13 ou Ubuntu 22.04/24.04, en architecture amd64 ou arm64
  • Un accès SSH avec un utilisateur disposant de sudo
  • Un nom de domaine avec un enregistrement A : grafana.votre-domaine.com doit pointer vers l’adresse IP du serveur
  • Pour Grafana, au minimum 512 Mo de RAM et 1 cœur CPU selon sa documentation, en plus des besoins de Prometheus
  • De l’espace disque pour les métriques : il dépend du nombre de séries collectées et de la durée de conservation

Préparer le serveur

Terminal
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget tar jq gnupg ufw nginx certbot python3-certbot-nginx apache2-utils

Configurez le pare-feu. Autorisez SSH avant d’activer UFW, et remplacez 22 si vous utilisez un autre port.

Terminal
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enable

Les ports 3000, 9090 et 9100 ne doivent pas être ouverts.

Installer Prometheus

Créer l’utilisateur et les dossiers

Terminal
sudo useradd --system --no-create-home --shell /usr/sbin/nologin prometheus
sudo mkdir -p /etc/prometheus /var/lib/prometheus
sudo chown prometheus:prometheus /var/lib/prometheus

Télécharger et vérifier l’archive

Terminal
VERSION=3.13.5
ARCH=$(dpkg --print-architecture)
cd "$(mktemp -d)"
wget "https://github.com/prometheus/prometheus/releases/download/v${VERSION}/prometheus-${VERSION}.linux-${ARCH}.tar.gz"
wget "https://github.com/prometheus/prometheus/releases/download/v${VERSION}/sha256sums.txt"
sha256sum --check --ignore-missing sha256sums.txt
tar -xzf "prometheus-${VERSION}.linux-${ARCH}.tar.gz"
sudo install -m 0755 "prometheus-${VERSION}.linux-${ARCH}/prometheus" "prometheus-${VERSION}.linux-${ARCH}/promtool" /usr/local/bin/
prometheus --version

La vérification doit afficher OK pour l’archive téléchargée.

Configurer la collecte

Terminal
sudo nano /etc/prometheus/prometheus.yml
YAML
global:
  scrape_interval: 15s
  evaluation_interval: 15s

scrape_configs:
  - job_name: prometheus
    static_configs:
      - targets: ["127.0.0.1:9090"]

  - job_name: node
    static_configs:
      - targets: ["127.0.0.1:9100"]

Contrôlez le fichier :

Terminal
sudo chown -R root:prometheus /etc/prometheus
sudo chmod 750 /etc/prometheus
sudo chmod 640 /etc/prometheus/prometheus.yml
sudo promtool check config /etc/prometheus/prometheus.yml

Créer le service systemd

Terminal
sudo nano /etc/systemd/system/prometheus.service
Configuration
[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 \
  --storage.tsdb.retention.time=30d \
  --web.listen-address=127.0.0.1:9090 \
  --web.enable-admin-api
ExecReload=/bin/kill -HUP $MAINPID
Restart=on-failure
NoNewPrivileges=true
ProtectSystem=full
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
Option Effet
--storage.tsdb.retention.time=30d Conserve 30 jours de métriques (15 jours par défaut)
--web.listen-address=127.0.0.1:9090 N’écoute que sur l’interface locale
--web.enable-admin-api Active l’API utilisée pour les sauvegardes par instantané

Démarrez le service :

Terminal
sudo systemctl daemon-reload
sudo systemctl enable --now prometheus
sudo systemctl status prometheus --no-pager

Installer node_exporter

Terminal
sudo useradd --system --no-create-home --shell /usr/sbin/nologin node_exporter
VERSION=1.13.0
ARCH=$(dpkg --print-architecture)
cd "$(mktemp -d)"
wget "https://github.com/prometheus/node_exporter/releases/download/v${VERSION}/node_exporter-${VERSION}.linux-${ARCH}.tar.gz"
wget "https://github.com/prometheus/node_exporter/releases/download/v${VERSION}/sha256sums.txt"
sha256sum --check --ignore-missing sha256sums.txt
tar -xzf "node_exporter-${VERSION}.linux-${ARCH}.tar.gz"
sudo install -m 0755 "node_exporter-${VERSION}.linux-${ARCH}/node_exporter" /usr/local/bin/
sudo nano /etc/systemd/system/node_exporter.service
Configuration
[Unit]
Description=Prometheus 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
Restart=on-failure
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target
Terminal
sudo systemctl daemon-reload
sudo systemctl enable --now node_exporter
curl -s http://127.0.0.1:9100/metrics | head -n 5

Vérifiez que Prometheus collecte bien les deux cibles. Attendez une quinzaine de secondes après le démarrage :

Terminal
curl -s http://127.0.0.1:9090/api/v1/targets | jq -r '.data.activeTargets[] | "\(.labels.job) \(.health)"'

Le résultat attendu est :

Texte
node up
prometheus up

Installer Grafana

Ajouter le dépôt officiel

Terminal
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
echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
sudo apt update
sudo apt install -y grafana

Limiter Grafana à l’interface locale

Le compte initial de Grafana est admin / admin. Limitez l’écoute avant le premier démarrage :

Terminal
sudo nano /etc/grafana/grafana.ini

Dans la section [server], décommentez ou ajoutez :

Configuration
[server]
http_addr = 127.0.0.1
http_port = 3000

Démarrez le service et vérifiez qu’il répond :

Terminal
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-server
sudo ss -tlnp | grep 3000
curl -s http://127.0.0.1:3000/api/health

Changer le mot de passe administrateur

Changez le mot de passe avant de publier Grafana. Depuis votre poste, ouvrez un tunnel SSH et laissez cette session ouverte :

Terminal
ssh -L 3000:127.0.0.1:3000 VOTRE_USER@IP_SERVEUR

Ouvrez http://localhost:3000, connectez-vous avec admin / admin, puis définissez un mot de passe fort lorsque Grafana le demande. Vous pouvez ensuite fermer le tunnel.

Déclarer Prometheus comme source de données

Terminal
sudo nano /etc/grafana/provisioning/datasources/prometheus.yaml
YAML
apiVersion: 1

datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://127.0.0.1:9090
    isDefault: true
    editable: false
Terminal
sudo chown root:grafana /etc/grafana/provisioning/datasources/prometheus.yaml
sudo chmod 640 /etc/grafana/provisioning/datasources/prometheus.yaml
sudo systemctl restart grafana-server

Publier Grafana en HTTPS

Créer le site Nginx

Terminal
sudo nano /etc/nginx/sites-available/grafana.conf
Nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

upstream grafana {
    server 127.0.0.1:3000;
}

server {
    listen 80;
    listen [::]:80;
    server_name grafana.votre-domaine.com;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://grafana;
    }

    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_pass http://grafana;
    }
}
Terminal
sudo ln -s /etc/nginx/sites-available/grafana.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d grafana.votre-domaine.com -m admin@votre-domaine.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-run

Pour plus de détails sur les certificats, consultez le guide Installer un certificat SSL avec Let’s Encrypt.

Finaliser la configuration de Grafana

Terminal
sudo nano /etc/grafana/grafana.ini

Adaptez les sections suivantes :

Configuration
[server]
http_addr = 127.0.0.1
http_port = 3000
domain = grafana.votre-domaine.com
root_url = https://grafana.votre-domaine.com/

[security]
cookie_secure = true
cookie_samesite = lax
strict_transport_security = true

[users]
allow_sign_up = false
Terminal
sudo systemctl restart grafana-server

Importer un tableau de bord

  1. Ouvrez https://grafana.votre-domaine.com et connectez-vous.
  2. Cliquez sur Dashboards dans le menu principal.
  3. Cliquez sur New, puis sur Import dashboard.
  4. Saisissez l’identifiant 1860 (Node Exporter Full) et cliquez sur Load.
  5. Sélectionnez la source de données Prometheus, puis cliquez sur Import.

Vérifier l’installation

Sur le serveur, aucun service interne ne doit écouter sur une adresse publique :

Terminal
sudo ss -tlnp | grep -E ':(3000|9090|9100)\b'

Chaque ligne doit commencer par 127.0.0.1. Depuis votre poste, ces commandes doivent échouer :

Terminal
curl -m 5 http://IP_SERVEUR:3000/
curl -m 5 http://IP_SERVEUR:9090/
curl -m 5 http://IP_SERVEUR:9100/metrics

Enfin, https://grafana.votre-domaine.com doit afficher la page de connexion, avec un certificat valide.

Pour consulter l’interface de Prometheus, passez par un tunnel SSH, puis ouvrez http://localhost:9090 :

Terminal
ssh -L 9090:127.0.0.1:9090 VOTRE_USER@IP_SERVEUR

Protéger Prometheus par mot de passe (facultatif)

L’écoute locale empêche déjà tout accès depuis Internet. Ajoutez un mot de passe si d’autres utilisateurs ou applications ont accès au serveur.

Générez d’abord le hachage du mot de passe :

Terminal
htpasswd -nBC 12 "" | tr -d ':\n'; echo

Créez /etc/prometheus/web.yml avec sudo nano, puis collez-y ce hachage :

YAML
basic_auth_users:
  admin: "HACHAGE_BCRYPT"

Enregistrez aussi le mot de passe en clair, nécessaire à Prometheus pour collecter ses propres métriques :

Terminal
sudo install -o root -g prometheus -m 640 /dev/null /etc/prometheus/web-password
sudo nano /etc/prometheus/web-password
sudo chown root:prometheus /etc/prometheus/web.yml
sudo chmod 640 /etc/prometheus/web.yml
sudo promtool check web-config /etc/prometheus/web.yml

Appliquez ensuite ces trois modifications :

  1. Dans prometheus.service, ajoutez --web.config.file=/etc/prometheus/web.yml à la commande ExecStart.

  2. Dans prometheus.yml, complétez le job prometheus :

    YAML
    - job_name: prometheus
      basic_auth:
        username: admin
        password_file: /etc/prometheus/web-password
      static_configs:
        - targets: ["127.0.0.1:9090"]
  3. Dans la source de données Grafana, ajoutez les identifiants :

    YAML
    basicAuth: true
    basicAuthUser: admin
    secureJsonData:
      basicAuthPassword: VOTRE_MOT_DE_PASSE_PROMETHEUS

Rechargez la configuration et redémarrez les services :

Terminal
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl daemon-reload
sudo systemctl restart prometheus grafana-server

Ajoutez désormais -u admin aux commandes curl adressées au port 9090.

Superviser un autre serveur

Installez node_exporter sur le second serveur, avec --web.listen-address=0.0.0.0:9100 dans son service. Sur ce second serveur, n’autorisez que votre serveur Prometheus :

Terminal
sudo ufw allow from IP_SERVEUR to any port 9100 proto tcp

Ajoutez ensuite la cible dans /etc/prometheus/prometheus.yml, puis rechargez Prometheus :

YAML
  - job_name: node
    static_configs:
      - targets: ["127.0.0.1:9100", "IP_SECOND_SERVEUR:9100"]
Terminal
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl reload prometheus

Mettre à jour

Sauvegardez d’abord vos données et lisez les notes de version.

Prometheus : reprenez le bloc de téléchargement avec la nouvelle valeur de VERSION, puis :

Terminal
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl restart prometheus
prometheus --version

node_exporter : reprenez de même son téléchargement et son installation, puis :

Terminal
sudo systemctl restart node_exporter
node_exporter --version

Grafana : le paquet se met à jour avec APT.

Terminal
sudo apt update
sudo apt install --only-upgrade grafana
sudo systemctl restart grafana-server

Sauvegarder et restaurer

Prometheus

La documentation de Prometheus recommande les instantanés (snapshots) :

Terminal
SNAPSHOT=$(curl -fsS -X POST http://127.0.0.1:9090/api/v1/admin/tsdb/snapshot | jq -r '.data.name')
sudo tar -czpf "/root/prometheus-${SNAPSHOT}.tar.gz" -C /var/lib/prometheus/snapshots "$SNAPSHOT"
sudo rm -rf "/var/lib/prometheus/snapshots/${SNAPSHOT}"
sudo tar -czpf "/root/prometheus-config-$(date +%F).tar.gz" /etc/prometheus /etc/systemd/system/prometheus.service

Pour restaurer un instantané :

Terminal
sudo systemctl stop prometheus
sudo mv /var/lib/prometheus /var/lib/prometheus.old
sudo mkdir /var/lib/prometheus
sudo tar -xzpf /root/prometheus-NOM_DU_SNAPSHOT.tar.gz --strip-components=1 -C /var/lib/prometheus
sudo chown -R prometheus:prometheus /var/lib/prometheus
sudo systemctl start prometheus

Grafana

Grafana stocke par défaut ses comptes et tableaux de bord dans la base SQLite /var/lib/grafana/grafana.db. Arrêtez le service pendant la copie :

Terminal
sudo systemctl stop grafana-server
sudo tar -czpf "/root/grafana-$(date +%F).tar.gz" /var/lib/grafana /etc/grafana
sudo systemctl start grafana-server

Pour restaurer :

Terminal
sudo systemctl stop grafana-server
sudo tar -xzpf /root/grafana-AAAA-MM-JJ.tar.gz -C /
sudo chown -R grafana:grafana /var/lib/grafana
sudo systemctl start grafana-server

Ces archives contiennent des secrets : limitez leurs droits avec sudo chmod 600 /root/*.tar.gz et copiez-les hors du serveur.

En cas de problème

Prometheus ne démarre pas

Terminal
sudo journalctl -u prometheus -n 50 --no-pager
sudo promtool check config /etc/prometheus/prometheus.yml
sudo ls -ld /var/lib/prometheus

permission denied sur le dossier de données se corrige avec sudo chown -R prometheus:prometheus /var/lib/prometheus. address already in use signifie qu’un autre processus occupe le port 9090 : identifiez-le avec sudo ss -tlnp | grep 9090.

Une cible est à l’état down

Consultez le champ lastError :

Terminal
curl -s http://127.0.0.1:9090/api/v1/targets | jq '.data.activeTargets[] | {job: .labels.job, health, lastError}'

connection refused indique que l’exporter est arrêté ou écoute sur une autre adresse. Un context deadline exceeded vers un autre serveur oriente plutôt vers le pare-feu.

Erreur 502 Bad Gateway sur Grafana

Terminal
sudo systemctl status grafana-server --no-pager
sudo journalctl -u grafana-server -n 50 --no-pager
curl -s http://127.0.0.1:3000/api/health

Boucle de connexion ou message « origin not allowed »

Vérifiez que domain et root_url correspondent exactement à l’adresse utilisée dans le navigateur, et que l’en-tête Host est bien transmis par Nginx. cookie_secure = true impose un accès en HTTPS.

Le tableau de bord n’affiche aucune donnée

  • Vérifiez que les deux cibles sont up.
  • Élargissez la période affichée à quelques heures.
  • Dans le tableau de bord, vérifiez que la source de données, le job et l’instance sélectionnés sont corrects.

Mot de passe administrateur Grafana perdu

Réinitialisez-le depuis le serveur, puis changez-le à nouveau dans l’interface :

Terminal
sudo -u grafana grafana cli --homepath /usr/share/grafana --config /etc/grafana/grafana.ini admin reset-admin-password MOT_DE_PASSE_TEMPORAIRE

Le disque se remplit

Réduisez --storage.tsdb.retention.time, ou ajoutez une limite avec --storage.tsdb.retention.size=10GB, puis exécutez sudo systemctl daemon-reload et sudo systemctl restart prometheus. Le guide Vérifier l’espace disque sous Linux vous aide à localiser ce qui occupe l’espace.

Pour aller plus loin

Si vous cherchez une solution plus simple pour un seul serveur, consultez le guide Superviser son serveur avec Netdata.

Références