IT

Applicazioni

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.

7 min di lettura, aggiornato il 18 novembre 2026

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.com deve 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:

Terminale
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl ufw nginx apache2-utils certbot python3-certbot-nginx

Configurare 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.

Terminale
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 verbose

La 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.

Terminale
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh --release-channel=stable --disable-telemetry

Lo 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:

Terminale
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 5

Il 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:

Terminale
cd /etc/netdata
sudo ./edit-config netdata.conf

Nella sezione [web], aggiungi o modifica la riga bind to:

Configurazione
[web]
    bind to = 127.0.0.1

Riavvia l'agente e controlla l'indirizzo di ascolto:

Terminale
sudo systemctl restart netdata
sudo ss -tlnp | grep 19999

L'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:

Terminale
sudo htpasswd -c /etc/nginx/.htpasswd-netdata admin
sudo chown root:www-data /etc/nginx/.htpasswd-netdata
sudo chmod 640 /etc/nginx/.htpasswd-netdata

Creare il sito Nginx

Terminale
sudo nano /etc/nginx/sites-available/netdata.conf

Incolla la configurazione seguente, adattando il dominio:

Nginx
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:

Terminale
sudo ln -s /etc/nginx/sites-available/netdata.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Attivare HTTPS

Richiedi un certificato Let's Encrypt e attiva il reindirizzamento a HTTPS:

Terminale
sudo certbot --nginx -d netdata.tuo-dominio.com -m admin@tuo-dominio.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-run

Per maggiori dettagli, consulta la guida Installare un certificato SSL con Let's Encrypt.

Verificare l'accesso

Dal tuo computer, esegui questi tre test:

Terminale
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:

Terminale
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | head -n 30

Abilitare 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:

Terminale
sudo apt install -y msmtp msmtp-mta
sudo nano /etc/msmtprc

Se l'installazione pone una domanda su AppArmor, mantieni la scelta predefinita. Inserisci poi il tuo account SMTP:

Testo
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 : alertes

Questo file contiene una password: solo root deve poterlo modificare e solo il gruppo netdata deve poterlo leggere.

Terminale
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.com

Scegliere il destinatario

Terminale
cd /etc/netdata
sudo ./edit-config health_alarm_notify.conf

Modifica queste tre variabili:

Terminale
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:

Terminale
sudo su -s /bin/bash netdata
export NETDATA_ALARM_NOTIFY_DEBUG=1
/usr/libexec/netdata/plugins.d/alarm-notify.sh test
exit

Devi ricevere tre messaggi di prova, corrispondenti agli stati WARNING, CRITICAL e CLEAR.

Aggiungere un avviso personalizzato

Crea un file nella cartella degli avvisi:

Terminale
sudo nano /etc/netdata/health.d/cpu-15min.conf

Questo esempio monitora l'utilizzo medio della CPU su 15 minuti:

Testo
    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: sysadmin

Ricarica gli avvisi, senza riavviare l'agente, poi verifica che il tuo sia stato caricato:

Terminale
sudo netdatacli reload-health
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | grep cpu_usage_15min

Aggiornare Netdata

Lo script di installazione attiva per impostazione predefinita un aggiornamento automatico giornaliero. Per verificarne la pianificazione:

Terminale
systemctl list-timers netdata-updater.timer --no-pager

A 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:

Terminale
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh

Per disattivare gli aggiornamenti automatici:

Terminale
sudo /usr/libexec/netdata/netdata-updater.sh --disable-auto-updates

Eseguire 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:

Terminale
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.gz

Copia 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:

Terminale
sudo systemctl stop netdata
sudo rm -rf /var/cache/netdata
sudo tar -xzpf /root/netdata-AAAA-MM-GG.tar.gz -C /
sudo systemctl start netdata

In caso di problemi

Errore 502 Bad Gateway

Nginx non riesce a raggiungere l'agente.

Terminale
sudo systemctl status netdata --no-pager
sudo ss -tlnp | grep 19999
sudo tail -n 30 /var/log/nginx/error.log

Verifica 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:

Terminale
sudo ls -l /etc/nginx/.htpasswd-netdata
sudo htpasswd -v /etc/nginx/.htpasswd-netdata admin

Il 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 test e leggi il suo output dettagliato.
  • Consulta i log di msmtp con sudo journalctl -t msmtp -n 30 --no-pager.
  • Se command -v sendmail non restituisce nulla, il pacchetto msmtp-mta non è installato.
  • Un errore Permission denied su /etc/msmtprc indica 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:

Terminale
sudo du -sh /var/cache/netdata
cd /etc/netdata
sudo ./edit-config netdata.conf
Configurazione
[db]
    dbengine tier 0 retention size = 500MiB
    dbengine tier 1 retention size = 500MiB
    dbengine tier 2 retention size = 500MiB

Riavvia 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.

Riferimenti