[comment]: # ({e88c898d-e88c898d})
# 1 Types de Media

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

[comment]: # ({dbad0c34-3c7a0fa2})
#### Aperçu

Les types de média sont les canaux de livraison utilisés pour envoyer des notifications et des alertes depuis Zabbix.

Les types de média prennent en charge les méthodes de livraison suivantes :

-   [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)

Les types de média sont gérés dans *Alerts* > *Media types*. Certains types de média sont prédéfinis dans l'ensemble de données par défaut.  
Il vous suffit d'ajuster leurs paramètres pour les faire fonctionner.

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

Pour voir comment les types de média s'intègrent dans le processus d'alerte, examinons les trois conditions nécessaires pour envoyer des notifications de Zabbix aux utilisateurs finaux :

1. Une [opération](/manual/config/notifications/action/operation#configuring-an-operation) d'action doit être définie pour envoyer des notifications
2. Un [type de média](#configuration) fonctionnel doit être défini (par exemple *Email*, qui envoie des alertes via SMTP)
3. Les détails de livraison au niveau de l'utilisateur (tels que les adresses e-mail, les numéros de téléphone, etc.) doivent être définis dans les [médias utilisateur](#user-media)

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

[comment]: # ({6d474343-aab3354b})
###### Test du type de média

Pour tester si un type de média configuré fonctionne, cliquez sur *Test* dans la liste des types de média.

La requête de test sera envoyée au serveur Zabbix. Le serveur Zabbix tentera d’envoyer une alerte en utilisant le type de média spécifié et renverra le résultat à l’interface. L’interface attendra que le serveur renvoie les résultats. Le test d’un type de média dispose par défaut d’un délai d’attente de 65 secondes (modifiable dans *Administration* > *Général* > *[Délais d’attente](/manual/web_interface/frontend_sections/administration/general#timeouts)*).

Voir aussi les détails de test pour :

- [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})
#### Configuration

Pour créer un type de média dans l'interface Zabbix :

-   Accédez à : *Alerts* > *Media types*
-   Cliquez sur *Create media type*
-   Saisissez les paramètres du type de média dans le formulaire

Certains paramètres sont **communs** à toutes les méthodes de livraison.

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

|Parameter|Description|
|--|--------|
|*Name*|Nom du type de média.|
|*Type*|Sélectionnez la méthode de livraison pour le type de média.|
|*Description*|Saisissez une description pour le type de média.|
|*Enabled*|Cochez la case pour activer le type de média.|

Pour les paramètres spécifiques à chaque méthode, consultez les pages [email](/manual/config/notifications/media/email#configuration), [SMS](/manual/config/notifications/media/sms#configuration), [custom alertscript](/manual/config/notifications/media/script#configuration) ou [webhook](/manual/config/notifications/media/webhook#configuration).

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

[comment]: # ({11d7e927-55a28037})
###### Modèles de message

L'onglet **Modèles de message** contient les messages par défaut selon le type d'événement (problème, récupération du problème, découverte, etc.).

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

Cliquez sur **Ajouter** pour définir un message par défaut (ou sur **Modifier** pour mettre à jour un message existant) :

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

|Parameter|Description|
|--|-----------|
|*Message type*|Type d'un événement pour lequel le message par défaut doit être utilisé.<br>Un seul message par défaut peut être défini pour chaque type d'événement.<br>|
|*Subject*|Objet du message par défaut. L'objet peut contenir des macros. Il est limité à 255 caractères.<br>L'objet n'est pas disponible pour le type de média SMS.|
|*Message*|Le message par défaut. Il est limité à un certain nombre de caractères selon le type de base de données (voir [Envoi de messages](/manual/config/notifications/action/operation/message/) pour plus d'informations).<br>Le message peut contenir des [macros](/manual/appendix/macros/supported_by_location) prises en charge.<br>Dans les messages de problème et de mise à jour de problème, les macros d'expression sont prises en charge (par exemple, `{?avg(/host/key,1h)}`).|

Notez que les messages par défaut sont remplacés par des messages personnalisés, s'ils sont définis dans les [opérations d'action](/manual/config/notifications/action/operation#operation-details).

::: notewarning
La définition de modèles de message est obligatoire pour toutes les méthodes de livraison, y compris les webhooks ou les scripts d'alerte personnalisés qui n'utilisent pas de messages par défaut pour les notifications. Par exemple, l'action "Send message to Pushover webhook" échouera à envoyer des notifications de problème si le message de problème pour le webhook Pushover n'est pas défini.
:::

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

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

L'onglet **Options** contient les paramètres de traitement des alertes. 
Le même ensemble d'options est configurable pour chaque type de média.

Tous les types de média sont traités en parallèle. 
Bien que le nombre maximal de sessions simultanées soit configurable par type de média, 
le nombre total de processus d'alerte sur le serveur ne peut être limité que par le paramètre StartAlerters [parameter](/manual/appendix/config/zabbix_server). 
Les alertes générées par un même déclencheur sont traitées séquentiellement. 
Ainsi, plusieurs notifications ne peuvent être traitées simultanément que si elles sont générées par plusieurs déclencheurs.

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

|Parameter|Description|
|--|--------|
|*Concurrent sessions*|Sélectionnez le nombre de sessions d'alerte parallèles pour le type de média:<br>**One** - une session<br>**Unlimited** - nombre illimité de sessions<br>**Custom** - sélectionnez un nombre personnalisé de sessions<br>Des valeurs illimitées/élevées signifient davantage de sessions parallèles et une capacité accrue d'envoi de notifications. Les valeurs illimitées/élevées doivent être utilisées dans les grands environnements où un grand nombre de notifications peuvent devoir être envoyées simultanément.<br>Si davantage de notifications doivent être envoyées que le nombre de sessions simultanées disponibles, les notifications restantes seront mises en file d'attente; elles ne seront pas perdues.|
|*Attempts*|Nombre de tentatives d'envoi d'une notification. Jusqu'à 100 tentatives peuvent être spécifiées; la valeur par défaut est '3'. Si '1' est spécifié, Zabbix enverra la notification une seule fois et ne réessaiera pas si l'envoi échoue.|
|*Attempt interval*|Fréquence de nouvelle tentative d'envoi d'une notification en cas d'échec de l'envoi, en secondes (0-3600). Si '0' est spécifié, Zabbix réessaiera immédiatement.<br>Les suffixes d'unité de temps sont pris en charge, par exemple 5s, 3m, 1h.|

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

[comment]: # ({db1efc6e-cb94600e})
#### Médias utilisateur

Alors que les types de média définissent **comment** une notification sera envoyée, les médias utilisateur définissent **où** la notification doit être envoyée.

Les médias utilisateur (par exemple, adresse e-mail, ID utilisateur de webhook, etc.) doivent être définis dans le profil utilisateur, quel que soit le mode de livraison. Une action envoyant des messages à l'utilisateur *Admin* à l'aide du webhook *X* échouera à les livrer si les détails de livraison du webhook *X* ne sont pas définis dans le profil utilisateur Admin.

Pour définir des médias utilisateur :

-   Allez dans *Users* > *Users* et ouvrez le formulaire des propriétés de l'utilisateur (ou allez dans *User settings* > *Notifications* de votre propre profil utilisateur)
-   Cliquez sur *Add* dans l'onglet Media

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

|Parameter|Description|
|--|--------|
|*Type*|La liste déroulante contient les noms des types de média activés.<br>Notez que lors de la modification d'un média d'un type de média désactivé, le type sera affiché en rouge.|
|*Send to*|Saisissez les informations de contact où les messages doivent être envoyés.<br>Pour le type de média e-mail, plusieurs adresses peuvent être ajoutées en cliquant sur le bouton ![](../../../../assets/en/manual/config/add_link.png) sous le champ d'adresse. Dans ce cas, les notifications seront envoyées à toutes les adresses répertoriées. Pour des exemples d'adresses, consultez la description du paramètre *Email* pour le type de média [email](/manual/config/notifications/media/email#configuration).|
|*When active*|Vous pouvez limiter la période pendant laquelle les messages sont envoyés, par exemple en définissant uniquement les jours ouvrables (1-5,09:00-18:00). Notez que cette limite est basée sur le [fuseau horaire](/manual/web_interface/time_zone) de l'utilisateur. Si le fuseau horaire de l'utilisateur est modifié et diffère du fuseau horaire du système, cette limite devra peut-être être ajustée en conséquence afin de ne pas manquer des messages importants.<br>Consultez la page [Spécification de période](/manual/appendix/time_period) pour la description du format.<br>Les macros utilisateur sont prises en charge.|
|*Use if severity*|Cochez les cases des niveaux de gravité des déclencheurs pour lesquels vous souhaitez recevoir des notifications.<br>*Note* que la gravité par défaut ('Not classified') **doit être** cochée si vous souhaitez recevoir des notifications pour les [événements](/manual/config/events) non liés à un déclencheur.<br>Après l'enregistrement, les niveaux de gravité des déclencheurs sélectionnés seront affichés dans les couleurs de gravité correspondantes, tandis que ceux qui ne sont pas sélectionnés seront grisés.|
|*Status*|Statut des médias utilisateur.<br>**Enabled** - est utilisé.<br>**Disabled** - n'est pas utilisé.|

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

[comment]: # ({7ba43dfc-54669df1})
#### Types de média Gmail/Office365 automatisés

Les utilisateurs de Gmail ou d'Office365 peuvent bénéficier d'une configuration plus simple du type de média.  
Le champ *Fournisseur de messagerie* dans la configuration du type de média de messagerie permet de sélectionner des options préconfigurées pour Gmail et Office 365.

Lors de la sélection des options liées à Gmail/Office365, il suffit de fournir l'adresse e-mail/le mot de passe de l'expéditeur pour créer un type de média fonctionnel.

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

Dès que l'adresse e-mail/le mot de passe est fourni, Zabbix pourra remplir automatiquement tous les paramètres requis pour les types de média Gmail/Office365 avec les valeurs réelles/recommandées, c'est-à-dire *serveur SMTP*, *port du serveur SMTP*, *SMTP helo* et *Sécurité de la connexion*. En raison de cette automatisation, ces champs ne sont même pas affichés ; toutefois, il est possible de voir le serveur SMTP et les détails de messagerie dans la liste des types de média (voir la colonne *Détails*).

Notez également que :

-   Le mot de passe n'est pas requis pour les options de relais.
-   Pour le relais Office365, le nom de domaine de l'adresse e-mail fournie sera utilisé pour renseigner dynamiquement le serveur SMTP (c'est-à-dire remplacer "example.com" dans `example-com.mail.protection.outlook.com` par la valeur réelle).

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