Recupero dei dati di stato tramite Livestatus

L'accesso a Livestatus avviene tramite un Unix-Socket utilizzando ilLivestatus Query Language (LQL). La sua sintassi è basata su HTTP.

Tramite la linea di comando ci sono diversi modi per accedere all'interfaccia. Una possibilità è quella di utilizzare i comandi printf e unixcat per inviare un'istruzione al socket. Lo strumento unixcat è già incluso in Checkmk per gli utenti di istanza. Importante: tutti gli input al socket sono sensibili alle maiuscole e minuscole, quindi bisogna sempre rispettarle:

L'interfaccia si aspetta che tutti i comandi e le intestazioni vengano inseriti in una riga separata. Puoi segnare un'interruzione di riga con \n. In alternativa al comando di cui sopra, puoi anche utilizzare il comando script lq, che ti risparmia un po' di lavoro grazie al completamento automatico di alcuni campi durante l'inserimento:

Oppure puoi avviare il flusso di inserimento interattivo e inserire il comando seguito dall'intestazione. Con una riga vuota esegui il comando con la sua intestazione e con un'altra riga termini l'accesso al socket. Nota che nell'esempio, tutto ciò che precede la riga vuota appartiene al comando, mentre tutto ciò che è compreso tra la prima e la seconda riga vuota è la risposta:

I seguenti esempi vengono sempre eseguiti con il comando lq: nel modulo diretto quando la richiesta è breve e come flusso di ingresso per le richieste più lunghe.

Poiché Checkmk si basa molto su Python, gli script in questo linguaggio sono pratici. Il seguente script può essere utilizzato come base per accedere al socket Livestatus:

Checkmk fornisce un'API per i linguaggi di programmazione Python, Perl e C++ che semplifica l'accesso a Livestatus. Per ogni linguaggio è disponibile un codice di esempio che ne spiega l'utilizzo. I percorsi di questi esempi si trovano nel capitolo File e directory.

Negli esempi che abbiamo visto finora, sono state interrogate TUTTE le informazioni di TUTTI gli host. In pratica, però, è probabile che si abbia bisogno solo di colonne specifiche. Con l'intestazione Columns, già menzionata, l'output può essere limitato a questa colonna. I nomi delle singole colonne saranno separati da un semplice carattere vuoto.

Come si può vedere, in una riga i singoli valori sono separati da un punto e virgola.

Importante: se si utilizzano queste intestazioni, l'intestazione viene soppressa nell'output, che può essere reinserito nell'output con l'intestazione ColumnHeaders.

Per limitare la query a righe specifiche, le colonne possono essere filtrate per contenuti specifici. Se si vogliono cercare solo i servizi con uno stato specifico, questo può essere ottenuto con un filtro:

Nell'esempio verranno cercati tutti i servizi con stato CRIT e verranno visualizzati il nome dell'host, la descrizione del servizio e il suo stato. Questi filtri possono ovviamente essere combinati e limitati ai servizi con statoCRIT e che non sono ancora stati confermati:

Come si può vedere, è possibile filtrare anche per colonne che non sono elencate in Columns.

Puoi utilizzare l'intestazione OrderBy per ordinare l'output in base al contenuto di qualsiasi colonna o anche ai valori di qualsiasi chiave del dizionario. Questo ti permette di creare un elenco alfabetico di tutti gli host, ad esempio:

