Integrazione di Checkmk in Grafana

Questo tipo di installazione richiede almeno l'utilizzo di Checkmk Cloud. Se Grafana opera su un proprio server, l'installazione dalla raccolta di plug-in di Grafana è possibile tramite la linea di comando:

Riavvia il servizio server di Grafana:

Il plug-in sarà quindi disponibile nell'interfaccia di Grafana e potrà essere attivato e configurato.

Per prima cosa accedi all'istanza di Grafana in cui vuoi installare la fonte di dati Checkmk. Poi apri la pagina della fonte di dati nella raccolta di plug-in di Grafana. Nella scheda Installation, seleziona l'istanza di Grafana che deve ricevere il plug-in e poi clicca sul pulsante Install. Potrebbero essere necessari alcuni minuti prima che il plug-in sia disponibile nell'interfaccia web dell'installazione di Grafana.

Nella pagina dei rilasci del repository GitHub troverai due varianti del plug-in sotto forma di archivio zip:

Basta scaricare l'ultima versione come file zip e copiarla, ad esempio con scp, sul server di Grafana.

Invece di usare il browser, puoi ovviamente caricare il file direttamente dalla linea di comando. Tieni presente che per farlo devi conoscere la versione corrente: nell'esempio seguente, scriviamo la versione nella variabile $plugvers.

Successivamente, decomprimi l'archivio zip:

Crea una directory plug-in, se non esiste già, e fai in modo che l'utente Linux sotto il cui ID vengono eseguiti i processi di Grafana (di solito grafana) ne sia il proprietario:

Sposta la cartella risultante nella directory dei plug-in di Grafana, che di solito è il percorso /var/lib/grafana/plugins/:

Cambia la proprietà all'utente di Grafana:

L'installazione tramite clonazione dell'archivio Git (come descritto nelle versioni precedenti di questo articolo) non è più possibile. Se vuoi partecipare allo sviluppo del plug-in, leggi la Guida allo sviluppo.

Sotto Home > Dashboards troverai un menu a discesa contrassegnato da un segno più. Clicca su New dashboard per creare un nuovo dashboard:

Il dashboard più semplice mostra un singolo grafico per il servizio di un host. Questo può anche essere la metrica di un check locale per il quale non esistono grafici già pronti. Crea una nuova visualizzazione in un dashboard esistente o in quello che hai appena creato. Per prima cosa seleziona Add visualization qui:

La creazione di una visualizzazione ti porta alla selezione dell'origine dei dati. Dopo aver selezionato Checkmk, ti trovi direttamente nella modalità di modifica della Query per il pannello appena creato. Un pannello è un container per una visualizzazione.

L'accesso ai dati da visualizzare differisce leggermente tra Checkmk Raw e le edizioni commerciali: in Checkmk Raw lavori con menu predefiniti - per sito, nome host, servizio e così via. Nelle edizioni commerciali, hai la possibilità di definire cascate di filtri. Questo permette una selezione molto dettagliata, anche utilizzando espressioni regolari. Il semplice esempio che segue è stato scelto in modo da poterlo eseguire con tutte le edizioni.

Per prima cosa seleziona Site, quindi filtra per un Hostname nel monitoraggio. Per il primo test, utilizza qualsiasi host che utilizzi l'agente Windows o Linux. Seleziona Check_MK come Service. Imposta il tipo di Aggregation su Maximum. Graph type disponibile per la selezione è Single metric o Predefined graph:Predefined graphs prende le metriche da Checkmk, che possono contenere anche grafici combinati. I nostri screenshot qui mostrano Single metric, che contiene il tempo totale di esecuzione dell'agente (Time spent waiting for Checkmk agent).

Grafana visualizza direttamente il risultato. Con il pulsante Apply puoi applicare il grafico senza salvare il dashboard. Con Save ti viene richiesto di inserire un titolo per il nuovo Dashboard e puoi quindi salvare il dashboard appena creato.

Gli sviluppatori di Checkmk hanno già raccolto molte metriche correlate in grafici comuni per facilitare agli utenti la panoramica dei vari aspetti di una singola risorsa. Puoi visualizzare le metriche di questi grafici già pronti direttamente in Grafana.

La procedura è inizialmente la stessa spiegata nella sezione precedente. Tuttavia, per completare il processo, seleziona la voce Graph type Predefined graph e Predefined graph per il servizio da utilizzare.

