1 Configurazione di un trigger
Panoramica
Per configurare un trigger, procedere come segue:
- Andare su: 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)
- Inserire i parametri del trigger nel modulo
Vedere anche le 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}" cambierà automaticamente 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 è lo stesso del nome del trigger. Il nome dell'evento può essere usato per costruire avvisi significativi contenenti dati del problema (vedi esempio). È supportato lo stesso insieme di macro del nome del trigger, più i macro di espressione {TIME}, {TIMESTAMP} e {?EXPRESSION}. |
| Operational data | I dati operativi consentono di definire stringhe arbitrarie insieme ai macro. I macro verranno risolti dinamicamente in dati in tempo reale in Monitoring > Problems. Mentre i macro nel nome del trigger (vedi sopra) verranno risolti nei loro valori nel momento in cui si verifica un problema e diventeranno la base di un nome di problema statico, i macro nei dati operativi mantengono la possibilità di visualizzare dinamicamente le informazioni più recenti. Se a livello di trigger non è configurato alcun dato operativo, verranno visualizzati i valori più recenti di tutti gli item dell'espressione. È supportato lo stesso insieme di macro del nome del trigger. |
| Severity | Imposta la severity richiesta del trigger facendo clic sui pulsanti. |
| Expression | Espressione logica usata per definire le condizioni di un problema. Sono supportati i suffissi temporali 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 tramite 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 | Seleziona 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 | Immetti 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 | Seleziona 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, più {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 facendo clic sul nome del problema nel widget dashboard Monitoring > Problems o Problems. È supportato lo stesso insieme di macro del nome del trigger, più {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, dettagli di contatto del personale responsabile, ecc. È supportato lo stesso insieme di macro del nome del trigger. |
| Enabled | Deselezionando questa casella, il trigger verrà disabilitato 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 | Imposta 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. I macro utente, i macro utente con contesto, i macro di discovery a basso livello e le funzioni dei macro con {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} sono supportati nei tag evento. I macro di discovery a basso livello possono essere usati all'interno del contesto del macro.Il macro {TRIGGER.ID} è supportato nei valori dei tag del trigger. Può essere utile per identificare i trigger creati da prototipi di trigger e, ad esempio, per sopprimere i problemi di questi trigger durante la manutenzione. Se la lunghezza totale del valore espanso supera 255, verrà troncata a 255 caratteri. Vedi 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.
Fai clic su Add per aggiungere una nuova dipendenza.
Puoi anche configurare un trigger aprendo uno esistente, premendo il pulsante Clone e salvando poi 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 di un template ufficiale viene presa 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, fai clic su Expression constructor sotto il campo dell'espressione.
Nell'Expression constructor, tutte le singole espressioni sono elencate. Per aprire la finestra di test, fai clic su Test sotto l'elenco delle espressioni.
Nella finestra di test puoi inserire valori di esempio ('80', '70', '0', '1' in questo esempio) e poi 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.