Tipi di media

Panoramica

I media type sono i canali di distribuzione utilizzati per inviare notifiche e avvisi da Zabbix.

I media type supportano i seguenti metodi di distribuzione:

I media type vengono gestiti in Avvisi > Media type. Alcuni media type sono predefiniti nel dataset predefinito. È sufficiente perfezionarne i parametri per renderli operativi.

Per vedere come i media type si inseriscono nel processo di generazione degli avvisi, esaminiamo i tre requisiti necessari per distribuire le notifiche da Zabbix agli utenti finali:

  1. Deve essere definita un'operazione dell'azione che invii le notifiche.
  2. Deve essere definito un media type funzionante, ad esempio E-mail, che invii gli avvisi utilizzando SMTP.
  3. I dettagli di distribuzione a livello utente, come indirizzi e-mail, numeri di telefono e così via, devono essere definiti nei media dell'utente.
Test del tipo di media

Per verificare se un tipo di media configurato funziona, fare clic su Test nell'elenco dei tipi di media.

La richiesta di test verrà inviata al server Zabbix. Il server Zabbix tenterà di inviare un avviso utilizzando il tipo di media specificato e restituirà il risultato al frontend. Il frontend attenderà che il server restituisca i risultati. Per impostazione predefinita, il test del tipo di media ha un timeout di 65 secondi (configurabile in Amministrazione > Generale > Timeout).

Vedere anche i dettagli dei test per:

Configurazione

Per creare un tipo di supporto nel frontend di Zabbix:

  1. Vai a Avvisi > Tipi di supporto.
  2. Fai clic su Crea tipo di supporto.
  3. Inserisci i parametri del tipo di supporto nel modulo.

Alcuni parametri sono comuni a tutti i metodi di consegna.

Se uno o più metodi di consegna sono specificati nel flag delle funzionalità $ZBX_FEATURE_FLAGS['media_type_denylist'] nel file di configurazione del frontend (zabbix.conf.php), tali metodi di consegna non sono disponibili nell'elenco Tipo.

Parametro Descrizione
Nome Nome del tipo di supporto.
Tipo Seleziona il metodo di consegna per il tipo di supporto.
Descrizione Inserisci una descrizione per il tipo di supporto.
Abilitato Seleziona la casella di controllo per abilitare il tipo di supporto.

Per i parametri specifici del metodo, consulta le pagine relative a email, notifica push, SMS, alertscript personalizzato o webhook.

Template dei messaggi

La scheda Template dei messaggi contiene i messaggi predefiniti per tipo di evento (problema, ripristino del problema, discovery, ecc.).

Fai clic su Aggiungi per definire un messaggio predefinito (oppure su Modifica per aggiornare un messaggio esistente):

Parameter Description
Message type Tipo di evento per il quale deve essere utilizzato il messaggio predefinito.
Per ogni tipo di evento può essere definito un solo messaggio predefinito.
Subject Oggetto del messaggio predefinito. L'oggetto può contenere macro. È limitato a 255 caratteri.
L'oggetto non è disponibile per il tipo di media SMS.
Message Il messaggio predefinito. È limitato a un certo numero di caratteri a seconda del tipo di database (vedi Invio dei messaggi per ulteriori informazioni).
Il messaggio può contenere macro supportate.
Nei messaggi di problema e di aggiornamento del problema, sono supportate le macro di espressione (ad esempio, {?avg(/host/key,1h)}).

Nota che i messaggi predefiniti vengono sovrascritti dai messaggi personalizzati, se definiti nelle operazioni dell'azione.

La definizione dei template dei messaggi è obbligatoria per tutti i metodi di consegna, inclusi webhook o script di avviso personalizzati che non usano messaggi predefiniti per le notifiche. Ad esempio, l'azione "Send message to Pushover webhook" non riuscirà a inviare notifiche di problema, se il messaggio di problema per il webhook Pushover non è definito.

Opzioni

La scheda Opzioni contiene le impostazioni per l'elaborazione degli avvisi.
Lo stesso insieme di opzioni è configurabile per ogni tipo di media.

