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 à Alerts → Media types.
2. Cliquez sur Import 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 Import dans le coin inférieur droit du formulaire de configuration.

Règles d'importation :

Un message de réussite ou d'échec de l'importation s'affichera dans l'interface.

Format d'export

Export au format YAML :

zabbix_export:
  version: '7.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: '<PUSHOVER TOKEN HERE>'
        - 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 'Incorrect "event_source" parameter given: "' + params.event_source + '".\nMust be 0-3.';
            }

            if (params.event_value !== '0' && params.event_value !== '1'
                && (params.event_source === '0' || params.event_source === '3')) {
                throw 'Incorrect "event_value" parameter given: ' + params.event_value + '\nMust be 0 or 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" should be -2..2';
            }

            if (params.event_source === '0' && isNaN(params.triggerid)) {
                throw 'field "triggerid" is not a number';
            }

            if (isNaN(params.eventid)) {
                throw 'field "eventid" is not a number';
            }

            if (typeof params.message !== 'string' || params.message.trim() === '') {
                throw 'field "message" cannot be empty';
            }

            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 'field "retry" should be a number with value of at least 30 if "priority" is set to 2';
                }

                if (isNaN(params.expire) || params.expire > 10800) {
                    throw 'field "expire" should be a number with value of at most 10800 if "priority" is set to 2';
                }

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

            data = JSON.stringify(data);
            Zabbix.log(4, '[ Pushover Webhook ] Sending request: ' + params.endpoint + '\n' + data);

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

            Zabbix.log(4, '[ Pushover Webhook ] Received response with status code ' + request.getStatus() + '\n' + response);

            if (response !== null) {
                try {
                    response = JSON.parse(response);
                }
                catch (error) {
                    Zabbix.log(4, '[ Pushover Webhook ] Failed to parse response received from 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 'Unknown error. Check debug log for more information.';
                }
            }

            return 'OK';
        }
        catch (error) {
            Zabbix.log(4, '[ Pushover Webhook ] Pushover notification failed: ' + error);
            throw 'Pushover notification failed: ' + error;
        }
      description: |
        Veuillez vous référer au guide de configuration ici: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover

        Définissez le paramètre token avec la clé de votre application Pushover.
        Lors de l'attribution du média Pushover à l'utilisateur Zabbix, ajoutez la clé utilisateur dans le champ Envoyer à.
      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 {EVENT.AGE}, accusé de réception: {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 de l'appareil: {DISCOVERY.DEVICE.IPADDRESS}
            DNS de l'appareil: {DISCOVERY.DEVICE.DNS}
            État de l'appareil: {DISCOVERY.DEVICE.STATUS}
            Temps de fonctionnement de l'appareil: {DISCOVERY.DEVICE.UPTIME}

            Nom du service de l'appareil: {DISCOVERY.SERVICE.NAME}
            Port du service de l'appareil: {DISCOVERY.SERVICE.PORT}
            État du service de l'appareil: {DISCOVERY.SERVICE.STATUS}
            Temps de fonctionnement du service de l'appareil: {DISCOVERY.SERVICE.UPTIME}
        - event_source: AUTOREGISTRATION
          operation_mode: PROBLEM
          subject: 'Auto-enregistrement: {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.

Email

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

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.