Etichette

È possibile assegnare etichette a un host in diversi modi.

Il primo è semplice: Nella pagina delle proprietà dell'host, che viene visualizzata quando crei o modifichi un host nel Setup, puoi assegnare a un host tutte le etichette che vuoi:

Seleziona la checkbox "Labels", quindi clicca nel campo "Add some label", inserisci la definizione dell'etichetta seguendo lo schema key:value e conferma con Invio.

Puoi modificare un'etichetta esistente cliccandoci sopra nel testo, oppure eliminarla con la piccola "x".

Naturalmente le etichette possono anche essere ereditate da una cartella. Come altri attributi, le etichette possono trovarsi nelle sottocartelle o sull'host, per poi essere sovrascritte nuovamente secondo necessità — in realtà singolarmente. Se, ad esempio, l'etichetta location:munich è impostata nella cartella, questa verrà ereditata da tutti gli host in questa cartella che non hanno già l'etichetta location definita. Le altre etichette che un host potrebbe avere rimarranno inalterate.

Le etichette definite esplicitamente per host o cartelle appaiono in viola nell'elenco degli host:

Come di consueto in Checkmk, gli attributi possono essere assegnati agli host e ai servizi anche tramite regole. Questo ti renderà indipendente dalla struttura delle cartelle e vale anche per le etichette. Per questa funzione è disponibile un set di regole Host labels, che puoi trovare rapidamente tramite una ricerca nel menu di configurazione.

La seguente regola aggiunge l'etichetta "hw:real" a tutti gli host nella cartella "Bavaria" che hanno il tag host "Real Hardware":

Avrai notato che le etichette non possono essere utilizzate nelle condizioni di questa regola. Non si tratta di un errore, ma di una scelta intenzionale, che evita dipendenze ricorsive e altre anomalie.

Le etichette aggiunte tramite regole appaiono in rosso sull'host visualizzato, ma non compaiono nell'elenco degli host nel Setup, bensì solo nella visualizzazione dello stato dell'host.

Il terzo modo in cui è possibile creare le etichette è in modo completamente automatico. Varie sorgenti dati, come gli agenti speciali per il monitoraggio dei sistemi cloud e container, generano automaticamente le etichette. In particolare, vanno menzionati qui gli agenti speciali per AWS, Azure e Kubernetes. A volte questi elementi vengono chiamati anche tag sulle rispettive piattaforme e vengono creati in Checkmk come etichette dell'host o di servizio. I rispettivi set di regole forniscono informazioni sufficienti al riguardo.

Il bello è che non devi configurare assolutamente nulla. Non appena queste sorgenti dati sono attive, le etichette corrispondenti vengono generate.

Nella sezione Etichette dell'host generate automaticamente troverai una panoramica delle etichette che Checkmk genera automaticamente.

Un modo semplice per manipolare direttamente le etichette è aggiungere un plug-in dell'agente che, analogamente ai check locali, crea una sezione chiamata "labels". In questo modo puoi assegnare etichette in modo più dettagliato rispetto alla sola valutazione dell'inventario HW/SW — ad esempio, in base alle sfumature dell'hardware installato (come le caratteristiche della CPU) o in relazione ai processi effettivamente in esecuzione (anziché semplicemente al software installato).

L'output dell'etichetta deve essere formattato come un dizionario Python, come nell'esempio seguente:

Evita conflitti con le etichette assegnate automaticamente da Checkmk stesso e da altri plug-in, poiché non è possibile garantire un ordine di valutazione particolare.

Se hai abilitato il discovery check — che è l'impostazione predefinita per le nuove installazioni — ti avviserà quando vengono trovate nuove etichette dell'host che non sono ancora state aggiunte alle proprietà dell'host nel Setup. Ad esempio, apparirà così:

