Monitorare il tuo server con Netdata
Installa Netdata su Debian o Ubuntu, proteggi la dashboard con Nginx, HTTPS e una password, poi ricevi gli avvisi via e-mail.
In questa pagina
I tuoi valori
Inseriscili una volta: i comandi della guida si aggiornano.
Questa guida spiega come installare Netdata su un VPS o un server dedicato con Debian 12/13 o Ubuntu 22.04/24.04. Netdata raccoglie ogni secondo le metriche del sistema (CPU, memoria, dischi, rete, servizi) e le mostra in una dashboard web.
Al termine della guida avrai:
- un agente Netdata installato dal repository ufficiale, sul canale stabile;
- una dashboard raggiungibile solo in HTTPS, dietro Nginx e una password;
- avvisi via e-mail, tra cui un avviso personalizzato;
- una procedura di aggiornamento e di backup.
Ordinare un server
Per monitorare i tuoi servizi, HostMyServers offre diverse opzioni:
Prerequisiti
- Un server con Debian 12/13 o Ubuntu 22.04/24.04
- Un accesso SSH con un utente che dispone di
sudo - Un nome di dominio con un record A:
netdata.tuo-dominio.comdeve puntare all'indirizzo IP del server - Circa 4 GiB di spazio disco libero: con le impostazioni predefinite, Netdata limita le metriche a 3 GiB, a cui si aggiungono i metadati
- Un account SMTP, se vuoi ricevere gli avvisi via e-mail
Porte utilizzate
| Porta | Protocollo | Ruolo | Accesso |
|---|---|---|---|
| 22 | TCP | SSH (o la tua porta personalizzata) | Aperta, da limitare se possibile |
| 80 | TCP | Validazione Let’s Encrypt e reindirizzamento a HTTPS | Aperta |
| 443 | TCP | Dashboard tramite Nginx | Aperta |
| 19999 | TCP | Agente Netdata | Solo locale (127.0.0.1) |
Preparare il server
Aggiorna il sistema e installa gli strumenti necessari:
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl ufw nginx apache2-utils certbot python3-certbot-nginxConfigurare il firewall
Consenti SSH prima di attivare UFW, altrimenti rischi di perdere l'accesso al server. Se usi un'altra porta SSH, sostituisci 22 con quella porta.
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 verboseLa porta 19999 non compare in queste regole, quindi resta chiusa dall'esterno. Per approfondire, consulta la guida Proteggi il tuo server.
Installare Netdata
Scarica lo script ufficiale, poi eseguilo con il canale stable. Senza questa opzione, lo script propone il canale nightly, che riceve versioni di sviluppo.
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh --release-channel=stable --disable-telemetryLo script rileva la tua distribuzione, aggiunge il repository Netdata e installa i pacchetti nativi. Chiede una conferma e usa sudo quando serve. L'opzione --disable-telemetry disattiva l'invio di statistiche anonime.
Verifica poi il servizio e il tipo di installazione:
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 5Il servizio deve essere active (running), il tipo di installazione binpkg-deb e l'ultimo comando deve restituire del JSON.
Limitare Netdata all'interfaccia locale
Apri la configurazione con lo strumento fornito da Netdata:
cd /etc/netdata
sudo ./edit-config netdata.confNella sezione [web], aggiungi o modifica la riga bind to:
[web]
bind to = 127.0.0.1Riavvia l'agente e controlla l'indirizzo di ascolto:
sudo systemctl restart netdata
sudo ss -tlnp | grep 19999L'output deve indicare 127.0.0.1:19999, e non 0.0.0.0:19999 o *:19999.
Pubblicare la dashboard con Nginx
Creare la password
Crea un file di credenziali. Il comando ti chiede di scegliere una password per l'utente admin:
sudo htpasswd -c /etc/nginx/.htpasswd-netdata admin
sudo chown root:www-data /etc/nginx/.htpasswd-netdata
sudo chmod 640 /etc/nginx/.htpasswd-netdataCreare il sito Nginx
sudo nano /etc/nginx/sites-available/netdata.confIncolla la configurazione seguente, adattando il dominio:
upstream netdata_backend {
server 127.0.0.1:19999;
keepalive 64;
}
server {
listen 80;
listen [::]:80;
server_name netdata.tuo-dominio.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;
}
}Attiva il sito e ricarica Nginx:
sudo ln -s /etc/nginx/sites-available/netdata.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxAttivare HTTPS
Richiedi un certificato Let's Encrypt e attiva il reindirizzamento a HTTPS:
sudo certbot --nginx -d netdata.tuo-dominio.com -m admin@tuo-dominio.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-runPer maggiori dettagli, consulta la guida Installare un certificato SSL con Let's Encrypt.
Verificare l'accesso
Dal tuo computer, esegui questi tre test:
curl -s -o /dev/null -w '%{http_code}\n' https://netdata.tuo-dominio.com/
curl -s -o /dev/null -w '%{http_code}\n' -u admin https://netdata.tuo-dominio.com/
curl -m 5 http://IP_DEL_TUO_SERVER:19999/| Test | Risultato atteso |
|---|---|
| Senza credenziali | 401 |
| Con credenziali | 200 |
| Accesso diretto alla porta 19999 | Connessione non riuscita o timeout |
Apri poi https://netdata.tuo-dominio.com nel browser e accedi. Se l'interfaccia ti propone di collegare l'agente a Netdata Cloud, questo passaggio è facoltativo: la dashboard locale funziona senza account.
Configurare gli avvisi
Netdata include numerosi avvisi già pronti (disco, memoria, CPU, rete e così via). Per visualizzare tutti quelli caricati:
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | head -n 30Abilitare l'invio di e-mail
Netdata invia le e-mail con il comando sendmail. Il pacchetto msmtp-mta lo fornisce e inoltra i messaggi al tuo server SMTP:
sudo apt install -y msmtp msmtp-mta
sudo nano /etc/msmtprcSe l'installazione pone una domanda su AppArmor, mantieni la scelta predefinita. Inserisci poi il tuo account SMTP:
defaults
auth on
tls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
syslog on
account alertes
host smtp.tuo-dominio.com
port 587
from netdata@tuo-dominio.com
user netdata@tuo-dominio.com
password TUA_PASSWORD_SMTP
account default : alertesQuesto file contiene una password: solo root deve poterlo modificare e solo il gruppo netdata deve poterlo leggere.
sudo chown root:netdata /etc/msmtprc
sudo chmod 640 /etc/msmtprc
printf 'Subject: Test msmtp\n\nMessaggio di prova.\n' | sudo -u netdata msmtp alertes@tuo-dominio.comScegliere il destinatario
cd /etc/netdata
sudo ./edit-config health_alarm_notify.confModifica queste tre variabili:
EMAIL_SENDER="netdata@tuo-dominio.com"
SEND_EMAIL="YES"
DEFAULT_RECIPIENT_EMAIL="alertes@tuo-dominio.com"La modifica si applica a partire dal prossimo avviso. Invia una notifica di prova:
sudo su -s /bin/bash netdata
export NETDATA_ALARM_NOTIFY_DEBUG=1
/usr/libexec/netdata/plugins.d/alarm-notify.sh test
exitDevi ricevere tre messaggi di prova, corrispondenti agli stati WARNING, CRITICAL e CLEAR.
Aggiungere un avviso personalizzato
Crea un file nella cartella degli avvisi:
sudo nano /etc/netdata/health.d/cpu-15min.confQuesto esempio monitora l'utilizzo medio della CPU su 15 minuti:
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 elevata su 15 minuti
info: Utilizzo medio della CPU negli ultimi 15 minuti
to: sysadminRicarica gli avvisi, senza riavviare l'agente, poi verifica che il tuo sia stato caricato:
sudo netdatacli reload-health
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | grep cpu_usage_15minAggiornare Netdata
Lo script di installazione attiva per impostazione predefinita un aggiornamento automatico giornaliero. Per verificarne la pianificazione:
systemctl list-timers netdata-updater.timer --no-pagerA seconda del sistema, la pianificazione può passare anche da cron se il timer systemd non è utilizzato. Per avviare un aggiornamento manualmente, esegui di nuovo lo script ufficiale:
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.shPer disattivare gli aggiornamenti automatici:
sudo /usr/libexec/netdata/netdata-updater.sh --disable-auto-updatesEseguire backup e ripristino
| Dati | Posizione |
|---|---|
| Configurazione | /etc/netdata |
| Metriche | /var/cache/netdata |
| Identità dell'agente ed eventuale token | /var/lib/netdata |
Ferma l'agente durante la copia delle metriche, per ottenere un backup coerente:
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.gzCopia poi l'archivio fuori dal server. Salva anche /etc/msmtprc e i file Nginx se vuoi ricostruire l'intero ambiente in modo identico.
Per ripristinare, reinstalla Netdata se necessario, poi:
sudo systemctl stop netdata
sudo rm -rf /var/cache/netdata
sudo tar -xzpf /root/netdata-AAAA-MM-GG.tar.gz -C /
sudo systemctl start netdataIn caso di problemi
Errore 502 Bad Gateway
Nginx non riesce a raggiungere l'agente.
sudo systemctl status netdata --no-pager
sudo ss -tlnp | grep 19999
sudo tail -n 30 /var/log/nginx/error.logVerifica che l'agente sia in esecuzione e che bind to corrisponda all'indirizzo dell'upstream, qui 127.0.0.1.
Il browser richiede continuamente la password
Controlla i permessi del file e l'identificativo:
sudo ls -l /etc/nginx/.htpasswd-netdata
sudo htpasswd -v /etc/nginx/.htpasswd-netdata adminIl file deve essere leggibile dal gruppo www-data. Un errore Permission denied in /var/log/nginx/error.log conferma un problema di permessi.
La porta 19999 risponde da Internet
Verifica che la sezione [web] si trovi in /etc/netdata/netdata.conf, riavvia l'agente, poi controlla sudo ss -tlnp | grep 19999 e sudo ufw status verbose.
Certbot non riesce
Verifica che il dominio punti al server con getent hosts netdata.tuo-dominio.com, che la porta 80 sia aperta e che sudo nginx -t non segnali errori.
Le e-mail non arrivano
- Ripeti il test
alarm-notify.sh teste leggi il suo output dettagliato. - Consulta i log di msmtp con
sudo journalctl -t msmtp -n 30 --no-pager. - Se
command -v sendmailnon restituisce nulla, il pacchettomsmtp-mtanon è installato. - Un errore
Permission deniedsu/etc/msmtprcindica un problema di permessi su quel file. - Se la connessione SMTP va in timeout, prova un'altra porta indicata dal tuo provider di posta. Per sapere se si applica un filtro al tuo servizio, contatta il supporto dall'area clienti.
Netdata occupa troppo spazio disco
Controlla l'occupazione reale, poi riduci la retention nella sezione [db] di 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 = 500MiBRiavvia poi l'agente con sudo systemctl restart netdata.
Per approfondire
Per conservare le metriche di più server e creare le tue dashboard, consulta la guida Installare Prometheus e Grafana.