Superviser son serveur avec Netdata
Installez Netdata sur Debian ou Ubuntu, protégez le tableau de bord avec Nginx, HTTPS et un mot de passe, puis recevez des alertes par e-mail.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Ce guide vous explique comment installer Netdata sur un VPS ou un serveur dédié sous Debian 12/13 ou Ubuntu 22.04/24.04. Netdata collecte chaque seconde les métriques du système (CPU, mémoire, disques, réseau, services) et les affiche dans un tableau de bord web.
À la fin du guide, vous disposerez :
- d’un agent Netdata installé depuis le dépôt officiel, sur le canal stable ;
- d’un tableau de bord accessible uniquement en HTTPS, derrière Nginx et un mot de passe ;
- d’alertes par e-mail, dont une alerte personnalisée ;
- d’une procédure de mise à jour et de sauvegarde.
Commander un serveur
Pour superviser vos services, HostMyServers propose plusieurs offres :
Prérequis
- Un serveur sous Debian 12/13 ou Ubuntu 22.04/24.04
- Un accès SSH avec un utilisateur disposant de
sudo - Un nom de domaine avec un enregistrement A :
netdata.votre-domaine.comdoit pointer vers l’adresse IP du serveur - Environ 4 Gio d’espace disque libre : avec ses réglages par défaut, Netdata limite ses métriques à 3 Gio, auxquels s’ajoutent ses métadonnées
- Un compte SMTP si vous voulez recevoir les alertes par e-mail
Ports utilisés
| Port | Protocole | Rôle | Accès |
|---|---|---|---|
| 22 | TCP | SSH (ou votre port personnalisé) | Ouvert, à restreindre si possible |
| 80 | TCP | Validation Let’s Encrypt et redirection vers HTTPS | Ouvert |
| 443 | TCP | Tableau de bord via Nginx | Ouvert |
| 19999 | TCP | Agent Netdata | Local uniquement (127.0.0.1) |
Préparer le serveur
Mettez le système à jour et installez les outils nécessaires :
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl ufw nginx apache2-utils certbot python3-certbot-nginxConfigurer le pare-feu
Autorisez SSH avant d’activer UFW, sous peine de perdre l’accès au serveur. Si vous utilisez un autre port SSH, remplacez 22 par ce port.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enable
sudo ufw status verboseLe port 19999 n’apparaît pas dans ces règles : il reste donc fermé depuis l’extérieur. Pour aller plus loin, consultez le guide Sécuriser son serveur.
Installer Netdata
Téléchargez le script officiel, puis lancez-le avec le canal stable. Sans cette option, le script propose le canal nightly, qui reçoit des versions de développement.
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh --release-channel=stable --disable-telemetryLe script détecte votre distribution, ajoute le dépôt Netdata et installe les paquets natifs. Il demande une confirmation et utilise sudo lorsque c’est nécessaire. L’option --disable-telemetry désactive l’envoi de statistiques anonymes.
Vérifiez ensuite le service et le type d’installation :
sudo systemctl status netdata --no-pager
sudo netdata -W buildinfo | grep -E 'Installation Type|Install type:'
curl -s http://127.0.0.1:19999/api/v1/info | head -n 5Le service doit être active (running), le type d’installation binpkg-deb, et la dernière commande doit renvoyer du JSON.
Limiter Netdata à l’interface locale
Ouvrez la configuration avec l’outil fourni par Netdata :
cd /etc/netdata
sudo ./edit-config netdata.confDans la section [web], ajoutez ou modifiez la ligne bind to :
[web]
bind to = 127.0.0.1Redémarrez l’agent et contrôlez l’adresse d’écoute :
sudo systemctl restart netdata
sudo ss -tlnp | grep 19999La sortie doit indiquer 127.0.0.1:19999, et non 0.0.0.0:19999 ou *:19999.
Publier le tableau de bord avec Nginx
Créer le mot de passe
Créez un fichier d’identifiants. La commande vous demande de choisir un mot de passe pour l’utilisateur admin :
sudo htpasswd -c /etc/nginx/.htpasswd-netdata admin
sudo chown root:www-data /etc/nginx/.htpasswd-netdata
sudo chmod 640 /etc/nginx/.htpasswd-netdataCréer le site Nginx
sudo nano /etc/nginx/sites-available/netdata.confCollez la configuration suivante en adaptant le domaine :
upstream netdata_backend {
server 127.0.0.1:19999;
keepalive 64;
}
server {
listen 80;
listen [::]:80;
server_name netdata.votre-domaine.com;
location / {
auth_basic "Netdata";
auth_basic_user_file /etc/nginx/.htpasswd-netdata;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Server $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://netdata_backend;
proxy_http_version 1.1;
proxy_pass_request_headers on;
proxy_set_header Connection "keep-alive";
proxy_store off;
}
}Activez le site et rechargez Nginx :
sudo ln -s /etc/nginx/sites-available/netdata.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxActiver HTTPS
Demandez un certificat Let’s Encrypt et activez la redirection vers HTTPS :
sudo certbot --nginx -d netdata.votre-domaine.com -m admin@votre-domaine.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-runPour plus de détails, consultez le guide Installer un certificat SSL avec Let’s Encrypt.
Vérifier l’accès
Depuis votre poste, lancez ces trois tests :
curl -s -o /dev/null -w '%{http_code}\n' https://netdata.votre-domaine.com/
curl -s -o /dev/null -w '%{http_code}\n' -u admin https://netdata.votre-domaine.com/
curl -m 5 http://IP_SERVEUR:19999/| Test | Résultat attendu |
|---|---|
| Sans identifiants | 401 |
| Avec identifiants | 200 |
| Accès direct au port 19999 | Échec de connexion ou délai dépassé |
Ouvrez ensuite https://netdata.votre-domaine.com dans votre navigateur et connectez-vous. Si l’interface vous propose de relier l’agent à Netdata Cloud, cette étape est facultative : le tableau de bord local fonctionne sans compte.
Configurer les alertes
Netdata est livré avec de nombreuses alertes prêtes à l’emploi (disque, mémoire, CPU, réseau, etc.). Pour afficher toutes celles qui sont chargées :
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | head -n 30Permettre l’envoi d’e-mails
Netdata envoie ses e-mails avec la commande sendmail. Le paquet msmtp-mta la fournit et transmet les messages à votre serveur SMTP :
sudo apt install -y msmtp msmtp-mta
sudo nano /etc/msmtprcSi l’installation pose une question sur AppArmor, conservez le choix par défaut. Renseignez ensuite votre compte SMTP :
defaults
auth on
tls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
syslog on
account alertes
host smtp.votre-domaine.com
port 587
from netdata@votre-domaine.com
user netdata@votre-domaine.com
password VOTRE_MOT_DE_PASSE_SMTP
account default : alertesCe fichier contient un mot de passe : seul root doit pouvoir le modifier, et seul le groupe netdata doit pouvoir le lire.
sudo chown root:netdata /etc/msmtprc
sudo chmod 640 /etc/msmtprc
printf 'Subject: Test msmtp\n\nMessage de test.\n' | sudo -u netdata msmtp alertes@votre-domaine.comChoisir le destinataire
cd /etc/netdata
sudo ./edit-config health_alarm_notify.confModifiez ces trois variables :
EMAIL_SENDER="netdata@votre-domaine.com"
SEND_EMAIL="YES"
DEFAULT_RECIPIENT_EMAIL="alertes@votre-domaine.com"La modification s’applique dès la prochaine alerte. Envoyez une notification de test :
sudo su -s /bin/bash netdata
export NETDATA_ALARM_NOTIFY_DEBUG=1
/usr/libexec/netdata/plugins.d/alarm-notify.sh test
exitVous devez recevoir trois messages de test, correspondant aux états WARNING, CRITICAL et CLEAR.
Ajouter une alerte personnalisée
Créez un fichier dans le dossier des alertes :
sudo nano /etc/netdata/health.d/cpu-15min.confCet exemple surveille l’utilisation moyenne du CPU sur 15 minutes :
alarm: cpu_usage_15min
on: system.cpu
lookup: average -15m unaligned of user,system,softirq,irq,guest
units: %
every: 1m
warn: $this > 80
crit: $this > 95
delay: down 15m multiplier 1.5 max 1h
summary: CPU élevé sur 15 minutes
info: Utilisation moyenne du CPU sur les 15 dernières minutes
to: sysadminRechargez les alertes, sans redémarrer l’agent, puis vérifiez que la vôtre est bien chargée :
sudo netdatacli reload-health
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | grep cpu_usage_15minMettre à jour Netdata
Le script d’installation active par défaut une mise à jour automatique quotidienne. Pour vérifier sa planification :
systemctl list-timers netdata-updater.timer --no-pagerSelon le système, la planification peut aussi passer par cron si le minuteur systemd n’est pas utilisé. Pour lancer une mise à jour manuellement, relancez le script officiel :
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.shPour désactiver les mises à jour automatiques :
sudo /usr/libexec/netdata/netdata-updater.sh --disable-auto-updatesSauvegarder et restaurer
| Données | Emplacement |
|---|---|
| Configuration | /etc/netdata |
| Métriques | /var/cache/netdata |
| Identité de l’agent et jeton éventuel | /var/lib/netdata |
Arrêtez l’agent pendant la copie des métriques, afin d’obtenir une sauvegarde cohérente :
sudo systemctl stop netdata
sudo tar -czpf "/root/netdata-$(date +%F).tar.gz" /etc/netdata /var/cache/netdata /var/lib/netdata
sudo systemctl start netdata
sudo chmod 600 /root/netdata-*.tar.gzCopiez ensuite l’archive hors du serveur. Sauvegardez aussi /etc/msmtprc et les fichiers Nginx si vous voulez reconstruire l’ensemble à l’identique.
Pour restaurer, réinstallez Netdata si nécessaire, puis :
sudo systemctl stop netdata
sudo rm -rf /var/cache/netdata
sudo tar -xzpf /root/netdata-AAAA-MM-JJ.tar.gz -C /
sudo systemctl start netdataEn cas de problème
Erreur 502 Bad Gateway
Nginx n’arrive pas à joindre l’agent.
sudo systemctl status netdata --no-pager
sudo ss -tlnp | grep 19999
sudo tail -n 30 /var/log/nginx/error.logVérifiez que l’agent tourne et que bind to correspond bien à l’adresse de l’upstream, ici 127.0.0.1.
Le navigateur redemande sans cesse le mot de passe
Contrôlez les droits du fichier et l’identifiant :
sudo ls -l /etc/nginx/.htpasswd-netdata
sudo htpasswd -v /etc/nginx/.htpasswd-netdata adminLe fichier doit être lisible par le groupe www-data. Une erreur Permission denied dans /var/log/nginx/error.log confirme un problème de droits.
Le port 19999 répond depuis Internet
Vérifiez que la section [web] se trouve bien dans /etc/netdata/netdata.conf, redémarrez l’agent, puis contrôlez sudo ss -tlnp | grep 19999 et sudo ufw status verbose.
Certbot échoue
Vérifiez que le domaine pointe vers le serveur avec getent hosts netdata.votre-domaine.com, que le port 80 est ouvert et que sudo nginx -t ne signale aucune erreur.
Les e-mails n’arrivent pas
- Relancez le test
alarm-notify.sh testet lisez sa sortie détaillée. - Consultez les journaux de msmtp avec
sudo journalctl -t msmtp -n 30 --no-pager. - Si
command -v sendmailne renvoie rien, le paquetmsmtp-mtan’est pas installé. - Une erreur
Permission deniedsur/etc/msmtprcindique un problème de droits sur ce fichier. - Si la connexion SMTP expire, testez un autre port indiqué par votre fournisseur de messagerie. Pour savoir si un filtrage s’applique à votre service, contactez le support depuis votre espace client.
Netdata occupe trop d’espace disque
Contrôlez l’occupation réelle, puis réduisez la rétention dans la section [db] de netdata.conf :
sudo du -sh /var/cache/netdata
cd /etc/netdata
sudo ./edit-config netdata.conf[db]
dbengine tier 0 retention size = 500MiB
dbengine tier 1 retention size = 500MiB
dbengine tier 2 retention size = 500MiBRedémarrez ensuite l’agent avec sudo systemctl restart netdata.
Pour aller plus loin
Pour conserver des métriques de plusieurs serveurs et créer vos propres tableaux de bord, consultez le guide Installer Prometheus et Grafana.