3 Individuazione di basso livello

Panoramica

La low-level discovery (LLD) rileva automaticamente le entità (ad esempio, file system, interfacce di rete) su un host e crea i corrispondenti item, trigger e grafici senza configurazione manuale per ciascuno.

Per usare la LLD, si crea una regola di discovery che raccoglie dati JSON che descrivono le entità e dei prototype (item, trigger e graph) per ogni entità.

Il JSON restituito dalla regola deve essere un array di oggetti, in cui ogni oggetto rappresenta una singola entità rilevata tramite coppie chiave-valore. Ad esempio, una regola di discovery con net.if.discovery potrebbe restituire:

[
  {"{#IFNAME}": "lo"},
  {"{#IFNAME}": "eth0"}
]

Da questo viene quindi creato un insieme corrispondente di item, trigger e grafici a partire dai prototype: uno per ogni interfaccia (lo e eth0).

Se gli oggetti contengono chiavi nel formato {#MACRO}, tali macro vengono usate direttamente nei prototype. In caso contrario, oppure se sono necessarie macro aggiuntive/personalizzate, le macro possono essere definite manualmente e mappate ai campi JSON tramite JSONPath.

La LLD può anche creare host (ad esempio, per macchine virtuali rilevate su un hypervisor) e supporta regole di discovery nidificate per il discovery multilivello.

Le entità che non vengono più rilevate possono essere automaticamente disabilitate o eliminate.

Configurazione della discovery a basso livello

Illustreremo la discovery a basso livello con un esempio di discovery del file system.

Per configurare la discovery, procedere come segue:

1. Andare su Data collection > Templates o Hosts.
2. Fare clic su Discovery nella riga del template/host appropriato.

3. Fare clic su Create discovery rule nell'angolo in alto a destra della schermata.
4. Compilare il modulo della regola di discovery con i dettagli richiesti.

Regola di discovery

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

• Discovery rule - specifica, soprattutto, l'item incorporato o lo script personalizzato da usare per recuperare i dati di discovery.
• Preprocessing - applica alcuni passaggi di preprocessing ai dati scoperti.
• LLD macros - consente di estrarre alcuni valori macro da usare negli item scoperti, nei trigger, ecc.
• Filters - consente di filtrare i valori scoperti.
• Overrides - consente di modificare item, trigger, grafici o prototipi di host quando si applicano a oggetti scoperti specifici.

La scheda Discovery rule contiene la chiave dell'item da usare per la discovery, oltre ad alcuni attributi generali della regola di discovery:

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 LLD macros consente di specificare macro personalizzate per la discovery a basso livello.

Le macro personalizzate sono utili nei casi in cui il JSON restituito non contenga già definite le macro richieste. Ad esempio:

• La chiave nativa vfs.fs.discovery per la discovery dei filesystem restituisce un JSON con alcune macro LLD predefinite, come {#FSNAME}, {#FSTYPE}. Queste macro possono essere usate direttamente in item, prototipi di trigger (vedi le sezioni successive della pagina); non è necessario definire macro personalizzate;
• L'item vfs.fs.get dell'agent restituisce anch'esso un JSON con dati del filesystem, ma senza macro LLD predefinite. In questo caso è possibile definire le macro manualmente e associarle ai valori nel JSON usando JSONPath:

I valori estratti possono essere usati in item scoperti, trigger, ecc. Nota che i valori verranno estratti dal risultato della discovery e da eventuali 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 Filters contiene le definizioni del filtro della regola di discovery, consentendo di filtrare i valori di discovery:

Ad esempio, se sei interessato solo ai file system C:, D: ed E:, puoi inserire {#FSNAME} nel campo Macro e ^C|^D|^E nel campo Regular expression.
Il filtraggio è possibile anche per i tipi di file system usando la macro {#FSTYPE} (ad esempio ^ext|^reiserfs) e per i tipi di unità disco (supportato solo da Windows agent) usando la macro {#FSDRIVETYPE} (ad esempio fixed).

Per testare un'espressione regolare puoi usare grep -E, ad esempio:

for f in ext2 nfs reiserfs smbfs; 
do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; 
done

Override

La scheda Overrides consente di impostare regole per modificare l'elenco dei prototipi di item, trigger, graph e host 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 quattro tipi di oggetti: Item prototype Trigger prototype Graph prototype Host prototype
Condition			Consente di filtrare le entità a cui deve essere applicata l'operazione.
	Operator		Operatori supportati: equals - applica a questo prototype does not equal - applica a tutti i prototype, tranne questo contains - applica se il nome del prototype contiene questa stringa does not contain - applica se il nome del prototype non contiene questa stringa matches - applica se il nome del prototype corrisponde all'espressione regolare does not match - applica se il nome del prototype 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, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototype dell'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, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototype dell'item: Yes - l'item verrà aggiunto. No - l'item non verrà aggiunto.
		Update interval	Quando la casella di controllo è selezionata, verranno visualizzate due opzioni che consentono di impostare un intervallo diverso per l'item: Delay - intervallo di aggiornamento dell'item. Sono supportati user macros, LLD macros e time suffixes (ad esempio 30s, 1m, 2h, 1d) (il supporto delle LLD macro è stato ripristinato in Zabbix 7.0.27). Deve essere impostato su 0 se si usa 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, verranno 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 (il supporto delle LLD macro è stato ripristinato in Zabbix 7.0.27).
		Trends	Quando la casella di controllo è selezionata, verranno 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 (il supporto delle LLD macro è stato ripristinato in Zabbix 7.0.27).
		Tags	Quando la casella di controllo è selezionata, verrà visualizzato un nuovo blocco che consente di specificare coppie tag-valore. Sono supportati user macros e LLD macros. Questi tag verranno aggiunti ai tag specificati nel prototype dell'item, anche se i nomi dei tag coincidono.
	Object: Trigger prototype
		Create enabled	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototype del 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, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototype del trigger: Yes - il trigger verrà aggiunto. No - il trigger non verrà aggiunto.
		Severity	Quando la casella di controllo è selezionata, verranno 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. Sono supportati user macros e LLD macros. Questi tag verranno aggiunti ai tag specificati nel prototype del trigger, anche se i nomi dei tag coincidono.
	Object: Graph prototype
		Discover	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototype del graph: Yes - il graph verrà aggiunto. No - il graph non verrà aggiunto.
	Object: Host prototype
		Create enabled	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototype dell'host: Yes - l'host verrà creato in stato abilitato. No - l'host verrà creato in stato disabilitato.
		Discover	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototype dell'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 prototype dell'host.
		Tags	Quando la casella di controllo è selezionata, verrà visualizzato un nuovo blocco che consente di specificare coppie tag-valore. Sono supportati user macros e LLD macros. Questi tag verranno aggiunti ai tag specificati nel prototype dell'host, anche se i nomi dei tag coincidono.
		Host inventory	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di selezionare un diverso mode di inventory per il prototype dell'host: Disabled - non compilare l'host inventory Manual - fornire i dettagli manualmente Automated - compilare automaticamente i dati dell'host inventory 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.