1 Configurazione di un trigger
Panoramica
Per configurare un trigger, procedere come segue:
- Andare in: Data collection > Hosts
- Fare clic su Triggers nella riga dell'host
- Fare clic su Create trigger a destra (oppure sul nome del trigger per modificare un trigger esistente)
- Immettere i parametri del trigger nel modulo
Vedere anche informazioni generali sui trigger e sui relativi tempi di calcolo.
Configurazione
La scheda Trigger contiene tutti gli attributi essenziali del trigger.
Tutti i campi di input obbligatori sono contrassegnati da un asterisco rosso.
| Parameter | Description |
|---|---|
| Name | Nome del trigger. I macro supportati 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 i macro utente {$MACRO}. I macro $1, $2...$9 possono essere usati per fare riferimento alla prima, seconda...nona costante dell'espressione. Nota: i macro $1-$9 verranno risolti correttamente se fanno riferimento a costanti in espressioni relativamente semplici e dirette. Ad esempio, il nome "Processor load above $1 on {HOST.NAME}" verrà automaticamente modificato in "Processor load above 5 on New host" se l'espressione è last(/New host/system.cpu.load[percpu,avg1])>5. |
| Event name | Quando definito, questo nome verrà usato 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 usato per creare avvisi significativi contenenti i dati del problema (vedere l'esempio). È supportato lo stesso insieme di macro del nome del trigger, oltre ai macro di espressione {TIME}, {TIMESTAMP} e {?EXPRESSION}. |
| Operational data | Inserire una stringa con macro per visualizzare dati dinamici in tempo reale in Monitoring > Problems. 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 risoluzione dinamica. Ad esempio: {ITEM.VALUE<1-9>} si risolve nei valori dell'item nel momento in cui lo stato del trigger cambia (problema creato, risolto, chiuso manualmente o chiuso per correlazione). {ITEM.LASTVALUE<1-9>} si risolve negli ultimi valori dell'item. Si noti che la chiusura manuale di un problema non produce un nuovo valore, quindi entrambe le macro continueranno a mostrare il valore del momento del problema. Si noti inoltre che entrambe le macro si risolvono in UNKNOWN se l'ultimo valore è più vecchio del Max history display period (vedere Administration > General). |
| Severity | Impostare la severity del trigger richiesta facendo clic sui pulsanti. |
| Expression | Espressione logica usata per definire le condizioni di un problema. Sono supportati i suffissi di tempo e i suffissi della dimensione della memoria. Un problema viene creato dopo che tutte le condizioni incluse nell'espressione sono soddisfatte, cioè quando l'espressione viene valutata come TRUE. Il problema verrà risolto non appena l'espressione viene valutata come FALSE, a meno che non siano specificate condizioni di ripristino aggiuntive in Recovery expression. |
| OK event generation | Opzioni di generazione degli eventi OK: Expression - gli eventi OK vengono generati in base alla stessa espressione degli eventi di problema; Recovery expression - gli eventi OK vengono generati se l'espressione del problema viene valutata come FALSE e l'espressione di ripristino viene valutata come TRUE; None - in questo caso il trigger non tornerà mai autonomamente allo stato OK. |
| Recovery expression | Espressione logica (facoltativa) che definisce condizioni aggiuntive che devono essere soddisfatte 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 solo con l'espressione di ripristino se l'espressione del problema è ancora TRUE. Questo campo è disponibile solo se per OK event generation è selezionato 'Recovery expression'. |
| PROBLEM event generation mode | Modalità di generazione degli eventi di problema: Single - viene generato un singolo evento quando un trigger entra per la prima volta nello stato 'Problem'; Multiple - viene generato un evento a ogni valutazione 'Problem' del trigger. |
| OK event closes | Selezionare se l'evento OK chiude: All problems - tutti i problemi di questo trigger; All problems if tag values match - solo i problemi del trigger con valori dei tag evento corrispondenti. |
| Tag for matching | Inserire il nome del tag evento da usare per la correlazione degli eventi. Questo campo viene visualizzato se è selezionato 'All problems if tag values match' per la proprietà OK event closes ed è obbligatorio in questo caso. |
| Allow manual close | Selezionare per consentire la chiusura manuale degli eventi di problema generati da questo trigger. La chiusura manuale è possibile quando si riconoscono gli eventi di problema. |
| Menu entry name | Se non vuoto, il nome inserito qui (fino a 64 caratteri) viene usato in diverse posizioni del frontend come etichetta per l'URL del trigger specificato nel parametro Menu entry URL. Se vuoto, viene usato il nome predefinito Trigger URL. È supportato lo stesso insieme di macro del nome del trigger, oltre a {EVENT.ID}, {HOST.ID} e {TRIGGER.ID}. |
| Menu entry URL | Se non vuoto, l'URL inserito qui (fino a 2048 caratteri) è disponibile come collegamento nel menu eventi in diverse posizioni del frontend, ad esempio quando si fa clic sul nome del problema in Monitoring > Problems o nel widget dashboard Problems. È supportato lo stesso insieme di macro del nome del trigger, oltre a {EVENT.ID}, {HOST.ID} e {TRIGGER.ID}. Nota: i macro utente con valori segreti non verranno risolti nell'URL. |
| Description | Campo di testo usato per fornire ulteriori informazioni su questo trigger. Può contenere istruzioni per risolvere un problema specifico, i dettagli di contatto del personale responsabile, ecc. È supportato lo stesso insieme di macro del nome del trigger. |
| Enabled | 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 Tags consente di definire tag a livello di trigger. Tutti i problemi di questo trigger saranno contrassegnati con i valori inseriti qui.
Inoltre, l'opzione Inherited and trigger tags 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.
| Parameter | Description |
|---|---|
| Name/Value | Impostare tag personalizzati per contrassegnare gli eventi del trigger. I tag sono una coppia composta da nome e valore del tag. È possibile usare solo il nome oppure associarlo a un valore. Un trigger può avere più tag con lo stesso nome, ma valori diversi. Sono supportati macro utente, macro utente con contesto, macro di discovery a basso livello e macro functions con {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} nei tag evento. Le macro di discovery a basso livello possono essere usate all'interno del contesto del macro.La macro {TRIGGER.ID} è supportata nei valori dei tag del trigger. Può essere utile per identificare i trigger creati da prototipi di trigger e, ad esempio, sopprimere i problemi di questi trigger durante la manutenzione. Se la lunghezza totale del valore espanso supera 255, verrà troncata a 255 caratteri. Vedere tutti i macro supportati per i tag evento. I tag evento possono essere usati per la correlazione degli eventi, nelle condizioni delle azioni e saranno visibili anche in Monitoring > Problems o nel widget Problems. |
La scheda Dependencies contiene tutte le dipendenze del trigger.
Fare clic su Add per aggiungere una nuova dipendenza.
È inoltre possibile configurare un trigger aprendo uno esistente, facendo clic sul pulsante Clone e quindi salvandolo con un nome diverso.
Testing delle espressioni
È possibile testare l'espressione del trigger configurata per verificare 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 sono elencate tutte le singole espressioni. 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 visualizzare 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.