Implicitamente, l'output è ordinato in ordine crescente (asc) come previsto. Tuttavia, puoi anche specificare esplicitamente l'ordinamento desiderato e annullarlo specificando desc`:

Con query un po' più lunghe e con un ordinamento basato, ad esempio, sui dati relativi alle prestazioni, è possibile creare interessanti elenchi. Nell'esempio seguente, gli host vengono visualizzati in ordine decrescente in base al loro tempo di attività:

Alcune colonne di una tabella non restituiscono un solo valore, ma un intero elenco. Per poter cercare efficacemente in questo elenco, in questi casi gli operatori hanno un'altra funzione. Un elenco completo degli operatori si trova in Operatori per gli elenchi. Ad esempio, l'operatore >= ha la funzione "contiene". Con questo operatore puoi, ad esempio, cercare contatti specifici:

Come si può vedere nell'esempio precedente, i contatti saranno elencati, separati da virgole, nella colonna contacts. Questo permette di distinguerli chiaramente in quanto non sono l'inizio di un'altra colonna. Una caratteristica speciale dell'operatore di uguaglianza è che controlla se un elenco è vuoto:

In precedenza sono già stati combinati diversi filtri. Sembra intuitivo che i dati debbano passare attraverso tutti i filtri per essere mostrati. I filtri saranno quindi collegati dall'operatore logico e. Per collegare particolari filtri con un logico o, alla fine della stringa del filtro codifica un o: seguito da un numero intero. Il contatore specifica quante delle ultime righe possono essere combinate con un or. In questo modo è possibile formare dei gruppi e combinarli a seconda delle esigenze. Ecco un semplice esempio: qui vengono combinati due filtri in modo da mostrare tutti i servizi che hanno lo statoWARN o SCONOSCIUTO:

Il risultato di una combinazione può anche essere negato o i gruppi possono essere combinati a loro volta in altri gruppi. Nell'esempio, vengono mostrati tutti i servizi il cui stato non è OK e la cui descrizione inizia con Filesystem o che hanno uno stato diverso da SCONOSCIUTO:

Il formato di output può essere specificato in due modi: un metodo consiste nel ridefinire i separatori utilizzati nell'output standard; l'altro metodo consiste nell'output conforme ai formati Python o JSON.

Ci sono situazioni in cui non ti interessa lo stato di un singolo servizio o di un gruppo di servizi. Molto più importante è il numero di servizi con uno stato WARN o il numero di database monitorati. Livestatus è in grado di generare ed emettere statistiche con Stats.

Overview riceve i suoi dati recuperando le statistiche di host, servizi ed eventi attraverso Livestatus e visualizzandole nell'interfaccia di Checkmk. Con l'accesso diretto a Livestatus puoi produrre il tuo riepilogo personale:

Inoltre, tali statistiche possono essere combinate con tutti i filtri.

Le statistiche possono essere combinate anche con and/or. Le intestazioni si chiamano StatsAnd o StatsOr. Usa StatsNegate se l'output deve essere annullato. Nell'esempio verrà mostrato il numero totale di host (l'iniziale Stats) e in aggiunta verrà mostrato il numero di host contrassegnati come stale e che non sono elencati in un tempo di manutenzione programmata (le statistiche 2 e 3 sono collegate con un "AND" logico):

Non lasciarti confondere dalle varie opzioni per combinare i risultati dei filtri e delle statistiche: mentre tutti gli host che soddisfano le condizioni saranno visualizzati utilizzando l'intestazioneFilter con l'intestazione, con le statistiche l'output sarà la somma della frequenza con cui il filtro Stats viene applicato.

È anche possibile eseguire dei calcoli sui valori e, ad esempio, produrre un valore medio o un valore massimo. Un elenco completo di tutti gli operatori possibili è disponibile qui.

Nell'esempio seguente, l'output elenca i tempi medi, minimi e massimi richiesti dai plug-in di controllo dell'host per calcolare lo stato:

I calcoli con le metriche sono gestiti in modo un po' speciale. Anche in questo caso sono disponibili tutte le funzioni di Stats-header, che però vengono applicate singolarmente a tutte le metriche di un servizio. Ad esempio, nel seguente esempio le metriche dell'utilizzo della CPU di un gruppo di host verranno sommate:

Con la tabella log di Livestatus hai accesso diretto alla cronologia del nucleo di monitoraggio, in modo da poter filtrare comodamente con l'LQL alla ricerca di eventi particolari. Le tabelle di disponibilità, ad esempio, saranno generate con l'aiuto di queste tabelle. Per migliorare la panoramica e limitare una query in modo tematico, hai accesso alle seguenti classi di registro:

Utilizzando queste classi di log puoi già limitare molto bene il tipo di voce che deve essere mostrata. Inoltre, il periodo di tempo preso in considerazione nella query sarà limitato. Questo è importante perché altrimenti verrà cercata l'intera cronologia dell'istanza, il che potrebbe logicamente frenare il sistema a causa del flusso di informazioni.

Un'ulteriore restrizione ragionevole dell'output sono le (Columns) che devono essere mostrate per una voce. Nell'esempio seguente cercheremo tutte le notifiche che sono state logorate nell'ultima ora:

Importante: assicurati che nella modalità interattiva del flusso di voci non sia possibile utilizzare nessuna delle variabili utilizzate nell'esempio e limita sempre le query a un periodo di tempo.

È possibile influenzare la rotazione dei file e le loro dimensioni massime. Inoltre, puoi specificare quante righe di un file devono essere lette prima che Checkmk si interrompa. Tutto questo può influire sulle prestazioni delle tue query, a seconda della struttura dell'istanza. Sono disponibili i seguenti tre parametri che possono essere trovati e personalizzati in Setup > General > Global Settings > Monitoring Core:

Per accedere a Livestatus tramite la rete, puoi collegare il socket Unix del processo live status a una porta TCP. In questo modo puoi eseguire script su macchine remote e raccogliere i dati direttamente da dove devono essere elaborati.

Quando un sito è spento, l'accesso via TCP può essere abilitato con il comandoomd:

Una volta avviato il sito, Livestatus via TCP è solitamente attivo sulla porta predefinita 6557. Per i server Checkmk con più siti che utilizzano Livestatus via TCP, viene scelta la porta più alta non utilizzata.

Tutte le impostazioni, come la porta e gli indirizzi IP autorizzati, possono essere configurate tramite omd config. In alternativa, queste impostazioni possono essere effettuate nel setup. In Checkmk la crittografia SSL della comunicazione Livestatus è abilitata di default:

Se è necessario accedere a Livestatus dall'esterno della rete locale, la protezione dell'accesso basata solo sugli indirizzi IP potrebbe non essere pratica. Il modo più semplice per ottenere un accesso autenticato è utilizzare la Secure Shell.

Con SSH, puoi passare un comando che verrà eseguito sul server remoto:

In alternativa, puoi inoltrare la porta di Livestatus all'host su cui stai lavorando tramite un tunnel SSH:

Se la connessione è stata stabilita, in una seconda sessione della console puoi verificare se l'accesso con openssl s_client è possibile:

Se il test ha successo, qualsiasi script che hai scritto per l'accesso diretto alla rete di Livestatus può essere utilizzato su localhost.

Livestatus può essere utilizzato non solo per interrogare i dati, ma anche per impartire comandi direttamente al core (CMC o Nagios). Un comando corretto include sempre una marca temporale, che può essere qualsiasi cosa. Poiché verrà utilizzata anche nei log per tracciare l'ora del processo, è consigliabile inserire l'ora nel modo più preciso possibile. I comandi con una marca temporale mancante verranno scartati, senza emettere un messaggio di errore e con una semplice immissione nel file cmc.log!

Affinché l'orario sia il più preciso possibile, si consiglia di non impostare il comando nel flusso di input, ma di inviarlo direttamente. In questo caso è possibile accedere alle variabili e fornire l'ora attuale:

Questo formato funziona sia con il Nagios-Core in Checkmk Raw che con il CMC nelle edizioni commerciali. Tuttavia, nei due core i comandi si sovrappongono solo in parte. Un elenco completo dei comandi per il Nagios-Core si trova direttamente sul sito web diNagios, mentre i comandi disponibili per il CMC si trovano nelriferimento dei comandi.

Nell'elenco dei comandi la sintassi ha il seguente modulo:

Come hai imparato, Checkmk utilizza un formato molto più semplice per l'emissione dei comandi. Per rendere il formato di Nagios compatibile con Checkmk, è sufficiente che il comando, la data e l'ora e, ove applicabile, le variabili: