6 Types de média

Vue d'ensemble

Les types de média sont exportés avec tous les objets associés et les relations entre objets.

Exportation

Pour exporter des types de média, procédez comme suit :

1. Accédez à Alertes → Types de média.
2. Cochez les cases des types de média à exporter.
3. Cliquez sur Exporter sous la liste.

Selon le format sélectionné, les types de média sont exportés vers un fichier local portant un nom par défaut :

• zabbix_export_mediatypes.yaml - pour l’exportation YAML (option par défaut pour l’exportation) ;
• zabbix_export_mediatypes.xml - pour l’exportation XML ;
• zabbix_export_mediatypes.json - pour l’exportation JSON.

Importation

Pour importer des types de média, procédez comme suit :

1. Accédez à Alertes → Types de média.
2. Cliquez sur Importer dans le coin supérieur droit.
3. Sélectionnez le fichier d’importation.
4. Cochez les options requises dans les règles d’importation.
5. Cliquez sur Importer dans le coin inférieur droit du formulaire de configuration.

Règles d’importation :

Un message indiquant le succès ou l’échec de l’importation sera affiché dans l’interface web.

Format d'exportation

Exporter au format YAML :

zabbix_export:
  version: '8.0'
  media_types:
    - name: Pushover
      type: WEBHOOK
      parameters:
        - name: endpoint
          value: 'https://api.pushover.net/1/messages.json'
        - name: eventid
          value: '{EVENT.ID}'
        - name: event_nseverity
          value: '{EVENT.NSEVERITY}'
        - name: event_source
          value: '{EVENT.SOURCE}'
        - name: event_value
          value: '{EVENT.VALUE}'
        - name: expire
          value: '1200'
        - name: message
          value: '{ALERT.MESSAGE}'
        - name: priority_average
          value: '0'
        - name: priority_default
          value: '0'
        - name: priority_disaster
          value: '0'
        - name: priority_high
          value: '0'
        - name: priority_information
          value: '0'
        - name: priority_not_classified
          value: '0'
        - name: priority_warning
          value: '0'
        - name: retry
          value: '60'
        - name: title
          value: '{ALERT.SUBJECT}'
        - name: token
          value: '<JETON PUSHOVER ICI>'
        - name: triggerid
          value: '{TRIGGER.ID}'
        - name: url
          value: '{$ZABBIX.URL}'
        - name: url_title
          value: Zabbix
        - name: user
          value: '{ALERT.SENDTO}'
      status: DISABLED
      max_sessions: '0'
      script: |
        try {
            var params = JSON.parse(value),
                request = new HttpRequest(),
                data,
                response,
                severities = [
                    {name: 'not_classified', color: '#97AAB3'},
                    {name: 'information', color: '#7499FF'},
                    {name: 'warning', color: '#FFC859'},
                    {name: 'average', color: '#FFA059'},
                    {name: 'high', color: '#E97659'},
                    {name: 'disaster', color: '#E45959'},
                    {name: 'resolved', color: '#009900'},
                    {name: 'default', color: '#000000'}
                ],
                priority;

            if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') {
                request.setProxy(params.HTTPProxy);
            }

            if ([0, 1, 2, 3].indexOf(parseInt(params.event_source)) === -1) {
                throw 'Paramètre "event_source" incorrect fourni : "' + params.event_source + '".\nDoit être 0-3.';
            }

            if (params.event_value !== '0' && params.event_value !== '1'
                && (params.event_source === '0' || params.event_source === '3')) {
                throw 'Paramètre "event_value" incorrect fourni : ' + params.event_value + '\nDoit être 0 ou 1.';
            }

            if ([0, 1, 2, 3, 4, 5].indexOf(parseInt(params.event_nseverity)) === -1) {
                params.event_nseverity = '7';
            }

            if (params.event_value === '0') {
                params.event_nseverity = '6';
            }

            priority = params['priority_' + severities[params.event_nseverity].name] || params.priority_default;

            if (isNaN(priority) || priority < -2 || priority > 2) {
                throw '"priority" doit être compris entre -2 et 2';
            }

            if (params.event_source === '0' && isNaN(params.triggerid)) {
                throw 'le champ "triggerid" n’est pas un nombre';
            }

            if (isNaN(params.eventid)) {
                throw 'le champ "eventid" n’est pas un nombre';
            }

            if (typeof params.message !== 'string' || params.message.trim() === '') {
                throw 'le champ "message" ne peut pas être vide';
            }

            data = {
                token: params.token,
                user: params.user,
                title: params.title,
                message: params.message,
                url: (params.event_source === '0') 
                    ? params.url + '/tr_events.php?triggerid=' + params.triggerid + '&eventid=' + params.eventid
                    : params.url,
                url_title: params.url_title,
                priority: priority
            };

            if (priority == 2) {
                if (isNaN(params.retry) || params.retry < 30) {
                    throw 'le champ "retry" doit être un nombre d’au moins 30 si "priority" est défini sur 2';
                }

                if (isNaN(params.expire) || params.expire > 10800) {
                    throw 'le champ "expire" doit être un nombre d’au plus 10800 si "priority" est défini sur 2';
                }

                data.retry = params.retry;
                data.expire = params.expire;
            }

            data = JSON.stringify(data);
            Zabbix.log(4, '[ Pushover Webhook ] Envoi de la requête : ' + params.endpoint + '\n' + data);

            request.addHeader('Content-Type: application/json');
            response = request.post(params.endpoint, data);

            Zabbix.log(4, '[ Pushover Webhook ] Réponse reçue avec le code d’état ' + request.getStatus() + '\n' + response);

            if (response !== null) {
                try {
                    response = JSON.parse(response);
                }
                catch (error) {
                    Zabbix.log(4, '[ Pushover Webhook ] Échec de l’analyse de la réponse reçue de Pushover');
                    response = null;
                }
            }

            if (request.getStatus() != 200 || response === null || typeof response !== 'object' || response.status !== 1) {
                if (response !== null && typeof response === 'object' && typeof response.errors === 'object'
                        && typeof response.errors[0] === 'string') {
                    throw response.errors[0];
                }
                else {
                    throw 'Erreur inconnue. Consultez le journal de débogage pour plus d’informations.';
                }
            }

            return 'OK';
        }
        catch (error) {
            Zabbix.log(4, '[ Pushover Webhook ] Échec de la notification Pushover : ' + error);
            throw 'Échec de la notification Pushover : ' + error;
        }
      description: |
        Veuillez consulter le guide de configuration ici : https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover

        Définissez le paramètre token avec votre clé d’application Pushover.
        Lors de l’attribution du média Pushover à l’utilisateur Zabbix, ajoutez la clé utilisateur dans le champ send to.
      message_templates:
        - event_source: TRIGGERS
          operation_mode: PROBLEM
          subject: 'Problème : {EVENT.NAME}'
          message: |
            Le problème a commencé à {EVENT.TIME} le {EVENT.DATE}
            Nom du problème : {EVENT.NAME}
            Hôte : {HOST.NAME}
            Gravité : {EVENT.SEVERITY}
            Données opérationnelles : {EVENT.OPDATA}
            ID du problème d’origine : {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: RECOVERY
          subject: 'Résolu en {EVENT.DURATION} : {EVENT.NAME}'
          message: |
            Le problème a été résolu à {EVENT.RECOVERY.TIME} le {EVENT.RECOVERY.DATE}
            Nom du problème : {EVENT.NAME}
            Durée du problème : {EVENT.DURATION}
            Hôte : {HOST.NAME}
            Gravité : {EVENT.SEVERITY}
            ID du problème d’origine : {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: UPDATE
          subject: 'Problème mis à jour en {EVENT.AGE} : {EVENT.NAME}'
          message: |
            {USER.FULLNAME} a {EVENT.UPDATE.ACTION} le problème le {EVENT.UPDATE.DATE} à {EVENT.UPDATE.TIME}.
            {EVENT.UPDATE.MESSAGE}

            L’état actuel du problème est {EVENT.STATUS}, son ancienneté est de {EVENT.AGE}, acquitté : {EVENT.ACK.STATUS}.
        - event_source: DISCOVERY
          operation_mode: PROBLEM
          subject: 'Découverte : {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}'
          message: |
            Règle de découverte : {DISCOVERY.RULE.NAME}

            IP du périphérique : {DISCOVERY.DEVICE.IPADDRESS}
            DNS du périphérique : {DISCOVERY.DEVICE.DNS}
            État du périphérique : {DISCOVERY.DEVICE.STATUS}
            Temps de fonctionnement du périphérique : {DISCOVERY.DEVICE.UPTIME}

            Nom du service du périphérique : {DISCOVERY.SERVICE.NAME}
            Port du service du périphérique : {DISCOVERY.SERVICE.PORT}
            État du service du périphérique : {DISCOVERY.SERVICE.STATUS}
            Temps de fonctionnement du service du périphérique : {DISCOVERY.SERVICE.UPTIME}
        - event_source: AUTOREGISTRATION
          operation_mode: PROBLEM
          subject: 'Enregistrement automatique : {HOST.HOST}'
          message: |
            Nom de l’hôte : {HOST.HOST}
            IP de l’hôte : {HOST.IP}
            Port de l’agent : {HOST.PORT}

Éléments exportés

Les éléments exportés sont expliqués dans le tableau ci-dessous.

E-mail

Les éléments supplémentaires suivants sont exportés uniquement pour le type de média E-mail.

SMS

Les éléments supplémentaires suivants sont exportés uniquement pour le type de média SMS.

Script

Les éléments supplémentaires suivants sont exportés uniquement pour le type de média Script.

Webhook

Les éléments supplémentaires suivants sont exportés uniquement pour le type de média Webhook.

Notes de bas de page

¹ Les valeurs entières de l’API entre parenthèses, par exemple ENABLED (0), sont mentionnées uniquement à titre de référence. Pour plus d’informations, consultez la page de l’objet API liée dans l’entrée du tableau ou à la fin de chaque section.