3 Individuazione di basso livello

Panoramica

La discovery a basso livello (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 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à rilevata tramite coppie chiave-valore. Ad esempio, una regola di discovery con net.if.discovery potrebbe restituire:

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

Da questo insieme di prototype viene quindi creato un corrispondente set di item, trigger e grafici: 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 annidate per la 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 in 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 quale item integrato o script personalizzato utilizzare 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 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 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 all'host tramite un 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 contenga già le macro necessarie. Ad esempio:

• La chiave nativa vfs.fs.discovery per il discovery 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 dati del filesystem, ma senza macro LLD predefinite. In questo caso è possibile definire autonomamente le macro e associarle ai valori nel JSON utilizzando JSONPath:

I valori estratti possono essere utilizzati negli item, nei trigger e così via rilevati. Si noti che i valori verranno estratti dal risultato del discovery 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 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

Override

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

Gli Override, se presenti, vengono visualizzati in un elenco riordinabile tramite trascinamento e vengono eseguiti nell'ordine in cui sono definiti. Per configurare i dettagli di un nuovo override, fare clic su nel blocco Override. 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 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 - applica a questo prototipo diverso da - 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
		Creazione abilitata	Quando la casella di controllo è 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 di controllo è 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 di controllo è 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 esempio 30s, 1m, 2h, 1d) (il supporto per le macro LLD è stato ripristinato in Zabbix 7.4.11). 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 di controllo è selezionata, vengono visualizzati i pulsanti che consentono di impostare un periodo di conservazione diverso per la cronologia dell'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 (il supporto per le macro LLD è stato ripristinato in Zabbix 7.4.11).
		Trend	Quando la casella di controllo è selezionata, vengono visualizzati i pulsanti che consentono di impostare un periodo di conservazione diverso per i trend dell'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 (il supporto per le macro LLD è stato ripristinato in Zabbix 7.4.11).
		Tag	Quando la casella di controllo è 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
		Creazione abilitata	Quando la casella di controllo è 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 di controllo è 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 di controllo è selezionata, vengono visualizzati i pulsanti della gravità del trigger, che consentono di modificare la gravità del trigger.
		Tag	Quando la casella di controllo è 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 di controllo è 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
		Creazione abilitata	Quando la casella di controllo è 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 di controllo è 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 di controllo è 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 questo override vengono aggiunti a tutti i template già collegati al prototipo di host.
		Tag	Quando la casella di controllo è 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 di controllo è selezionata, vengono visualizzati i pulsanti che consentono di selezionare una modalità di inventario diversa 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
		Creazione abilitata	Quando la casella di controllo è 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 di controllo è 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 di controllo è 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 esempio 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.