Scoperta a basso livello

Panoramica

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

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

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

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

Un insieme corrispondente di item, trigger e grafici viene quindi creato 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.

LLD può anche creare host (ad esempio, per macchine virtuali rilevate su un hypervisor) e supporta regole di discovery nidificate per il rilevamento 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, trigger, ecc. scoperti.
• 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 LLD macros personalizzate quando il JSON restituito non contiene già chiavi nel formato {#MACRO}.

Ad esempio, la chiave dell'item agent vfs.fs.get restituisce dati JSON filesystem senza alcuna LLD macro predefinita.
Qui, si definiscono manualmente le macro e le si mappano ai valori nel JSON usando espressioni JSONPath:

La regola di discovery deve restituire un array JSON alla radice ($.).
Per compatibilità con le versioni precedenti, è accettato anche un oggetto JSON contenente un singolo array "data". In questo caso, l'array "data" viene automaticamente estratto:

{"data":[{"foo":"bar"}, {"foo":"baz"}]}

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 si è interessati solo ai file system C:, D: ed E:, è possibile inserire {#FSNAME} nel campo Macro e ^C|^D|^E nel campo Regular expression.
Il filtraggio è possibile anche in base ai tipi di file system usando la macro {#FSTYPE} (ad esempio ^ext|^reiserfs) e in base ai tipi di unità disco (supportato solo da Windows agent) usando la macro {#FSDRIVETYPE} (ad esempio fixed).

Per testare un'espressione regolare è possibile 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 di item, trigger, graph, host e discovery prototype, oppure i relativi attributi, per gli oggetti rilevati che soddisfano criteri specifici.

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 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 dell'item prototype: Yes - l'item verrà aggiunto in stato abilitato. No - l'item verrà aggiunto a un'entità rilevata, ma in stato disabilitato.
		Discover	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali dell'item prototype: 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). Deve essere impostato a 0 se viene usato Custom interval. Custom interval - fare clic su per specificare intervalli flessibili o 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.
		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.
		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 nell'item prototype, 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 trigger prototype: Yes - il trigger verrà aggiunto in stato abilitato. No - il trigger verrà aggiunto a un'entità rilevata, ma in stato disabilitato.
		Discover	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del trigger prototype: 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 trigger prototype, 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 graph prototype: 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 host prototype: 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 host prototype: Yes - l'host verrà rilevato. No - l'host non verrà rilevato.
		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 host prototype.
		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 host prototype, 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 host prototype: 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.
	Object: Discovery prototype
		Create enabled	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del discovery prototype: Yes - la regola di discovery verrà aggiunta in stato abilitato. No - la regola di discovery verrà aggiunta in stato disabilitato.
		Discover	Quando la casella di controllo è selezionata, verranno visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del discovery prototype: Yes - la regola di discovery verrà aggiunta. No - la regola di discovery non verrà aggiunta.
		Update interval	Quando la casella di controllo è selezionata, verranno visualizzate due opzioni che consentono di impostare un intervallo diverso per la regola di discovery: Delay - intervallo di aggiornamento della regola. Sono supportati user macros, LLD 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 o pianificati. Per informazioni dettagliate, vedere Custom intervals.

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.