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.
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
amd64ouarm64 - Un accès SSH avec un utilisateur disposant de
sudo - Un nom de domaine avec un enregistrement A :
grafana.votre-domaine.comdoit 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
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget tar jq gnupg ufw nginx certbot python3-certbot-nginx apache2-utilsConfigurez le pare-feu. Autorisez SSH avant d’activer UFW, et remplacez 22 si vous utilisez un autre port.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enableLes ports 3000, 9090 et 9100 ne doivent pas être ouverts.
Installer Prometheus
Créer l’utilisateur et les dossiers
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/prometheusTélécharger et vérifier l’archive
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 --versionLa vérification doit afficher OK pour l’archive téléchargée.
Configurer la collecte
sudo nano /etc/prometheus/prometheus.ymlglobal:
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 :
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.ymlCréer le service systemd
sudo nano /etc/systemd/system/prometheus.service[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 :
sudo systemctl daemon-reload
sudo systemctl enable --now prometheus
sudo systemctl status prometheus --no-pagerInstaller node_exporter
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[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.targetsudo systemctl daemon-reload
sudo systemctl enable --now node_exporter
curl -s http://127.0.0.1:9100/metrics | head -n 5Vérifiez que Prometheus collecte bien les deux cibles. Attendez une quinzaine de secondes après le démarrage :
curl -s http://127.0.0.1:9090/api/v1/targets | jq -r '.data.activeTargets[] | "\(.labels.job) \(.health)"'Le résultat attendu est :
node up
prometheus upInstaller Grafana
Ajouter le dépôt officiel
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 grafanaLimiter Grafana à l’interface locale
Le compte initial de Grafana est admin / admin. Limitez l’écoute avant le premier démarrage :
sudo nano /etc/grafana/grafana.iniDans la section [server], décommentez ou ajoutez :
[server]
http_addr = 127.0.0.1
http_port = 3000Démarrez le service et vérifiez qu’il répond :
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-server
sudo ss -tlnp | grep 3000
curl -s http://127.0.0.1:3000/api/healthChanger 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 :
ssh -L 3000:127.0.0.1:3000 VOTRE_USER@IP_SERVEUROuvrez 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
sudo nano /etc/grafana/provisioning/datasources/prometheus.yamlapiVersion: 1
datasources:
- name: Prometheus
type: prometheus
access: proxy
url: http://127.0.0.1:9090
isDefault: true
editable: falsesudo chown root:grafana /etc/grafana/provisioning/datasources/prometheus.yaml
sudo chmod 640 /etc/grafana/provisioning/datasources/prometheus.yaml
sudo systemctl restart grafana-serverPublier Grafana en HTTPS
Créer le site Nginx
sudo nano /etc/nginx/sites-available/grafana.confmap $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;
}
}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-runPour plus de détails sur les certificats, consultez le guide Installer un certificat SSL avec Let’s Encrypt.
Finaliser la configuration de Grafana
sudo nano /etc/grafana/grafana.iniAdaptez les sections suivantes :
[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 = falsesudo systemctl restart grafana-serverImporter un tableau de bord
- Ouvrez
https://grafana.votre-domaine.comet connectez-vous. - Cliquez sur Dashboards dans le menu principal.
- Cliquez sur New, puis sur Import dashboard.
- Saisissez l’identifiant
1860(Node Exporter Full) et cliquez sur Load. - 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 :
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 :
curl -m 5 http://IP_SERVEUR:3000/
curl -m 5 http://IP_SERVEUR:9090/
curl -m 5 http://IP_SERVEUR:9100/metricsEnfin, 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 :
ssh -L 9090:127.0.0.1:9090 VOTRE_USER@IP_SERVEURProté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 :
htpasswd -nBC 12 "" | tr -d ':\n'; echoCréez /etc/prometheus/web.yml avec sudo nano, puis collez-y ce hachage :
basic_auth_users:
admin: "HACHAGE_BCRYPT"Enregistrez aussi le mot de passe en clair, nécessaire à Prometheus pour collecter ses propres métriques :
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.ymlAppliquez ensuite ces trois modifications :
-
Dans
prometheus.service, ajoutez--web.config.file=/etc/prometheus/web.ymlà la commandeExecStart. -
Dans
prometheus.yml, complétez le jobprometheus:YAML- job_name: prometheus basic_auth: username: admin password_file: /etc/prometheus/web-password static_configs: - targets: ["127.0.0.1:9090"] -
Dans la source de données Grafana, ajoutez les identifiants :
YAMLbasicAuth: true basicAuthUser: admin secureJsonData: basicAuthPassword: VOTRE_MOT_DE_PASSE_PROMETHEUS
Rechargez la configuration et redémarrez les services :
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl daemon-reload
sudo systemctl restart prometheus grafana-serverAjoutez 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 :
sudo ufw allow from IP_SERVEUR to any port 9100 proto tcpAjoutez ensuite la cible dans /etc/prometheus/prometheus.yml, puis rechargez Prometheus :
- job_name: node
static_configs:
- targets: ["127.0.0.1:9100", "IP_SECOND_SERVEUR:9100"]sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl reload prometheusMettre à 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 :
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl restart prometheus
prometheus --versionnode_exporter : reprenez de même son téléchargement et son installation, puis :
sudo systemctl restart node_exporter
node_exporter --versionGrafana : le paquet se met à jour avec APT.
sudo apt update
sudo apt install --only-upgrade grafana
sudo systemctl restart grafana-serverSauvegarder et restaurer
Prometheus
La documentation de Prometheus recommande les instantanés (snapshots) :
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.servicePour restaurer un instantané :
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 prometheusGrafana
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 :
sudo systemctl stop grafana-server
sudo tar -czpf "/root/grafana-$(date +%F).tar.gz" /var/lib/grafana /etc/grafana
sudo systemctl start grafana-serverPour restaurer :
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-serverCes 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
sudo journalctl -u prometheus -n 50 --no-pager
sudo promtool check config /etc/prometheus/prometheus.yml
sudo ls -ld /var/lib/prometheuspermission 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 :
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
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/healthBoucle 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
jobet 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 :
sudo -u grafana grafana cli --homepath /usr/share/grafana --config /etc/grafana/grafana.ini admin reset-admin-password MOT_DE_PASSE_TEMPORAIRELe 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.