 |
This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved. |
1. Nozioni di base sulle notifiche
In Checkmk, la notifica consiste nell'avvisare attivamente gli utenti quando cambia lo stato di un host o di un servizio.
Supponiamo che, in un determinato momento, sull'host mywebsrv17 il servizio HTTP foo.bar passi da OK a CRIT.
Checkmk lo rileva e, per impostazione predefinita, invia un'e-mail contenente i dati più importanti relativi a questo evento a tutti i contatti di questo servizio.
Lo stato cambia nuovamente in seguito, passando da CRIT a OK, e i contatti ricevono un'altra e-mail, questa volta per effettuare una segnalazione di recupero.
Ma questo è solo il modo più semplice per inviare una notifica. Ci sono numerosi modi per perfezionarlo:
Puoi inviare notifiche tramite SMS, cercapersone, Slack e altri servizi internet.
Puoi limitare le notifiche a periodi di tempo specifici, ad esempio per tenere conto dei turni di reperibilità.
Puoi definire delle escalation se il contatto responsabile non interviene abbastanza rapidamente.
Gli utenti possono "iscriversi" o "cancellarsi" autonomamente dalle notifiche, se lo desideri.
In generale, puoi definire regole su chi deve essere avvisato, su cosa e quando.
Tuttavia, prima di iniziare a lavorare con le notifiche, dovresti tenere presente quanto segue:
La notifica è una funzione opzionale. Alcuni utenti rinunciano alle notifiche perché dispongono di un centro di controllo attivo 24 ore su 24 che opera esclusivamente con l'interfaccia di stato.
Inizialmente attiva le notifiche solo per te stesso e assumiti la responsabilità di tutto. Osserva per almeno alcuni giorni quanto è elevato il numero di notifiche.
Non attivare le notifiche per gli altri utenti finché non avrai ridotto al minimo i falsi allarmi (falsi positivi). Abbiamo descritto come farlo nel capitolo dedicato alla regolazione del monitoraggio.
2. Prepararsi alle notifiche via e-mail
Il metodo più semplice e di gran lunga più comune è inviare una notifica via e-mail. In un'e-mail c'è spazio a sufficienza per includere anche i grafici delle metriche.
Prima di poter inviare notifiche via e-mail, il tuo server Checkmk deve essere configurato per l'invio di e-mail. Per tutte le distribuzioni Linux supportate, questo si riduce a quanto segue:
Installa un server SMTP. Di solito questo viene fatto automaticamente durante l'installazione della distribuzione.
Specifica uno smarthost. Di solito ti verrà richiesto durante l'installazione del server SMTP. Lo smarthost è un server di posta nella tua azienda che si occupa della consegna delle e-mail per Checkmk. Le aziende molto piccole di solito non dispongono di uno smarthost proprio. In questo caso, utilizza il server SMTP fornito dal tuo provider di posta elettronica.
Se l'invio della posta è stato configurato correttamente, dovresti essere in grado di inviare un'e-mail dalla riga di comando, ad esempio tramite questo comando:
L'e-mail dovrebbe essere recapitata senza ritardi.
Se questo non funziona, troverai indizi sulla causa del problema nel file di log del server SMTP nella directory /var/log/.
Maggiori dettagli sulla configurazione della consegna della posta in Linux sono disponibili nell'articolo sulle regole di notifica.
3. Attivazione delle notifiche via e-mail
Una volta che l'invio delle e-mail funziona correttamente, attivare le notifiche è semplicissimo. Affinché un utente possa ricevere le notifiche via e-mail, devono essere soddisfatte le seguenti condizioni:
All'utente è stato assegnato un indirizzo e-mail.
L'utente è responsabile di host o servizi, tramite l'assegnazione di gruppi di contatto.
Esiste una regola di notifica che garantisce che i membri dei gruppi di contatto ricevano le notifiche via e-mail.
L'assegnazione dell'indirizzo e-mail e dei gruppi di contatto avviene tramite le proprietà dell'utente, come abbiamo mostrato in precedenza nel capitolo sull'amministrazione degli utenti. Puoi farlo, ad esempio, aggiungendo il tuo indirizzo e-mail e il gruppo di contatto Everything all'account utente denominato cmkadmin. Checkmk dispone già di una regola di notifica preconfigurata che avvisa ogni contatto per gli host e i servizi in merito a importanti cambiamenti di stato tramite e-mail HTML.
Puoi scoprire cosa significa "importante" nella sezione successiva.
4. Testare le notifiche
Sarebbe un po' scomodo aspettare che si verifichi un problema reale o addirittura provocarne uno solo per testare le notifiche. È più facile con Test notifications, uno strumento con cui puoi simulare una notifica per un host o un servizio e farla inviare immediatamente.
Per prima cosa apri il centro delle notifiche con Setup > Events > Notifications:
Quando apri questa pagina per la prima volta, ti verrà segnalato che l'«indirizzo e-mail di fallback» non è ancora stato configurato, come si vede nella schermata qui sopra. Per il momento puoi ignorare questa informazione. Ne parliamo nell'articolo sulle regole di notifica. Finché non avrai letto quella sezione, ti consigliamo di lasciare l'informazione come promemoria e di non cliccare su Do not show again per rimuoverla.
Altrimenti, questa pagina mostra informazioni sullo stato — come il numero di notifiche inviate e non riuscite — e viene utilizzata per richiamare azioni relative al tema delle notifiche, ad esempio la creazione di una regola di notifica, ma anche il richiamo di regole relative a host e servizi che possono influenzare le notifiche.
In fondo alla pagina Notifications, nella box Global notification rules, viene visualizzata la regola di notifica globale fornita da Checkmk. "Globale", perché ogni utente può anche creare le proprie regole di notifica personalizzate.
La regola di notifica fornita garantisce che le notifiche di tutti i cambiamenti di stato importanti degli host e dei servizi vengano inviate a tutti i contatti responsabili tramite e-mail HTML. Tutti i cambiamenti di stato degli host a DOWN e UP , e dei servizi a CRIT , WARN e OK sono classificati come "importanti".
Il test di notifica valuta le regole di notifica visualizzate. Puoi accedere al test di notifica tramite Setup > Events > Notifications e il pulsante Test notifications:
Basta selezionare un host e poi qualsiasi cambiamento di stato come evento. Attivando la checkbox "Trigger notification for a specific method", specifichi che la notifica non solo viene simulata, ma anche effettivamente inviata.
Clicca su "Test notifications". I risultati vengono visualizzati in fondo alla pagina. La cosa più importante è il riepilogo "Test results" in alto:
Affinché il test abbia esito positivo, deve esserci almeno una regola di notifica corrispondente. Il messaggio contenente "notification has been triggered" indica che la notifica è stata effettivamente inviata.
Sotto Predicted notifications puoi quindi vedere a chi e tramite quale canale è stata inviata la notifica:
Infine, la prima colonna nel campo in basso mostra quale delle regole di notifica ha avuto effetto 
e quale no 
:
Questo dovrebbe generare immediatamente un'e-mail per questo problema simulato. Una descrizione dettagliata delle opzioni e dei risultati del test di notifica è disponibile nell'articolo sulle regole di notifica.
Se non hai ricevuto una notifica nel monitoraggio reale, cioè al di fuori della simulazione, questo non significa necessariamente che ci sia un errore. Ci sono situazioni in cui le notifiche di Checkmk vengono deliberatamente soppresse, ad esempio:
quando la notifica è stata disabilitata nello snap-in Master control;
quando un host o un servizio è in un periodo di tempo di manutenzione programmato;
quando un host è in modalità "DOWN" e quindi i suoi servizi non generano notifiche;
se lo stato è cambiato troppo spesso di recente e il servizio è stato quindi contrassegnato come irregolare in Checkmk.
5. Regolazione delle notifiche
Puoi adattare le notifiche in Checkmk alle tue esigenze o a quelle della tua organizzazione in vari modi, utilizzando regole complesse. Puoi trovare tutti i dettagli al riguardo nell'articolo sulle notifiche.
6. Risoluzione dei problemi
Il modulo delle notifiche in Checkmk è molto complesso, poiché copre molte esigenze diverse che si sono rivelate importanti nel corso di molti anni di esperienza pratica. La domanda "Perché Checkmk non ha inviato una notifica in questo caso?" verrà quindi posta più spesso di quanto potresti aspettarti, specialmente all'inizio. Per questo motivo, ecco alcuni consigli per la risoluzione dei problemi.
In caso di problemi con le notifiche, check innanzitutto se ci sono notifiche non riuscite. Queste sono elencate nella pagina Monitor > System > Failed notifications. La colonna Summary mostra il motivo dell’errore — o almeno ti dà un’indicazione della causa probabile.
Un'altra possibilità è offerta da Checkmk attraverso l'analisi delle notifiche più recenti generate dal sistema e che hanno superato le regole di notifica. Apri la tabella delle notifiche da analizzare con Setup > Events > Analyze recent notifications. Qui puoi inviare nuovamente una notifica, visualizzarne il contesto e analizzare le regole di notifica associate. Puoi trovare ulteriori informazioni al riguardo nell'articolo sulle notifiche.
Se una notifica non è stata attivata da un particolare servizio, il primo passo sarebbe quello di controllare la cronologia delle notifiche per quel servizio. Per farlo, apri la pagina dei dettagli di quel servizio cliccando sul servizio nel monitoraggio. Seleziona "Service > Service notifications" dal menu. Lì troverai tutti gli eventi di notifica per questo servizio elencati in ordine cronologico, dal più recente al più vecchio.
Ecco un esempio di un servizio per il quale è stato tentato l'invio di una notifica, ma per il quale l'invio delle e-mail non è andato a buon fine perché non è stata effettuata l'installazione di alcun server SMTP.
Puoi trovare ulteriori informazioni nel file ~/var/log/notifiy.log.
Puoi visualizzarlo come utente dell’istanza, con il comando less, ad esempio:
Se non hai ancora familiarità con less, con la combinazione di tasti Shift+G puoi saltare alla fine di un file (utile per i file di log) e uscire da less con il tasto Q.
Con il comando tail -f puoi anche osservare il contenuto del file "in tempo reale" mentre è in esecuzione.
Questo è utile se ti interessano solo i nuovi messaggi, cioè quelli che compaiono solo dopo aver digitato tail.
Ecco un estratto da notify.log relativo a una notifica attivata con successo:
2024-04-15 16:21:47,912 [20] [cmk.base.notify] Analysing notification (localhost) context with 14 variables
2024-04-15 16:21:47,912 [20] [cmk.base.notify] Global rule 'Notify all contacts of a host/service via HTML email'...
2024-04-15 16:21:47,913 [20] [cmk.base.notify] -> matches!
2024-04-15 16:21:47,913 [20] [cmk.base.notify] - adding notification of martin via mail
2024-04-15 16:21:47,913 [20] [cmk.base.notify] Executing 1 notifications:
2024-04-15 16:21:47,913 [20] [cmk.base.notify] * notifying martin via mail, parameters: graphs_per_notification, notifications_with_graphs, bulk: no
2024-04-15 16:21:47,913 [20] [cmk.utils.notify] sending command LOG;HOST NOTIFICATION: martin;localhost;DOWN;mail;
2024-04-15 16:21:47,913 [20] [cmk.base.notify] executing /omd/sites/mysite/share/check_mk/notifications/mail
2024-04-15 16:21:48,458 [20] [cmk.base.notify] Output: Spooled mail to local mail transmission agent
2024-04-15 16:21:48,501 [20] [cmk.utils.notify] sending command LOG;HOST NOTIFICATION RESULT: martin;localhost;OK;mail;Spooled mail to local mail transmission agent;Spooled mail to local mail transmission agent |
Se vuoi sapere esattamente quando vengono generate le notifiche — e quando non lo sono — puoi scoprire tutta la verità nell'articolo sulle notifiche. |
Configurando le notifiche, hai completato gli ultimi ritocchi: il tuo sistema Checkmk è pronto per l'uso! Questo non significa, ovviamente, che tutte le funzionalità di Checkmk siano state esplorate appieno.