Tutti i tipi di media vengono elaborati in parallelo.
Sebbene il numero massimo di sessioni simultanee sia configurabile per ogni tipo di media,
il numero totale di processi alerter sul server può essere limitato solo dal parametro StartAlerters.
Gli avvisi generati da un singolo trigger vengono elaborati in sequenza.
Pertanto, più notifiche possono essere elaborate simultaneamente solo se sono generate da più trigger.

Parametro Descrizione
Sessioni simultanee Selezionare il numero di sessioni alerter parallele per il tipo di media:
Una - una sessione
Illimitate - numero illimitato di sessioni
Personalizzato - selezionare un numero personalizzato di sessioni
Valori illimitati/elevati indicano un numero maggiore di sessioni parallele e una capacità aumentata per l'invio delle notifiche. I valori illimitati/elevati devono essere utilizzati in ambienti di grandi dimensioni, dove potrebbe essere necessario inviare simultaneamente molte notifiche.
Se è necessario inviare più notifiche rispetto al numero di sessioni simultanee, le notifiche rimanenti verranno accodate; non andranno perse.
Tentativi Numero di tentativi per l'invio di una notifica. È possibile specificare fino a 100 tentativi; il valore predefinito è '3'. Se viene specificato '1', Zabbix invierà la notifica una sola volta e non effettuerà nuovi tentativi se l'invio non riesce.
Intervallo tra i tentativi Frequenza con cui si tenta di inviare nuovamente una notifica nel caso in cui l'invio non sia riuscito, espressa in secondi (0-3600). Se viene specificato '0', Zabbix effettuerà nuovamente il tentativo immediatamente.
Sono supportati i suffissi temporali (ad esempio, 30s, 1m, 1h).

Media dell'utente

Mentre i tipi di media definiscono come verrà inviata una notifica, i media dell'utente definiscono dove deve essere inviata.

I media dell'utente (ad esempio, l'indirizzo email, l'ID utente del webhook, ecc.) devono essere definiti nel profilo dell'utente, indipendentemente dal metodo di consegna. Un'azione che invia messaggi all'utente Admin utilizzando il webhook X non riuscirà a consegnarli se i dettagli di consegna del webhook X non sono definiti nel profilo dell'utente Admin.

Per definire i media dell'utente:

  1. Vai a Users > Users e apri il modulo delle proprietà dell'utente.
    In alternativa, vai a User settings > Notifications del tuo profilo utente.
  2. Fai clic su Add nella scheda Media.
  3. Inserisci i parametri del media dell'utente nel modulo.

Parameter Description
Type L'elenco a discesa contiene i nomi dei tipi di media abilitati.
Nota che, quando si modifica un media di un tipo di media disabilitato, il tipo viene visualizzato in rosso.
Send to Inserisci le informazioni di contatto a cui devono essere inviati i messaggi.
Per il tipo di media email, è possibile aggiungere più indirizzi facendo clic sul pulsante sotto il campo dell'indirizzo. In questo caso, le notifiche verranno inviate a tutti gli indirizzi elencati. Per esempi di indirizzi, consulta la descrizione del parametro Email per il tipo di media email.
Per il tipo di media delle notifiche push, puoi selezionare i dispositivi mobili attivi dell'utente oppure aggiungere uno o più dispositivi specifici.
When active Puoi limitare l'orario di invio dei messaggi, ad esempio impostando solo i giorni lavorativi (1-5,09:00-18:00). Nota che questo limite si basa sul fuso orario dell'utente. Se il fuso orario dell'utente viene modificato ed è diverso da quello del sistema, potrebbe essere necessario modificare di conseguenza questo limite per non perdere messaggi importanti.
Per una descrizione del formato, consulta la pagina Specifica del periodo di tempo.
Sono supportate le macro utente.
Use if severity Seleziona le caselle di controllo delle gravità dei trigger per le quali desideri ricevere notifiche.
Nota che la gravità predefinita ('Not classified') deve essere selezionata se desideri ricevere notifiche per eventi non correlati ai trigger.
Dopo il salvataggio, le gravità dei trigger selezionate verranno visualizzate con i colori di gravità corrispondenti, mentre quelle non selezionate saranno disattivate.
Status Stato del media dell'utente.
Enabled - in uso.
Disabled - non in uso.