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 | 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 (vedere 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 non sono configurati dati operativi a livello di trigger, verranno visualizzati i valori più recenti di tutti gli item dell'espressione. È supportato lo stesso insieme di macro del nome del trigger. |
| Severity | Impostare 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 | 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 | Immettere 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 facendo clic sul nome del problema nel widget della dashboard Monitoring > Problems o 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, 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" e non 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 funzioni di macro functions con {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} nei tag evento. Le macro di discovery a basso livello possono essere usate 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 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.
È anche possibile configurare un trigger aprendo uno esistente, facendo clic sul 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, 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.