Installare Prometheus e Grafana
Installa Prometheus, node_exporter e Grafana senza Docker su Debian o Ubuntu, con dashboard, accesso HTTPS protetto, aggiornamenti e backup.
In questa pagina
I tuoi valori
Inseriscili una volta: i comandi della guida si aggiornano.
Questa guida spiega come installare una piattaforma di monitoraggio completa, senza Docker, su un VPS o un server dedicato con Debian 12/13 o Ubuntu 22.04/24.04.
| Componente | Ruolo | Porta | Ascolto |
|---|---|---|---|
| node_exporter | Espone le metriche del sistema | 9100 | 127.0.0.1 |
| Prometheus | Raccoglie e memorizza le metriche | 9090 | 127.0.0.1 |
| Grafana | Mostra le dashboard | 3000 | 127.0.0.1 |
| Nginx | Pubblica Grafana in HTTPS | 80, 443 | Pubblico |
Solo Grafana viene pubblicato, dietro Nginx, in HTTPS e con un account. Prometheus e node_exporter non sono mai esposti su Internet.
Ordinare un server
Per ospitare il tuo sistema di monitoraggio, HostMyServers offre diverse opzioni:
Prerequisiti
- Un server con Debian 12/13 o Ubuntu 22.04/24.04, con architettura
amd64oarm64 - Un accesso SSH con un utente che dispone di
sudo - Un nome di dominio con un record A:
grafana.tuo-dominio.comdeve puntare all'indirizzo IP del server - Per Grafana, almeno 512 MB di RAM e 1 core CPU secondo la sua documentazione, in aggiunta alle esigenze di Prometheus
- Spazio disco per le metriche: dipende dal numero di serie raccolte e dal periodo di conservazione
Preparare il server
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget tar jq gnupg ufw nginx certbot python3-certbot-nginx apache2-utilsConfigura il firewall. Consenti SSH prima di attivare UFW e sostituisci 22 se usi un'altra porta.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enableLe porte 3000, 9090 e 9100 non devono essere aperte.
Installare Prometheus
Creare l'utente e le cartelle
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/prometheusScaricare e verificare l'archivio
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 verifica deve mostrare OK per l'archivio scaricato.
Configurare la raccolta
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"]Controlla il file:
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.ymlCreare il servizio 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| Opzione | Effetto |
|---|---|
--storage.tsdb.retention.time=30d |
Conserva 30 giorni di metriche (15 giorni per impostazione predefinita) |
--web.listen-address=127.0.0.1:9090 |
Ascolta solo sull'interfaccia locale |
--web.enable-admin-api |
Attiva l'API usata per i backup tramite snapshot |
Avvia il servizio:
sudo systemctl daemon-reload
sudo systemctl enable --now prometheus
sudo systemctl status prometheus --no-pagerInstallare 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 5Verifica che Prometheus raccolga correttamente entrambi i target. Attendi una quindicina di secondi dopo l'avvio:
curl -s http://127.0.0.1:9090/api/v1/targets | jq -r '.data.activeTargets[] | "\(.labels.job) \(.health)"'Il risultato atteso è:
node up
prometheus upInstallare Grafana
Aggiungere il repository ufficiale
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 grafanaLimitare Grafana all'interfaccia locale
L'account iniziale di Grafana è admin / admin. Limita l'ascolto prima del primo avvio:
sudo nano /etc/grafana/grafana.iniNella sezione [server], decommenta o aggiungi:
[server]
http_addr = 127.0.0.1
http_port = 3000Avvia il servizio e verifica che risponda:
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-server
sudo ss -tlnp | grep 3000
curl -s http://127.0.0.1:3000/api/healthCambiare la password dell'amministratore
Cambia la password prima di pubblicare Grafana. Dal tuo computer, apri un tunnel SSH e lascia aperta questa sessione:
ssh -L 3000:127.0.0.1:3000 TUO_USER@IP_DEL_TUO_SERVERApri http://localhost:3000, accedi con admin / admin, poi imposta una password robusta quando Grafana te lo chiede. Puoi quindi chiudere il tunnel.
Dichiarare Prometheus come origine dati
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-serverPubblicare Grafana in HTTPS
Creare il sito 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.tuo-dominio.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.tuo-dominio.com -m admin@tuo-dominio.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-runPer maggiori dettagli sui certificati, consulta la guida Installare un certificato SSL con Let's Encrypt.
Completare la configurazione di Grafana
sudo nano /etc/grafana/grafana.iniAdatta le sezioni seguenti:
[server]
http_addr = 127.0.0.1
http_port = 3000
domain = grafana.tuo-dominio.com
root_url = https://grafana.tuo-dominio.com/
[security]
cookie_secure = true
cookie_samesite = lax
strict_transport_security = true
[users]
allow_sign_up = falsesudo systemctl restart grafana-serverImportare una dashboard
- Apri
https://grafana.tuo-dominio.come accedi. - Clicca su Dashboards nel menu principale.
- Clicca su New, poi su Import dashboard.
- Inserisci l'identificativo
1860(Node Exporter Full) e clicca su Load. - Seleziona l'origine dati Prometheus, poi clicca su Import.
Verificare l'installazione
Sul server, nessun servizio interno deve essere in ascolto su un indirizzo pubblico:
sudo ss -tlnp | grep -E ':(3000|9090|9100)\b'Ogni riga deve iniziare con 127.0.0.1. Dal tuo computer, questi comandi devono fallire:
curl -m 5 http://IP_DEL_TUO_SERVER:3000/
curl -m 5 http://IP_DEL_TUO_SERVER:9090/
curl -m 5 http://IP_DEL_TUO_SERVER:9100/metricsInfine, https://grafana.tuo-dominio.com deve mostrare la pagina di accesso, con un certificato valido.
Per consultare l'interfaccia di Prometheus, passa da un tunnel SSH, poi apri http://localhost:9090:
ssh -L 9090:127.0.0.1:9090 TUO_USER@IP_DEL_TUO_SERVERProteggere Prometheus con una password (facoltativo)
L'ascolto locale impedisce già qualsiasi accesso da Internet. Aggiungi una password se altri utenti o applicazioni hanno accesso al server.
Genera prima l'hash della password:
htpasswd -nBC 12 "" | tr -d ':\n'; echoCrea /etc/prometheus/web.yml con sudo nano, poi incollaci questo hash:
basic_auth_users:
admin: "HASH_BCRYPT"Salva anche la password in chiaro, necessaria a Prometheus per raccogliere le proprie metriche:
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.ymlApplica poi queste tre modifiche:
-
In
prometheus.service, aggiungi--web.config.file=/etc/prometheus/web.ymlal comandoExecStart. -
In
prometheus.yml, completa il jobprometheus:YAML- job_name: prometheus basic_auth: username: admin password_file: /etc/prometheus/web-password static_configs: - targets: ["127.0.0.1:9090"] -
Nell'origine dati di Grafana, aggiungi le credenziali:
YAMLbasicAuth: true basicAuthUser: admin secureJsonData: basicAuthPassword: TUA_PASSWORD_PROMETHEUS
Ricarica la configurazione e riavvia i servizi:
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl daemon-reload
sudo systemctl restart prometheus grafana-serverD'ora in poi aggiungi -u admin ai comandi curl rivolti alla porta 9090.
Monitorare un altro server
Installa node_exporter sul secondo server, con --web.listen-address=0.0.0.0:9100 nel suo servizio. Su questo secondo server, autorizza solo il tuo server Prometheus:
sudo ufw allow from IP_DEL_TUO_SERVER to any port 9100 proto tcpAggiungi poi il target in /etc/prometheus/prometheus.yml, quindi ricarica Prometheus:
- job_name: node
static_configs:
- targets: ["127.0.0.1:9100", "IP_SECONDO_SERVER:9100"]sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl reload prometheusAggiornare
Esegui prima il backup dei dati e leggi le note di rilascio.
Prometheus: ripeti il blocco di download con il nuovo valore di VERSION, poi:
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl restart prometheus
prometheus --versionnode_exporter: ripeti allo stesso modo download e installazione, poi:
sudo systemctl restart node_exporter
node_exporter --versionGrafana: il pacchetto si aggiorna con APT.
sudo apt update
sudo apt install --only-upgrade grafana
sudo systemctl restart grafana-serverEseguire backup e ripristino
Prometheus
La documentazione di Prometheus consiglia gli snapshot:
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.servicePer ripristinare uno snapshot:
sudo systemctl stop prometheus
sudo mv /var/lib/prometheus /var/lib/prometheus.old
sudo mkdir /var/lib/prometheus
sudo tar -xzpf /root/prometheus-NOME_SNAPSHOT.tar.gz --strip-components=1 -C /var/lib/prometheus
sudo chown -R prometheus:prometheus /var/lib/prometheus
sudo systemctl start prometheusGrafana
Per impostazione predefinita, Grafana memorizza account e dashboard nel database SQLite /var/lib/grafana/grafana.db. Ferma il servizio durante la copia:
sudo systemctl stop grafana-server
sudo tar -czpf "/root/grafana-$(date +%F).tar.gz" /var/lib/grafana /etc/grafana
sudo systemctl start grafana-serverPer ripristinare:
sudo systemctl stop grafana-server
sudo tar -xzpf /root/grafana-AAAA-MM-GG.tar.gz -C /
sudo chown -R grafana:grafana /var/lib/grafana
sudo systemctl start grafana-serverQuesti archivi contengono dati sensibili: limita i loro permessi con sudo chmod 600 /root/*.tar.gz e copiali fuori dal server.
In caso di problemi
Prometheus non si avvia
sudo journalctl -u prometheus -n 50 --no-pager
sudo promtool check config /etc/prometheus/prometheus.yml
sudo ls -ld /var/lib/prometheusUn errore permission denied sulla cartella dei dati si risolve con sudo chown -R prometheus:prometheus /var/lib/prometheus. address already in use significa che un altro processo occupa la porta 9090: individualo con sudo ss -tlnp | grep 9090.
Un target è nello stato down
Consulta il campo lastError:
curl -s http://127.0.0.1:9090/api/v1/targets | jq '.data.activeTargets[] | {job: .labels.job, health, lastError}'connection refused indica che l'exporter è fermo o è in ascolto su un altro indirizzo. Un context deadline exceeded verso un altro server fa pensare piuttosto al firewall.
Errore 502 Bad Gateway su 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/healthCiclo di accesso o messaggio « origin not allowed »
Verifica che domain e root_url corrispondano esattamente all'indirizzo usato nel browser e che l'intestazione Host venga trasmessa correttamente da Nginx. cookie_secure = true richiede un accesso in HTTPS.
La dashboard non mostra alcun dato
- Verifica che entrambi i target siano
up. - Allarga il periodo visualizzato a qualche ora.
- Nella dashboard, verifica che l'origine dati, il
jobe l'istanza selezionati siano corretti.
Password dell'amministratore di Grafana persa
Reimpostala dal server, poi cambiala di nuovo nell'interfaccia:
sudo -u grafana grafana cli --homepath /usr/share/grafana --config /etc/grafana/grafana.ini admin reset-admin-password PASSWORD_TEMPORANEAIl disco si riempie
Riduci --storage.tsdb.retention.time, oppure aggiungi un limite con --storage.tsdb.retention.size=10GB, poi esegui sudo systemctl daemon-reload e sudo systemctl restart prometheus. La guida Verificare spazio disco e utilizzo in Linux ti aiuta a individuare ciò che occupa lo spazio.
Per approfondire
Se cerchi una soluzione più semplice per un solo server, consulta la guida Monitorare il tuo server con Netdata.