Documentazione ELX-HealthMonitor — installazione e avvisi

Installazione

Installare

sudo install -m 755 elx-healthmonitor-linux-amd64 /usr/local/bin/elx-healthmonitor
sudo /usr/local/bin/elx-healthmonitor --install-service
sudo systemctl enable --now elx-healthmonitor
# interfaccia web: http://<server>:8555

Consigliato, non obbligatorio

sudo apt-get install -y smartmontools

Percorso	Cos'è
`/usr/local/bin/elx-healthmonitor`	L'eseguibile
`/etc/elx-healthmonitor/config.json`	Impostazioni, permessi 0600
`/var/lib/elx-healthmonitor/history.db`	Storico delle misure e registro degli eventi
`/etc/systemd/system/elx-healthmonitor.service`	L'unità

Opzioni da riga di comando

--config <percorso>    file di configurazione
--listen <indirizzo>   indirizzo dell'interfaccia web, per es. :8555
--log-level <livello>  debug | info | warn | error
--version              versione e data di compilazione

Scegliere cosa raccogliere

La sezione «Impostazioni» decide cosa viene interrogato, con quale frequenza e cosa resta escluso; la sezione «Avvisi» decide quando ne venite informati. Le modifiche hanno effetto subito, senza riavvio. Modificare config.json e riavviare il servizio dà lo stesso risultato.

Cosa escludere per primoI dispositivi loop e virtuali nella sezione dei filesystem. Lasciati lì, riempiono la tabella di voci che nessuno ha mai avuto bisogno di guardare.

Avvisi

Una regola è una condizione, una soglia e un tempo di attesa. Il tempo di attesa è la parte che conta: senza di esso un sistema di monitoraggio segnala ogni picco passeggero, e in una settimana nessuno legge più la sua posta.

Cosa sorvegliare	Una soglia che regge
Filesystem che si riempie	85 per cento — abbastanza preavviso per agire senza fretta
Carico del processore	Sopra il 90 per cento tenuto dieci minuti, non dieci secondi
Temperatura del disco	Sopra i 50 °C in modo continuo; un picco breve durante un salvataggio è normale
SMART	Qualsiasi variazione dei settori rilocati o in sospeso — senza attesa, segnalare subito
RAID	Array degradato, oppure discordanze diverse da zero — sempre
Servizio	Un'unità che dovrebbe girare e non gira

La posta accetta tre modi di cifratura: SMTPS, in cui il TLS parte con il collegamento, di solito sulla porta 465; STARTTLS, in cui viene negoziato, di solito sulla 587; e senza cifratura, che va bene soltanto per un inoltro di posta nella vostra rete.

Storico

raw_retention_days — per quanto le misure restano come sono state rilevate; tre giorni in modo predefinito.
rollup_interval_sec — la dimensione degli intervalli successivi; cinque minuti, con media, minimo e massimo di ciascuno.
retention_days — quando tutto viene cancellato; un mese in modo predefinito.

Il diradamento procede a finestre di sei ore, perché non tenga mai la base abbastanza a lungo da farsi notare.

Perché conservare minimo e massimoUna media da sola nasconde proprio l'evento che cercavate: un disco salito a 60 °C per un minuto dentro un intervallo di cinque si media in qualcosa di insignificante.

Quando qualcosa non va

Sintomo	Dove guardare
L'interfaccia non si apre	`systemctl status elx-healthmonitor` e se la porta è già occupata
La sezione SMART è vuota	smartmontools non è installato, oppure i dischi stanno dietro un controllore che non lascia passare lo SMART
Nessuna temperatura	Una macchina virtuale — non ci sono sensori fisici
La posta non arriva	Il modo di cifratura sbagliato per la porta: 465 è SMTPS, 587 è STARTTLS
Gli avvisi arrivano di continuo	Il tempo di attesa è troppo breve, oppure la soglia sta nell'intervallo normale di quella macchina
Lo storico si interrompe dopo pochi giorni	La conservazione è più breve di quanto crediate, oppure il disco della base è pieno