Hai due opzioni per rispondere a questo avviso. La prima è aggiungere le nuove etichette richiamando la configurazione del servizio per l’host in Setup e aggiornando la configurazione delle etichette con la voce di menu “Hosts > Update host labels”. Il discovery check rOKrà nuovamente alla prossima esecuzione (con un ritardo massimo di due ore), anche se non hai ancora attivato le modifiche. Se non vuoi aspettare così a lungo, puoi anche aggiornare manualmente il servizio immediatamente selezionando "Reschedule check" nel menu azione del servizio.

Se questo riguarda molti host contemporaneamente, sicuramente non vorrai visitare la configurazione del servizio per ogni singolo host. La cosa migliore da fare in questo caso è eseguire l’azione massiva per “Run bulk service discovery” e selezionare “Only discover new host labels” come modalità — oppure, in alternativa, “Add unmonitored services and new host labels” se vuoi anche cogliere l’occasione per aggiungere nuovi servizi.

Il secondo modo per far diventare verde il discovery check è riconfigurarlo in modo che non ti avvisi più delle nuove etichette. Per farlo, vai al set di regole "Periodic service discovery" e modifica la regola esistente: lì troverai l'opzione "Severity of new host labels":

Per impostazione predefinita, questa opzione è impostata su "Warning". Scegli "OK - do not alert, just display" e il check non emetterà più alcun avviso.

Le etichette trovate tramite il discovery check vengono visualizzate in giallo-ocra.

In teoria, la stessa etichetta può essere definita con valori diversi in più fonti contemporaneamente. Ecco perché esiste il seguente ordine di priorità:

Queste regole di precedenza ti offrono il massimo controllo sulle etichette.

Una funzione importante delle etichette è la stessa delle caratteristiche dell'host: ovvero, il loro utilizzo come condizione nelle regole. Questo è particolarmente utile per le etichette generate automaticamente, perché puoi adattare il tuo monitoraggio in modo completamente automatico sulla base delle informazioni provenienti da AWS, Azure, Kubernetes e simili.

Aggiungi le condizioni con Add to condition per le etichette dell'host o di servizio. Ora seleziona is o not per formulare una condizione positiva o negativa e poi inserisci l'etichetta nel formato usuale key:value. Presta attenzione all’ortografia esatta, comprese le maiuscole. Poiché le etichette possono essere definite senza specifiche, Checkmk non è in grado di riconoscere gli errori di battitura. Tuttavia: quando digiti un’etichetta, Checkmk suggerisce le etichette esistenti se corrispondono a ciò che hai digitato in precedenza. Nei suggerimenti non viene fatta alcuna distinzione tra etichette di host e di servizio: vengono proposte tutte le etichette corrispondenti. Presta attenzione all’ortografia corretta, poiché errori di ortografia, maiuscole errate, ecc. comporteranno il mancato funzionamento della regola.

Tuttavia, la definizione della condizione va oltre: Per affinare ulteriormente la condizione, hai a disposizione anche gli operatori booleani Not, And e Or. Qui, Not è l'abbreviazione di And Not.

Ad esempio, per trovare host con l'etichetta cmk/site:today ma senza l'etichetta cmk/piggyback_source_today:yes, la condizione potrebbe essere simile a questa:

Puoi affinare questa condizione con is o not aggiungendo qualsiasi altra specifica. Oppure puoi aggiungere un nuovo gruppo di condizioni con Add to condition, il che rende la condizione, ora più complessa, più facile da leggere, ma non cambia la valutazione dell'algebra booleana:

Puoi utilizzare sia le etichette che i tag host in una regola. Questi vengono automaticamente collegati con un AND. La regola si applica quindi solo se entrambe le condizioni sono soddisfatte contemporaneamente.

Puoi utilizzare le etichette anche come condizioni nelle regole di notifica. L'utilizzo è lo stesso delle altre condizioni, quindi non devi imparare nulla di nuovo per usarle. Seleziona "Match host labels" e inserisci semplicemente quali etichette deve avere un host o un servizio, in modo da attivare una notifica tramite questa regola. Anche in questo caso, più etichette sono collegate dall'operazione AND.