Se ricevi un messaggio di errore che indica che la selezione di metriche combinate con più di 200 elementi non è consentita, utilizza dei filtri aggiuntivi per limitare la selezione. In caso di dubbio, sposta i filtri che limitano significativamente il risultato all'inizio dell'insieme.

Una volta soddisfatti della selezione, clicca sul pulsante Apply. Il grafico sarà ora disponibile nel dashboard selezionato.

Soprattutto in un cluster dinamico, spesso vorrai essere in grado di seguire l'intero andamento di una metrica su tutti gli host partecipanti senza dover personalizzare un grafico ogni volta che viene aggiunto o rimosso un nuovo nodo. Per ottenere questo risultato, esistono diverse opzioni per adattare dinamicamente i grafici.

La prima opzione è quella di filtrare per Host Labels o Host Tags invece di selezionare i singoli host. Un'altra opzione è quella di utilizzare le espressioni regolari. Puoi applicare le espressioni regolari agli host o ai servizi. Nell'esempio seguente, filesystem corrisponde a tutti i servizi che contengono filesystem, indipendentemente dal numero di file system montati dall'host.

Con filesystem.*nvme si restringe la selezione a tutti i file system sulle unità NVMe, indipendentemente dal tipo di file system utilizzato, poiché la parte della stringa tra filesystem e nvme può essere arbitraria.

Oltre alle opzioni di filtro estese, usa Aggregation per determinare la visualizzazione delle metriche nel grafico e Graph per determinare quale grafico deve essere usato come riferimento. Nota che le metriche di un host/servizio vengono visualizzate solo se ha anche il grafico selezionato. Un grafico potrebbe quindi avere il seguente aspetto, ad esempio:

Nella modalità di modifica di ogni pannello, troverai una scheda Transform. Puoi utilizzare il sotto elemento Rename by regex disponibile qui per riordinare i nomi delle metriche o sopprimere le informazioni non necessarie. L'esempio seguente cerca due gruppi di caratteri separati da una virgola seguita da uno spazio, li scambia e mette esplicitamente Service e Host in testa:

Le variabili $1 e $2 corrispondono alle stringhe "catturate" nella riga precedente(gruppi di corrispondenza o gruppi di cattura). Grafana consente anche gruppi di corrispondenza annidati. La sezione corrispondente nell'articolo sulle espressioni regolari fornisce una panoramica delle possibilità disponibili per questi gruppi.

Ogni variabile è una proprietà di un dashboard. Deve essere creata nelle impostazioni del dashboard e può essere utilizzata solo all'interno di questo dashboard. Poiché la query richiede la configurazione più estesa, ne mostreremo l'uso nel nostro esempio.

Le proprietà rilevanti per una variabile sono il suo tipo e il suo nome; tutte le altre proprietà sono utilizzate solo a scopo di chiarezza nella dashboard. Il nome deve differenziare le variabili. Quindi, se intendi utilizzare diverse variabili per selezionare host da diversi sottoinsiemi, utilizza un nome che faccia riferimento a questo insieme invece di host come nell'esempio, ad esempio host_from_linuxservers.

Quando selezioni una fonte di dati, assicurati che sia selezionata una connessione Checkmk. Puoi restringere ulteriormente il tipo di oggetto selezionato, ad esempio con espressioni regolari. Tutti i filtri utilizzati vengono valutati sul server Checkmk. Al contrario, i campi Regex e Sort vengono valutati da Grafana.

I due checkbox per Selection options in fondo alla pagina possono essere utilizzati facoltativamente in un secondo momento, a seconda delle esigenze. Se necessario, puoi modificare queste impostazioni in qualsiasi momento; per il primo test, lascia entrambe le impostazioni predefinite (vuote). Salva le variabili usando Save dashboard quando hai effettuato tutte le impostazioni.

Ora puoi inserire le variabili assegnate nei campi appropriati per creare un grafico flessibile. Le variabili possono essere utilizzate anche nel titolo del grafico.

Nel dashboard viene visualizzata una selezione a discesa per ogni variabile, che puoi utilizzare per impostare i valori delle variabili (host, servizi...) che vuoi visualizzare nel dashboard. Se hai attivato la selezione multipla, puoi impostare l'opzione Repeat by variable nelle impostazioni del pannello per visualizzare il pannello per ogni valore della variabile selezionata.