3 Script di avviso personalizzati

Panoramica

Se non sei soddisfatto dei media type esistenti per l'invio degli alert, esiste un modo alternativo per farlo. Puoi creare uno script che gestisca la notifica nel modo desiderato.

Gli script di alert personalizzati vengono eseguiti su Zabbix server. Questi script devono trovarsi nella directory specificata nel parametro AlertScriptsPath del file di configurazione del server.

Ecco un esempio di script di alert personalizzato:

#!/bin/bash

to=$1
subject=$2
body=$3
host=$4
value=$5

cat <<EOF | mail -s "$subject" "$to"
$body

Host: $host
Value: $value
EOF

Zabbix controlla il codice di uscita dei comandi e degli script eseguiti. Qualsiasi codice di uscita diverso da 0 viene considerato un errore di esecuzione del comando. In questi casi, Zabbix tenterà di ripetere l'esecuzione fallita.

Le variabili di ambiente non vengono preservate né create per lo script, quindi devono essere gestite esplicitamente.

Configurazione

Per configurare script di avviso personalizzati come tipo di supporto:

  1. Vai a Avvisi → Tipi di supporto.
  2. Fai clic su Crea tipo di supporto.

La scheda Tipo di supporto contiene gli attributi generali del tipo di supporto:

Tutti i campi obbligatori sono contrassegnati da un asterisco rosso.

I seguenti parametri sono specifici per il tipo di supporto script:

Parametro Descrizione
Nome dello script Inserisci il nome del file di script (ad esempio, notification.sh) che si trova nella directory specificata nel parametro di configurazione del server AlertScriptsPath.
Parametri dello script Aggiungi i parametri facoltativi dello script che verranno passati allo script come argomenti della riga di comando nell'ordine in cui sono definiti.

I parametri dello script supportano le macro {ALERT.SENDTO}, {ALERT.SUBJECT}, {ALERT.MESSAGE} e tutte le macro supportate nelle notifiche, nonché le macro utente.

Per informazioni dettagliate sulla configurazione dei messaggi predefiniti e delle opzioni di elaborazione degli avvisi, consulta la configurazione del tipo di supporto.

Anche se uno script di avviso non utilizza i messaggi predefiniti, è comunque necessario definire i modelli di messaggio per i tipi di operazione utilizzati da questo tipo di supporto. In caso contrario, non verrà inviata alcuna notifica.

Se è configurato più di un tipo di supporto script, questi script possono essere elaborati in parallelo dai processi alerter. Il numero totale di processi alerter è limitato dal parametro StartAlerters nel file di configurazione del server.

Testing

Per testare un media type script configurato:

  1. Individua lo script pertinente nell'elenco dei media type.

  2. Fai clic su Test nell'ultima colonna dell'elenco; si aprirà un modulo di test in una finestra popup. Il modulo di test conterrà lo stesso numero di parametri configurati per il media type script.

  3. Modifica i valori dei parametri dello script, se necessario. La modifica influisce solo sulla procedura di test; i valori effettivi non verranno modificati.

  4. Fai clic su Test.

Quando si testa un media type script configurato, {ALERT.SENDTO}, {ALERT.SUBJECT}, {ALERT.MESSAGE} e le macro utente verranno risolte nei rispettivi valori, ma le macro correlate agli eventi (ad esempio, {HOST.HOST}, {ITEM.LASTVALUE}, ecc.) non verranno risolte, poiché durante il test non esiste alcun evento correlato da cui ottenere i dettagli. Nota che anche le macro all'interno delle macro {ALERT.SUBJECT} e {ALERT.MESSAGE} non verranno risolte. Ad esempio, se il valore di {ALERT.SUBJECT} è composto da "Problem: {EVENT.NAME}", la macro {EVENT.NAME} non verrà risolta.

Media utente

Una volta configurato il tipo di media, vai alla sezione Users → Users ed esegui la modifica di un profilo utente assegnando questo tipo di media all'utente. I passaggi per configurare il media utente, comuni a tutti i tipi di media, sono descritti nella pagina Media types.

Nota che, quando si definisce il media utente, il campo Send to non può essere vuoto. Se questo campo non viene utilizzato nello script di allerta, inserisci qualsiasi combinazione di caratteri supportati per aggirare i requisiti di convalida.