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:

• Regola di discovery - specificare, soprattutto, l'item integrato o lo script personalizzato per recuperare i dati di discovery.
• Preprocessing - applicare il preprocessing ai dati rilevati.
• Macro LLD - consentire l'estrazione dei valori delle macro da utilizzare negli item rilevati, nei trigger e così via.
• Filtri - consentire il filtraggio dei valori rilevati.
• Override - consentire la modifica di item, trigger, grafici o prototipi di host quando vengono applicati a oggetti rilevati specifici.

La scheda Regola di discovery contiene la chiave dell'item da utilizzare 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 le regole di trasformazione da applicare al risultato della discovery. In questo passaggio è possibile utilizzare una o più trasformazioni. Le trasformazioni vengono eseguite nell'ordine in cui sono definite. Tutto il preprocessing viene eseguito dal server Zabbix.

Vedere anche:

• Dettagli del preprocessing
• Test del preprocessing

Si noti che, se la discovery rule è stata applicata al host tramite un 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 Filtri contiene le definizioni dei filtri delle regole di discovery che consentono di filtrare i valori rilevati:

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 Espressione regolare.
È inoltre possibile filtrare in base ai tipi di file system utilizzando la macro {#FSTYPE} (ad esempio, ^ext|^reiserfs) e in base ai tipi di unità (supportati solo dall'agent Windows) utilizzando la macro {#FSDRIVETYPE} (ad esempio, fixed).

Per testare un'espressione regolare è possibile utilizzare grep -E, ad esempio:

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

Sovrascritture

La scheda Sovrascritture consente di impostare regole per modificare l'elenco dei prototipi di item, trigger, grafici, host e discovery, oppure i relativi attributi, per gli oggetti rilevati che soddisfano determinati criteri.

Le sovrascritture, se presenti, vengono visualizzate in un elenco riordinabile tramite trascinamento e vengono eseguite nell'ordine in cui sono definite. Per configurare i dettagli di una nuova sovrascrittura, fare clic su nel blocco Sovrascritture. Per modificare una sovrascrittura esistente, fare clic sul nome della sovrascrittura. Si aprirà una finestra popup che consente di modificare i dettagli della regola di sovrascrittura.

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 Operazioni. Per modificare un'operazione esistente, fare clic su accanto all'operazione. Si aprirà una finestra popup in cui è possibile modificare i dettagli dell'operazione.

Parametro			Descrizione
Oggetto			Sono disponibili cinque tipi di oggetti: Prototipo di item Prototipo di trigger Prototipo di grafico Prototipo di host Prototipo di discovery
Condizione			Consente di filtrare le entità a cui deve essere applicata l'operazione.
	Operatore		Operatori supportati: è uguale a - applica a questo prototipo non è uguale a - applica a tutti i prototipi tranne questo contiene - applica se il nome del prototipo contiene questa stringa non contiene - applica se il nome del prototipo non contiene questa stringa corrisponde - applica se il nome del prototipo corrisponde a un'espressione regolare non corrisponde - applica se il nome del prototipo non corrisponde a un'espressione regolare
	Pattern		Un'espressione regolare o una stringa da cercare.
	Oggetto: Prototipo di item
		Crea abilitato	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di item: Sì - l'item verrà aggiunto in stato abilitato. No - l'item verrà aggiunto a un'entità rilevata, ma in stato disabilitato.
		Rileva	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di item: Sì - l'item verrà aggiunto. No - l'item non verrà aggiunto.
		Intervallo di aggiornamento	Quando la casella è selezionata, vengono visualizzate due opzioni che consentono di impostare un intervallo diverso per l'item: Ritardo - intervallo di aggiornamento dell'item. Sono supportate le macro utente, le macro LLD e i suffissi temporali (ad es. 30s, 1m, 2h, 1d). Deve essere impostato su 0 se viene utilizzato Intervallo personalizzato. Intervallo personalizzato - fare clic su per specificare intervalli flessibili o pianificati. Per informazioni dettagliate, vedere Intervalli personalizzati.
		Cronologia	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di impostare periodi diversi di conservazione della cronologia per l'item: Non memorizzare - se selezionato, la cronologia non verrà memorizzata. Memorizza fino a - se selezionato, a destra verrà visualizzato un campo di input per specificare il periodo di conservazione. Sono supportate le macro utente e le macro LLD.
		Trend	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di impostare periodi diversi di conservazione dei trend per l'item: Non memorizzare - se selezionato, i trend non verranno memorizzati. Memorizza fino a - se selezionato, a destra verrà visualizzato un campo di input per specificare il periodo di conservazione. Sono supportate le macro utente e le macro LLD.
		Tag	Quando la casella è selezionata, viene visualizzato un nuovo blocco che consente di specificare coppie tag-valore. Sono supportate le macro utente e le macro LLD. Questi tag verranno aggiunti ai tag specificati nel prototipo di item, anche se i nomi dei tag coincidono.
	Oggetto: Prototipo di trigger
		Crea abilitato	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di trigger: Sì - il trigger verrà aggiunto in stato abilitato. No - il trigger verrà aggiunto a un'entità rilevata, ma in stato disabilitato.
		Rileva	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di trigger: Sì - il trigger verrà aggiunto. No - il trigger non verrà aggiunto.
		Gravità	Quando la casella è selezionata, vengono visualizzati i pulsanti della gravità del trigger, che consentono di modificarne la gravità.
		Tag	Quando la casella è selezionata, viene visualizzato un nuovo blocco che consente di specificare coppie tag-valore. Sono supportate le macro utente e le macro LLD. Questi tag verranno aggiunti ai tag specificati nel prototipo di trigger, anche se i nomi dei tag coincidono.
	Oggetto: Prototipo di grafico
		Rileva	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di grafico: Sì - il grafico verrà aggiunto. No - il grafico non verrà aggiunto.
	Oggetto: Prototipo di host
		Crea abilitato	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di host: Sì - l'host verrà creato in stato abilitato. No - l'host verrà creato in stato disabilitato.
		Rileva	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di host: Sì - l'host verrà rilevato. No - l'host non verrà rilevato.
		Collega template	Quando la casella è selezionata, viene visualizzato un campo di input per specificare i template. Iniziare a digitare il nome del template oppure fare clic su Seleziona accanto al campo e selezionare i template dall'elenco in una finestra popup. I template di questa sovrascrittura vengono aggiunti a tutti i template già collegati al prototipo di host.
		Tag	Quando la casella è selezionata, viene visualizzato un nuovo blocco che consente di specificare coppie tag-valore. Sono supportate le macro utente e le macro LLD. Questi tag verranno aggiunti ai tag specificati nel prototipo di host, anche se i nomi dei tag coincidono.
		Inventario dell'host	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di selezionare una diversa modalità di inventario per il prototipo di host: Disabilitato - non compilare l'inventario dell'host Manuale - fornire manualmente i dettagli Automatico - compilare automaticamente i dati dell'inventario dell'host in base alle metriche raccolte.
	Oggetto: Prototipo di discovery
		Crea abilitato	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di discovery: Sì - la regola di discovery verrà aggiunta in stato abilitato. No - la regola di discovery verrà aggiunta in stato disabilitato.
		Rileva	Quando la casella è selezionata, vengono visualizzati i pulsanti che consentono di sovrascrivere le impostazioni originali del prototipo di discovery: Sì - la regola di discovery verrà aggiunta. No - la regola di discovery non verrà aggiunta.
		Intervallo di aggiornamento	Quando la casella è selezionata, vengono visualizzate due opzioni che consentono di impostare un intervallo diverso per la regola di discovery: Ritardo - intervallo di aggiornamento della regola. Sono supportate le macro utente, le macro LLD e i suffissi temporali (ad es. 30s, 1m, 2h, 1d). Deve essere impostato su 0 se viene utilizzato Intervallo personalizzato. Intervallo personalizzato - fare clic su per specificare intervalli flessibili o pianificati. Per informazioni dettagliate, vedere Intervalli personalizzati.

Pulsanti del modulo

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

	Aggiunge una regola di discovery. Questo pulsante è disponibile solo per le nuove regole di discovery.
	Aggiorna le proprietà di una regola di discovery. Questo pulsante è disponibile solo per le regole di discovery esistenti.
	Crea un'altra regola di discovery basata sulle proprietà della regola di discovery corrente.
	Esegue immediatamente la discovery in base alla regola di discovery. La regola di discovery deve già esistere. Vedere ulteriori dettagli. Nota che, quando si esegue immediatamente la discovery, la cache di configurazione non viene aggiornata; pertanto, il risultato non rifletterà le modifiche più recenti alla configurazione della regola di discovery.
	Verifica la configurazione della regola di discovery. Utilizzare questo pulsante per verificare le impostazioni di configurazione, come la connettività e la correttezza dei parametri, senza applicare definitivamente alcuna modifica.
	Elimina la regola di discovery.
	Annulla la modifica delle proprietà della regola di discovery.

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.