Configurazione di un trigger
Questa pagina descrive come configurare un trigger nel frontend di Zabbix.
Si noti che i template ufficiali di Zabbix contengono trigger predefiniti.
Vedere la guida per applicare il template a monitor Linux.
È inoltre possibile aggiornare in massa i trigger configurati.
Altre risorse:
- Rilevamento dei problemi con i trigger (introduzione generale)
- Esempi di trigger (per caso d'uso)
- Espressione e funzioni del trigger (dettagli sulla sintassi)
- Best practice
Configurazione
Per configurare un trigger, procedere come segue:
- Andare su Raccolta dati > Host.
- Fare clic su Trigger nella riga dell'host.
- Fare clic su Crea trigger a destra (oppure sul nome del trigger per modificare un trigger esistente).
- Inserire i parametri del trigger nel modulo.
La scheda Trigger contiene tutti gli attributi essenziali del trigger.
Tutti i campi obbligatori sono contrassegnati da un asterisco rosso.
| Parametro | Descrizione |
|---|---|
| Nome | Nome del trigger. Le macro supportate sono: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.VALUE.AGE}, {ITEM.VALUE.DATE}, {ITEM.VALUE.TIME}, {ITEM.VALUE.TIMESTAMP}, {ITEM.LASTVALUE}, {ITEM.LASTVALUE.AGE}, {ITEM.LASTVALUE.DATE}, {ITEM.LASTVALUE.TIME}, {ITEM.LASTVALUE.TIMESTAMP}, {ITEM.LOG.*} e le macro utente {$MACRO}. Le macro $1, $2...$9 possono essere utilizzate per fare riferimento alla prima, seconda... nona costante dell'espressione. Nota: le macro $1-$9 vengono risolte correttamente se fanno riferimento a costanti in espressioni relativamente semplici e lineari. Ad esempio, il nome "Carico del processore superiore a $1 su {HOST.NAME}" cambierà automaticamente in "Carico del processore superiore a 5 su Nuovo host" se l'espressione è last(/Nuovo host/system.cpu.load[percpu,avg1])>5. |
| Nome evento | Se definito, questo nome verrà utilizzato per creare il nome dell'evento di problema. Per impostazione predefinita, il nome dell'evento è uguale al nome del trigger. Il nome dell'evento può essere utilizzato per creare avvisi significativi contenenti dati sul problema (vedere l'esempio). È supportato lo stesso insieme di macro del nome del trigger, oltre alle macro di espressione {TIME}, {TIMESTAMP} e {?EXPRESSION}. |
| Dati operativi | Inserire una stringa (fino a 2048 caratteri) con macro per visualizzare dati dinamici in tempo reale in Monitoraggio > Problemi. In alternativa, lasciare vuoto questo campo per visualizzare gli ultimi valori di tutti gli item dell'espressione del trigger. È supportato lo stesso insieme di macro del nome del trigger, con la possibilità di risolverle dinamicamente. Ad esempio: {ITEM.VALUE<1-9>} restituisce i valori degli item nel momento in cui cambia lo stato del trigger (problema creato, risolto, chiuso manualmente o chiuso dalla correlazione). {ITEM.LASTVALUE<1-9>} restituisce gli ultimi valori degli item. La chiusura manuale di un problema non produce un nuovo valore, quindi entrambe le macro continueranno a mostrare il valore relativo al momento del problema. Inoltre, entrambe le macro restituiscono UNKNOWN se l'ultimo valore è più vecchio del Periodo massimo di visualizzazione della cronologia (vedere Amministrazione > Generale). La funzione macro jsonpath non è supportata nel frontend, quindi restituisce UNKNOWN in Monitoraggio > Problemi; viene risolta solo dal server Zabbix, ad esempio quando {EVENT.OPDATA} viene utilizzata nelle notifiche. |
| Gravità | Impostare la gravità richiesta del trigger facendo clic sui pulsanti. |
| Espressione | Espressione logica utilizzata per definire le condizioni di un problema. Sono supportati i suffissi temporali e i suffissi per le dimensioni di memoria. Un problema viene creato dopo che tutte le condizioni incluse nell'espressione sono soddisfatte, ovvero quando l'espressione restituisce TRUE. Il problema verrà risolto non appena l'espressione restituisce FALSE, a meno che non siano specificate condizioni di ripristino aggiuntive in Espressione di ripristino. |
| Generazione dell'evento OK | Opzioni per la generazione dell'evento OK: Espressione - gli eventi OK vengono generati in base alla stessa espressione degli eventi di problema; Espressione di ripristino - gli eventi OK vengono generati se l'espressione del problema restituisce FALSE e l'espressione di ripristino restituisce TRUE; Nessuna - in questo caso il trigger non tornerà mai autonomamente allo stato OK. |
| Espressione di ripristino | Espressione logica (facoltativa) che definisce condizioni aggiuntive da soddisfare prima che il problema venga risolto, dopo che l'espressione del problema originale è già stata valutata come FALSE. L'espressione di ripristino è utile per l'isteresi del trigger. Non è possibile risolvere un problema utilizzando solo l'espressione di ripristino se l'espressione del problema è ancora TRUE. Questo campo è disponibile solo se per Generazione dell'evento OK è selezionata l'opzione 'Espressione di ripristino'. |
| Modalità di generazione dell'evento PROBLEM | Modalità di generazione degli eventi di problema: Singolo - viene generato un singolo evento quando un trigger entra per la prima volta nello stato 'Problema'; Multiplo - viene generato un evento a ogni valutazione 'Problema' del trigger. |
| Chiusura dell'evento OK | Selezionare cosa chiude l'evento OK: Tutti i problemi - tutti i problemi di questo trigger; Tutti i problemi se i valori dei tag corrispondono - solo i problemi del trigger con valori dei tag evento corrispondenti. |
| Tag per la corrispondenza | Inserire il nome del tag evento da utilizzare per la correlazione degli eventi. Questo campo viene visualizzato se per la proprietà Chiusura dell'evento OK è selezionata l'opzione 'Tutti i problemi se i valori dei tag corrispondono' ed è obbligatorio in questo caso. |
| Consenti chiusura manuale | Selezionare per consentire la chiusura manuale degli eventi di problema generati da questo trigger. La chiusura manuale è possibile durante il riconoscimento degli eventi di problema. |
| Nome della voce di menu | Se non vuoto, il nome inserito qui (fino a 64 caratteri) viene utilizzato in diverse posizioni del frontend come etichetta per l'URL del trigger specificato nel parametro URL della voce di menu. Se vuoto, viene utilizzato il nome predefinito URL del trigger. È supportato lo stesso insieme di macro del nome del trigger, oltre a {EVENT.ID}, {HOST.ID} e {TRIGGER.ID}. |
| URL della voce di menu | Se non vuoto, l'URL inserito qui (fino a 2048 caratteri) è disponibile come collegamento nel menu degli eventi in diverse posizioni del frontend, ad esempio facendo clic sul nome del problema in Monitoraggio > Problemi o nel widget dashboard Problemi. È supportato lo stesso insieme di macro del nome del trigger, oltre a {EVENT.ID}, {HOST.ID} e {TRIGGER.ID}. Nota: le macro utente con valori segreti non verranno risolte nell'URL. |
| Descrizione | Campo di testo utilizzato per fornire ulteriori informazioni su questo trigger. Può contenere istruzioni per risolvere un problema specifico, i recapiti del personale responsabile e così via. È supportato lo stesso insieme di macro del nome del trigger. |
| Abilitato | Deselezionare questa casella per disabilitare il trigger, se necessario. I problemi di un trigger disabilitato non vengono più visualizzati nel frontend, ma non vengono eliminati. |
La scheda Tag consente di definire i tag a livello di trigger.
Tutti i problemi di questo trigger verranno contrassegnati con i valori inseriti qui.
Inoltre, l'opzione Tag ereditati e del trigger consente di visualizzare i tag definiti a livello di template se il trigger proviene da quel template. Se sono presenti più template con lo stesso tag, questi tag vengono visualizzati una sola volta e i nomi dei template sono separati da virgole. Un trigger non "eredita" né visualizza i tag a livello di host.
| Parametro | Descrizione |
|---|---|
| Nome/Valore | Impostare tag personalizzati per contrassegnare gli eventi del trigger. I tag sono costituiti da una coppia di nome e valore. È possibile utilizzare solo il nome oppure associarlo a un valore. Un trigger può avere più tag con lo stesso nome ma valori diversi. Nei tag evento sono supportate le macro utente, le macro utente con contesto, le macro di low-level discovery e le funzioni delle macro con {{ITEM.VALUE}}, {{ITEM.LASTVALUE}}. Le macro di low-level discovery possono essere utilizzate all'interno del contesto della macro.La macro {TRIGGER.ID} è supportata nei valori dei tag del trigger. Può essere utile per identificare i trigger creati dai prototipi di trigger e, ad esempio, sopprimere i problemi generati da questi trigger durante la manutenzione. Se la lunghezza totale del valore espanso supera 255 caratteri, verrà troncata a 255 caratteri. Vedere tutte le macro supportate per i tag evento. I tag evento possono essere utilizzati per la correlazione degli eventi e nelle condizioni delle azioni; saranno inoltre visibili in Monitoraggio > Problemi o nel widget Problemi. |
La scheda Dipendenze contiene tutte le dipendenze del trigger.
Fare clic su Aggiungi per aggiungere una nuova dipendenza.
È inoltre possibile configurare un trigger aprendo un trigger esistente, facendo clic sul pulsante Clona e salvandolo con un nome diverso.
Test dell'espressione del trigger
È possibile testare quale sarebbe il risultato dell'espressione in base al valore ricevuto.
La seguente espressione, tratta da un template ufficiale, viene usata come esempio:
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
or
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}Per testare l'espressione, fare clic su Expression constructor sotto il campo dell'espressione.
Nell'Expression constructor, tutte le singole espressioni sono elencate. Per aprire la finestra di test, fare clic su Test sotto l'elenco delle espressioni.
Nella finestra di test è possibile inserire valori di esempio ('80', '70', '0', '1' in questo esempio) e quindi vedere il risultato dell'espressione, facendo clic sul pulsante Test.
È possibile vedere il risultato delle singole espressioni, così come dell'intera espressione.
"TRUE" significa che l'espressione specificata è corretta.
In questo caso A, "80" è maggiore del valore specificato {$TEMP_WARN}, "70" in questo esempio.
Come previsto, viene visualizzato un risultato "TRUE".
"FALSE" significa che l'espressione specificata non è corretta.
In questo caso B, {$TEMP_WARN_STATUS} "1" deve essere uguale al valore specificato, "0" in questo esempio.
Come previsto, viene visualizzato un risultato "FALSE".
Il tipo di espressione scelto è "OR". Se almeno una delle condizioni specificate (A o B in questo caso) è TRUE, anche il risultato complessivo sarà TRUE. Ciò significa che il valore corrente supera il valore di avviso e si è verificato un problema.