3 Individuazione di basso livello

Panoramica

Low-level discovery (LLD) fornisce un modo per creare automaticamente item, trigger e grafici per diverse entità su un host. Ad esempio, Zabbix può iniziare automaticamente a monitorare file system o interfacce di rete sulla tua macchina, senza la necessità di creare manualmente item per ciascun file system o interfaccia di rete. LLD può anche creare host, ad esempio per popolare macchine virtuali rilevate su un hypervisor, e regole di discovery annidate, consentendo una discovery multilivello. Inoltre, è possibile configurare Zabbix per rimuovere automaticamente le entità non necessarie in base ai risultati effettivi della discovery eseguita periodicamente.

Un utente può definire i propri tipi di discovery, a condizione che seguano uno specifico protocollo JSON.

L'architettura generale del processo di discovery è la seguente.

Per prima cosa, un utente crea una regola di discovery in Data collection > Templates, nella colonna Discovery. Una regola di discovery consiste in (1) un item che rileva le entità necessarie (ad esempio file system o interfacce di rete) e (2) prototipi di item, trigger e grafici che devono essere creati in base al valore di quell'item.

Un item che rileva le entità necessarie è simile a un normale item visibile altrove: il server chiede a uno Zabbix agent (o a qualunque tipo sia impostato per l'item) un valore di quell'item, e l'agent risponde con un valore testuale. La differenza è che il valore restituito dall'agent deve contenere un elenco di entità rilevate in formato JSON. Sebbene i dettagli di questo formato siano importanti solo per gli implementatori di controlli di discovery personalizzati, è necessario sapere che il valore restituito contiene un elenco di coppie macro → valore. Ad esempio, l'item "net.if.discovery" potrebbe restituire due coppie: "{#IFNAME}" → "lo" e "{#IFNAME}" → "eth0".

Queste macro vengono utilizzate nei nomi, nelle chiavi e in altri campi dei prototipi, dove vengono poi sostituite con i valori ricevuti per creare item, trigger, grafici o persino host reali per ciascuna entità rilevata. Consulta l'elenco completo delle opzioni per l'utilizzo delle macro LLD.

Quando il server riceve un valore per un item di discovery, esamina le coppie macro → valore e per ciascuna coppia genera item, trigger e grafici reali, in base ai rispettivi prototipi. Nell'esempio con "net.if.discovery" sopra, il server genererebbe un insieme di item, trigger e grafici per l'interfaccia loopback "lo" e un altro insieme per l'interfaccia "eth0".

Si noti che a partire da Zabbix 4.2, il formato del JSON restituito dalle regole di low-level discovery è stato modificato. Non è più previsto che il JSON contenga l'oggetto "data". Low-level discovery ora accetta un normale JSON contenente un array, per supportare nuove funzionalità come il preprocessing del valore dell'item e percorsi personalizzati ai valori delle macro di low-level discovery in un documento JSON.

Le chiavi di discovery integrate sono state aggiornate per restituire un array di righe LLD alla radice del documento JSON. Zabbix estrarrà automaticamente una macro e un valore se un campo dell'array utilizza la sintassi {#MACRO} come chiave. Qualsiasi nuovo controllo di discovery nativo utilizzerà la nuova sintassi senza gli elementi "data". Durante l'elaborazione di un valore di low-level discovery, viene prima individuata la radice (array in $. o $.data).

Sebbene l'elemento "data" sia stato rimosso da tutti gli item nativi relativi alla discovery, per compatibilità con le versioni precedenti Zabbix continuerà ad accettare la notazione JSON con un elemento "data", anche se il suo utilizzo è sconsigliato. Se il JSON contiene un oggetto con un solo elemento array "data", il contenuto dell'elemento verrà estratto automaticamente utilizzando JSONPath $.data. Low-level discovery ora accetta macro LLD opzionali definite dall'utente con un percorso personalizzato specificato nella sintassi JSONPath.

Vedi anche: Entità rilevate

Configurazione del low-level discovery

Illustreremo il low-level discovery con un esempio di individuazione dei file system.

Per configurare l'individuazione, procedere come segue:

• Andare in: Data collection > Templates oppure Hosts.
• Fare clic su Discovery nella riga del template/host appropriato.

• Fare clic su Create discovery rule nell'angolo superiore destro dello schermo.
• Compilare il modulo della regola di individuazione con i dettagli richiesti.

Regola di individuazione

Il modulo della regola di individuazione contiene cinque schede che rappresentano, da sinistra a destra, il flusso dei dati durante l'individuazione:

• Regola di individuazione - specifica, soprattutto, l'item integrato o lo script personalizzato per recuperare i dati di individuazione.
• Preprocessing - applica un certo preprocessing ai dati individuati.
• Macro LLD - consente di estrarre alcuni valori di macro da utilizzare negli item, trigger, ecc. individuati.
• Filtri - consente di filtrare i valori individuati.
• Override - consente di modificare item, trigger, grafici o prototipi di host quando vengono applicati a specifici oggetti individuati.

La scheda Regola di individuazione contiene la chiave item da utilizzare per l'individuazione (oltre ad alcuni attributi generali della regola di individuazione):

Tutti i campi di input obbligatori sono contrassegnati da un asterisco rosso.

Preprocessing

La scheda Preprocessing consente di definire regole di trasformazione da applicare al risultato della discovery. In questa fase sono possibili una o più trasformazioni. Le trasformazioni vengono eseguite nell'ordine in cui sono definite. Tutto il preprocessing viene eseguito da Zabbix server.

Vedi anche:

• Dettagli sul preprocessing
• Test del preprocessing

Nota che se la discovery rule è stata applicata all'host tramite template, il contenuto di questa scheda è di sola lettura.

Macro personalizzate

La scheda Macro LLD consente di specificare macro personalizzate per il low-level discovery.

Le macro personalizzate sono utili nei casi in cui il JSON restituito non abbia già definite le macro richieste. Quindi, ad esempio:

• La chiave nativa vfs.fs.discovery per il rilevamento dei filesystem restituisce un JSON con alcune macro LLD predefinite come {#FSNAME}, {#FSTYPE}. Queste macro possono essere utilizzate direttamente nei prototipi di item e trigger (vedere le sezioni successive della pagina); non è necessario definire macro personalizzate;
• Anche l'item agent vfs.fs.get restituisce un JSON con i dati del filesystem, ma senza alcuna macro LLD predefinita. In questo caso è possibile definire personalmente le macro e associarle ai valori nel JSON utilizzando JSONPath:

I valori estratti possono essere utilizzati negli item rilevati, nei trigger, ecc. Si noti che i valori verranno estratti dal risultato del rilevamento e da tutti i passaggi di preprocessing eseguiti fino a quel momento.

Filtro

Un filtro può essere utilizzato per generare item, trigger e grafici reali solo per le entità che corrispondono ai criteri. La scheda Filtri contiene le definizioni dei filtri della regola di discovery che consentono di filtrare i valori di discovery:

Override

La scheda Overrides consente di impostare regole per modificare l'elenco dei prototipi di item, trigger, graph, host e discovery oppure i loro attributi per gli oggetti scoperti che soddisfano determinati criteri.

Gli override, se presenti, vengono visualizzati in un elenco riordinabile tramite trascinamento e rilascio ed eseguiti nell'ordine in cui sono definiti. Per configurare i dettagli di un nuovo override, fare clic su nel blocco Overrides. Per modificare un override esistente, fare clic sul nome dell'override. Si aprirà una finestra popup che consente di modificare i dettagli della regola di override.

Tutti i parametri obbligatori sono contrassegnati da asterischi rossi.

Configurazione di un'operazione

Per configurare i dettagli di una nuova operazione, fare clic su nel blocco Operations. Per modificare un'operazione esistente, fare clic su accanto all'operazione. Si aprirà una finestra popup in cui è possibile modificare i dettagli dell'operazione.

Parameter			Description
Object			Sono disponibili cinque tipi di oggetti: Item prototype Trigger prototype Graph prototype Host prototype Discovery prototype
Condition			Consente di filtrare le entità a cui deve essere applicata l'operazione.
	Operator		Operatori supportati: equals - applica a questo prototipo does not equal - applica a tutti i prototipi, tranne questo contains - applica se il nome del prototipo contiene questa stringa does not contain - applica se il nome del prototipo non contiene questa stringa matches - applica se il nome del prototipo corrisponde all'espressione regolare does not match - applica se il nome del prototipo non corrisponde all'espressione regolare
	Pattern		Una espressione regolare o una stringa da cercare.
	Object: Item prototype
		Create enabled	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di item: Yes - l'item verrà aggiunto in stato abilitato. No - l'item verrà aggiunto a un'entità scoperta, ma in stato disabilitato.
		Discover	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di item: Yes - l'item verrà aggiunto. No - l'item non verrà aggiunto.
		Update interval	Quando la casella di controllo è selezionata, vengono visualizzate due opzioni che consentono di impostare un intervallo diverso per l'item: Delay - intervallo di aggiornamento dell'item. Sono supportati user macros e time suffixes (ad esempio 30s, 1m, 2h, 1d). Deve essere impostato a 0 se viene usato Custom interval. Custom interval - fare clic su per specificare intervalli flessibili/pianificati. Per informazioni dettagliate, vedere Custom intervals.
		History	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di impostare un diverso periodo di conservazione della history per l'item: Do not store - se selezionato, la history non verrà memorizzata. Store up to - se selezionato, a destra verrà visualizzato un campo di input per specificare il periodo di conservazione. Sono supportati user macros e LLD macros.
		Trends	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di impostare un diverso periodo di conservazione dei trends per l'item: Do not store - se selezionato, i trends non verranno memorizzati. Store up to - se selezionato, a destra verrà visualizzato un campo di input per specificare il periodo di conservazione. Sono supportati user macros e LLD macros.
		Tags	Quando la casella di controllo è selezionata, verrà visualizzato un nuovo blocco che consente di specificare coppie tag-valore. Questi tag verranno aggiunti ai tag specificati nel prototipo di item, anche se i nomi dei tag coincidono.
	Object: Trigger prototype
		Create enabled	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di trigger: Yes - il trigger verrà aggiunto in stato abilitato. No - il trigger verrà aggiunto a un'entità scoperta, ma in stato disabilitato.
		Discover	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di trigger: Yes - il trigger verrà aggiunto. No - il trigger non verrà aggiunto.
		Severity	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti di severità del trigger, che consentono di modificarne la severità.
		Tags	Quando la casella di controllo è selezionata, verrà visualizzato un nuovo blocco che consente di specificare coppie tag-valore. Questi tag verranno aggiunti ai tag specificati nel prototipo di trigger, anche se i nomi dei tag coincidono.
	Object: Graph prototype
		Discover	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di graph: Yes - il graph verrà aggiunto. No - il graph non verrà aggiunto.
	Object: Host prototype
		Create enabled	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di host: Yes - l'host verrà creato in stato abilitato. No - l'host verrà creato in stato disabilitato.
		Discover	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di host: Yes - l'host verrà scoperto. No - l'host non verrà scoperto.
		Link templates	Quando la casella di controllo è selezionata, verrà visualizzato un campo di input per specificare i template. Iniziare a digitare il nome del template oppure fare clic su Select accanto al campo e selezionare i template dall'elenco in una finestra popup. I template di questo override vengono aggiunti a tutti i template già collegati al prototipo di host.
		Tags	Quando la casella di controllo è selezionata, verrà visualizzato un nuovo blocco che consente di specificare coppie tag-valore. Questi tag verranno aggiunti ai tag specificati nel prototipo di host, anche se i nomi dei tag coincidono.
		Host inventory	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di selezionare una diversa mode di inventory per il prototipo di host: Disabled - non compilare l'inventory dell'host Manual - fornire i dettagli manualmente Automated - compilare automaticamente i dati dell'inventory dell'host in base alle metriche raccolte.

Pulsanti del modulo

I pulsanti nella parte inferiore del modulo consentono di eseguire diverse operazioni.

	Aggiungi una regola di individuazione. Questo pulsante è disponibile solo per le nuove regole di individuazione.
	Aggiorna le proprietà di una regola di individuazione. Questo pulsante è disponibile solo per le regole di individuazione esistenti.
	Crea un'altra regola di individuazione basata sulle proprietà della regola di individuazione corrente.
	Esegui immediatamente l'individuazione in base alla regola di individuazione. La regola di individuazione deve già esistere. Vedi maggiori dettagli. Nota: quando si esegue immediatamente l'individuazione, la cache di configurazione non viene aggiornata, pertanto il risultato non rifletterà modifiche molto recenti alla configurazione della regola di individuazione.
	Verifica la configurazione della regola di individuazione. Usa questo pulsante per verificare le impostazioni di configurazione (come la connettività e la correttezza dei parametri) senza applicare permanentemente alcuna modifica.
	Elimina la regola di individuazione.
	Annulla la modifica delle proprietà della regola di individuazione.

Entità rilevate

Le schermate seguenti illustrano come appaiono item, trigger e grafici rilevati nella configurazione dell'host. Le entità rilevate sono precedute da un collegamento arancione alla regola di discovery da cui provengono.

Si noti che le entità rilevate non verranno create nel caso in cui esistano già entità con gli stessi criteri di unicità, ad esempio un item con la stessa chiave o un grafico con lo stesso nome. In questo caso, nel frontend viene visualizzato un messaggio di errore che indica che la regola di low-level discovery non ha potuto creare determinate entità. La regola di discovery stessa, tuttavia, non diventerà unsupported perché alcune entità non hanno potuto essere create e hanno dovuto essere saltate. La regola di discovery continuerà a creare/aggiornare altre entità.

Se un'entità rilevata (host, file system, interfaccia, ecc.) smette di essere rilevata (o non supera più il filtro), le entità create sulla sua base possono essere automaticamente disabilitate ed eventualmente eliminate.

Le risorse perse possono essere automaticamente disabilitate in base al valore del parametro Disable lost resources. Questo riguarda host, item e trigger persi.

Le risorse perse possono essere automaticamente eliminate in base al valore del parametro Delete lost resources. Questo riguarda host, gruppi di host, item, trigger e grafici persi.

Quando le entità rilevate diventano 'Not discovered anymore', nell'elenco delle entità viene visualizzato un indicatore di durata. Spostando il puntatore del mouse su di esso, verrà visualizzato un messaggio che ne indica i dettagli di stato.

Se le entità sono state contrassegnate per l'eliminazione, ma non sono state eliminate nel momento previsto (regola di discovery o host dell'item disabilitati), verranno eliminate la volta successiva in cui la regola di discovery verrà elaborata.

Le entità che contengono altre entità contrassegnate per l'eliminazione non verranno aggiornate se modificate a livello di regola di discovery. Ad esempio, i trigger basati su LLD non verranno aggiornati se contengono item contrassegnati per l'eliminazione.

Altri tipi di discovery

Maggiori dettagli e istruzioni su altri tipi di discovery pronti all'uso sono disponibili nelle sezioni seguenti:

• discovery di interfacce di rete
• discovery di CPU e core della CPU
• discovery di OID SNMP
• discovery di oggetti JMX;
• discovery tramite query SQL ODBC
• discovery di servizi Windows
• discovery di interfacce host in Zabbix

Per maggiori dettagli sul formato JSON per gli item di discovery e un esempio su come implementare il proprio rilevatore di file system come script Perl, vedere creazione di regole LLD personalizzate.