Etichette

Le etichette dell'host possono essere assegnate 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:

Attiva Labels con il checkbox, poi clicca nel campo Add some label, inserisci la definizione dell'etichetta seguendo lo schema key:value e termina con Invio.

Puoi modificare un'etichetta esistente cliccando sul suo testo o eliminarla con la piccola "x".

Naturalmente le etichette possono anche essere ereditate da una cartella. Come gli altri attributi, le etichette possono essere presenti nelle sottocartelle o nell'host e poi, se necessario, possono essere sovrascritteindividualmente. Se ad esempio nella cartella viene impostata l'etichetta location:munich, questa verrà ereditata da tutti gli host della cartella che non abbiano già definito l'etichetta location. Le altre etichette dell'host rimarranno inalterate.

Le etichette dell'host o della cartella definite esplicitamente 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 si applica anche alle etichette. Esiste un set di regole Host labels per questa funzione, che puoi trovare rapidamente tramite una ricerca nel menu di configurazione.

La regola seguente aggiunge l'etichetta hw:real a tutti gli host della 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 per mezzo delle regole appaiono in rosso nell'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. Diverse fonti di dati, come gli agenti speciali per il monitoraggio dei sistemi cloud e container, generano automaticamente le etichette. In particolare, vanno citati gli agenti speciali per AWS, Azure e Kubernetes. A volte questi elementi vengono anche chiamati tag nelle rispettive piattaforme e vengono creati in Checkmk come etichette dell'host o del servizio. I rispettivi set di regole forniscono informazioni sufficienti a riguardo.

L'aspetto positivo è che non devi configurare nulla: non appena queste fonti di dati sono attive, vengono generate le etichette corrispondenti.

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

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

L'output delle etichette 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 particolare di valutazione.

Se hai attivato il discovery check, che è l'opzione 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:

Hai due opzioni per rispondere a questo avviso: la prima è quella di aggiungere le nuove etichette richiamando la configurazione del servizio per l'host nel Setup e aggiornando la configurazione delle etichette con il menu di configurazione Hosts > Update host labels. Il discovery check sarà quindi di nuovo OK alla prossima esecuzione (con un ritardo massimo di due ore), anche se non hai ancora attivato le modifiche. Se non vuoi aspettare così tanto, puoi anche aggiornare manualmente il servizio immediatamente selezionando Reschedule check nel menu di azione del servizio.

Se l'aggiornamento riguarda molti host contemporaneamente, non vorrai certo visitare la configurazione del servizio per ogni 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à - o in alternativa Add unmonitored services and new host labels se vuoi anche cogliere l'opportunità di aggiungere nuovi servizi.

Il secondo modo per rendere verde il discovery check è quello di riconfigurarlo in modo che non ti avverta più della presenza di 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 è impostata su Warning. Scegli OK - do not alert, just display e il controllo diventerà silenzioso.

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

Teoricamente, la stessa etichetta può essere definita con valori diversi in più fonti contemporaneamente. Per questo motivo esiste il seguente ordine di priorità:

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

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

Aggiungi le condizioni con Add to condition per le etichette dell'host o del servizio. Ora seleziona is o not per formulare una condizione positiva o negativa e poi inserisci l'etichetta nella solita forma key:value. Fai attenzione all'ortografia esatta, compresa la maiuscola. Poiché le etichette possono essere definite senza specifiche, Checkmk non può riconoscere gli errori di battitura. Tuttavia: Quando digiti un'etichetta, Checkmk suggerisce le etichette esistenti se corrispondono a quelle inserite in precedenza. Nei suggerimenti non viene fatta distinzione tra etichette dell'host e del servizio: vengono proposte tutte le etichette corrispondenti. Presta attenzione all'ortografia corretta, poiché errori di ortografia, capitalizzazione errata e così via faranno sì che la regola non funzioni più.

Tuttavia, la definizione della condizione fa un ulteriore passo avanti: per perfezionare ulteriormente la condizione, hai a disposizione gli operatori booleani Not, And e Or. In questo caso, Not è l'abbreviazione di And Not.

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

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

In una regola puoi utilizzare sia le etichette che i tag dell'host, che sono automaticamente collegati tra loro (AND). Pertanto, la regola si applica solo se entrambe le condizioni sono soddisfatte allo stesso tempo.

Puoi utilizzare le etichette anche come condizioni nelle regole di notifica. L'utilizzo è lo stesso delle altre condizioni, quindi non devi imparare a usarle. Seleziona Match host labels e inserisci semplicemente le etichette che un host o un servizio devono avere per attivare una notifica attraverso questa regola. Anche in questo caso, le etichette multiple sono collegate dall'operazione AND.