[comment]: # ({e88c898d-e88c898d})
# 1 Tipi di supporto

[comment]: # ({/e88c898d-e88c898d})

[comment]: # ({dbad0c34-3c7a0fa2})
#### Panoramica

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

I media type supportano i seguenti metodi di consegna:

-   [Email](/manual/config/notifications/media/email)
-   [SMS](/manual/config/notifications/media/sms)
-   [Custom script](/manual/config/notifications/media/script)
-   [Webhook](/manual/config/notifications/media/webhook)

I media type sono gestiti in *Alerts* > *Media types*. Alcuni media type sono predefiniti nel dataset di default.  
È sufficiente perfezionarne i parametri per renderli operativi.

![](../../../../assets/en/manual/config/notifications/media_type_list.png){width="600"}

Per vedere come i media type si inseriscono nel processo di notifica, consideriamo i tre requisiti necessari per inviare notifiche da Zabbix agli utenti finali:

1. Deve essere definita un'azione [operation](/manual/config/notifications/action/operation#configuring-an-operation) che invii notifiche
2. Deve essere definito un [media type](#configuration) funzionante (ad esempio *Email*, che invia avvisi tramite SMTP)
3. I dettagli di consegna a livello utente (come indirizzi e-mail, numeri di telefono, ecc.) devono essere definiti in [user media](#user-media)

[comment]: # ({/dbad0c34-3c7a0fa2})

[comment]: # ({6d474343-aab3354b})
###### Test del tipo di media

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

La richiesta di test verrà inviata a Zabbix server. Zabbix server tenterà di inviare un avviso usando il tipo di media specificato e restituirà il risultato al frontend. Il frontend attenderà che il server restituisca i risultati. Il test del tipo di media ha un timeout predefinito di 65 secondi (configurabile in *Administration* > *General* > *[Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts)*).

Vedi anche i dettagli di test per:

- [Email](/manual/config/notifications/media/email#testing)
- [Webhook](/manual/config/notifications/media/webhook#testing)
- [Script](/manual/config/notifications/media/script#testing)

[comment]: # ({/6d474343-aab3354b})

[comment]: # ({8ccd9290-dfae5c19})
#### Configurazione

Per creare un tipo di media nel frontend di Zabbix:

-   Vai a: *Alerts* > *Media types*
-   Fai clic su *Create media type*
-   Inserisci i parametri del tipo di media nel modulo

Alcuni parametri sono **comuni** a tutti i metodi di consegna.

![](../../../../assets/en/manual/config/notifications/media_types_common.png){width="600"}

|Parameter|Description|
|--|--------|
|*Name*|Nome del tipo di media.|
|*Type*|Seleziona il metodo di consegna per il tipo di media.|
|*Description*|Inserisci una descrizione per il tipo di media.|
|*Enabled*|Seleziona la casella di controllo per abilitare il tipo di media.|

Per i parametri specifici del metodo, consulta le pagine [email](/manual/config/notifications/media/email#configuration), [SMS](/manual/config/notifications/media/sms#configuration), [custom alertscript](/manual/config/notifications/media/script#configuration) o [webhook](/manual/config/notifications/media/webhook#configuration).

[comment]: # ({/8ccd9290-dfae5c19})

[comment]: # ({11d7e927-55a28037})
###### Template dei messaggi

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

![](../../../../assets/en/manual/config/notifications/media_type_messages.png){width="600"}

Fai clic su **Add** per definire un messaggio predefinito (oppure su **Edit** per aggiornare un messaggio esistente):

![](../../../../assets/en/manual/config/notifications/media/media_types2.png){width="600"}

|Parameter|Description|
|--|-----------|
|*Message type*|Tipo di evento per il quale deve essere usato il messaggio predefinito.<br>Per ogni tipo di evento può essere definito un solo messaggio predefinito.<br>|
|*Subject*|Oggetto del messaggio predefinito. L'oggetto può contenere macro. È limitato a 255 caratteri.<br>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 [Sending messages](/manual/config/notifications/action/operation/message/) per maggiori informazioni).<br>Il messaggio può contenere [macro](/manual/appendix/macros/supported_by_location) supportate.<br>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](/manual/config/notifications/action/operation#operation-details).

::: notewarning
La definizione dei template dei messaggi è obbligatoria per tutti i metodi di consegna, 
incluse le webhook o gli 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 la webhook Pushover non è definito. 
:::

[comment]: # ({/11d7e927-55a28037})

[comment]: # ({22fbec32-161fb66e})
###### Opzioni

La scheda **Options** contiene le impostazioni di elaborazione degli alert.  
Lo stesso insieme di opzioni è configurabile per ciascun media type.

Tutti i media type vengono elaborati in parallelo.  
Sebbene il numero massimo di sessioni concorrenti sia configurabile per ciascun media type,  
il numero totale di processi alerter sul server può essere limitato solo dal parametro StartAlerters [parameter](/manual/appendix/config/zabbix_server).  
Gli alert generati da un singolo trigger vengono elaborati in sequenza.  
Quindi più notifiche possono essere elaborate contemporaneamente solo se sono generate da trigger diversi.

![](../../../../assets/en/manual/config/notifications/media/media_type_options.png){width="600"}

|Parameter|Description|
|--|--------|
|*Concurrent sessions*|Selezionare il numero di sessioni alerter parallele per il media type:<br>**One** - una sessione<br>**Unlimited** - numero illimitato di sessioni<br>**Custom** - selezionare un numero personalizzato di sessioni<br>Valori illimitati/alti significano più sessioni parallele e una maggiore capacità di invio delle notifiche. Valori illimitati/alti dovrebbero essere usati in ambienti di grandi dimensioni in cui potrebbe essere necessario inviare molte notifiche simultaneamente.<br>Se è necessario inviare più notifiche rispetto alle sessioni concorrenti disponibili, le notifiche rimanenti verranno messe in coda; non andranno perse.|
|*Attempts*|Numero di tentativi per provare a inviare 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 ritenterà in caso di errore di invio.|
|*Attempt interval*|Frequenza, in secondi (0-3600), dei tentativi di reinvio di una notifica in caso di errore di invio. Se viene specificato '0', Zabbix ritenterà immediatamente.<br>Sono supportati i suffissi di tempo, ad esempio 5s, 3m, 1h.|

[comment]: # ({/22fbec32-161fb66e})

[comment]: # ({db1efc6e-cb94600e})
#### Media utente

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

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

Per definire i media utente:

-   Vai su *Users* > *Users* e apri il modulo delle proprietà dell'utente (oppure vai su *User settings* > *Notifications* del tuo profilo utente)
-   Fai clic su *Add* nella scheda Media

![](../../../../assets/en/manual/config/notifications/media/user_media2.png){width="600"}

|Parameter|Description|
|--|--------|
|*Type*|L'elenco a discesa contiene i nomi dei tipi di media abilitati.<br>Nota che quando si modifica un medium di un tipo di media disabilitato, il tipo verrà visualizzato in rosso.|
|*Send to*|Inserisci le informazioni di contatto a cui devono essere inviati i messaggi.<br>Per il tipo di media email, è possibile aggiungere più indirizzi facendo clic sul pulsante ![](../../../../assets/en/manual/config/add_link.png) 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](/manual/config/notifications/media/email#configuration).|
|*When active*|Puoi limitare l'orario in cui i messaggi vengono inviati, ad esempio impostando solo i giorni lavorativi (1-5,09:00-18:00). Nota che questo limite si basa sul [fuso orario](/manual/web_interface/time_zone) dell'utente. Se il fuso orario dell'utente viene modificato ed è diverso dal fuso orario del sistema, questo limite potrebbe dover essere regolato di conseguenza per non perdere messaggi importanti.<br>Consulta la pagina [Time period specification](/manual/appendix/time_period) per la descrizione del formato.<br>Le macro utente sono supportate.|
|*Use if severity*|Seleziona le caselle di controllo delle severità dei trigger per cui desideri ricevere notifiche.<br>*Nota* che la severità predefinita ('Not classified') **deve essere** selezionata se desideri ricevere notifiche per [eventi](/manual/config/events) non trigger.<br>Dopo il salvataggio, le severità dei trigger selezionate verranno visualizzate nei rispettivi colori di severità, mentre quelle non selezionate saranno visualizzate in grigio.|
|*Status*|Stato dei media utente.<br>**Enabled** - è in uso.<br>**Disabled** - non è in uso.|

[comment]: # ({/db1efc6e-cb94600e})

[comment]: # ({7ba43dfc-54669df1})
#### Tipi di media Gmail/Office365 automatizzati

Gli utenti Gmail o Office365 possono trarre vantaggio da una configurazione più semplice del tipo di media. Il campo *Provider di posta elettronica* nella configurazione del tipo di media email consente di selezionare opzioni preconfigurate per Gmail e Office 365.

Quando si selezionano le opzioni relative a Gmail/Office365, è sufficiente fornire l'indirizzo email/password del mittente per creare un tipo di media funzionante.

![](../../../../assets/en/manual/config/notifications/media_type_gmail.png){width="600"}

Non appena vengono forniti indirizzo email/password, Zabbix sarà in grado di compilare automaticamente tutte le impostazioni richieste per i tipi di media Gmail/Office365 con i valori effettivi/raccomandati, cioè *SMTP server*, *porta del server SMTP*, *SMTP helo* e *Sicurezza della connessione*. A causa di questa automazione, questi campi non vengono nemmeno mostrati; tuttavia, è possibile vedere il server SMTP e i dettagli email nell'elenco dei tipi di media (vedere la colonna *Dettagli*).

Si noti inoltre che:

-   La password non è richiesta per le opzioni relay.
-   Per il relay di Office365, il nome di dominio dell'indirizzo email fornito verrà utilizzato per compilare dinamicamente il server SMTP (cioè sostituire "example.com" in `example-com.mail.protection.outlook.com` con il valore reale).

[comment]: # ({/7ba43dfc-54669df1})
