6 Medientypen

Übersicht

Medientypen werden zusammen mit allen zugehörigen Objekten und Objektbeziehungen exportiert.

Exportieren

Gehen Sie zum Exportieren von Medientypen wie folgt vor:

1. Gehen Sie zu Alerts → Media types.
2. Markieren Sie die Kontrollkästchen der zu exportierenden Medientypen.
3. Klicken Sie unterhalb der Liste auf Export, um im standardmäßigen YAML-Format zu exportieren, oder klicken Sie auf den Pfeil, um ein anderes Exportformat auszuwählen.

Abhängig vom ausgewählten Format werden Medientypen in eine lokale Datei mit einem Standardnamen exportiert:

• zabbix_export_mediatypes.yaml - beim YAML-Export;
• zabbix_export_mediatypes.xml - beim XML-Export;
• zabbix_export_mediatypes.json - beim JSON-Export.

Importieren

Gehen Sie zum Importieren von Medientypen wie folgt vor:

1. Gehen Sie zu Alerts → Media types.
2. Klicken Sie oben rechts auf Import.
3. Wählen Sie die Importdatei aus.
4. Aktivieren Sie die Kontrollkästchen der Importregeln, die Sie anwenden möchten (siehe unten).
5. Klicken Sie unten rechts im Konfigurationsformular auf Import.

Importregeln:

Während des Imports können Sie Änderungen an Medientypen nicht überprüfen. Eine Erfolgs- oder Fehlermeldung des Imports wird im Frontend angezeigt.

Exportformat

Export nach YAML:

zabbix_export:
  version: '7.4'
  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: |
        Bitte beachten Sie die Einrichtungsanleitung hier: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover?at=refs%2Fheads%2Frelease%2F7.4

        Setzen Sie den Parameter token auf Ihren Pushover-Anwendungsschlüssel.
        Wenn Sie Pushover-Medien dem Zabbix-Benutzer zuweisen, fügen Sie den Benutzer-Schlüssel in das Feld "Senden an" ein.
      message_templates:
        - event_source: TRIGGERS
          operation_mode: PROBLEM
          subject: 'Problem: {EVENT.NAME}'
          message: |
            Problem begann um {EVENT.TIME} am {EVENT.DATE}
            Problemname: {EVENT.NAME}
            Host: {HOST.NAME}
            Schweregrad: {EVENT.SEVERITY}
            Betriebsdaten: {EVENT.OPDATA}
            Ursprüngliche Problem-ID: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: RECOVERY
          subject: 'Behoben in {EVENT.DURATION}: {EVENT.NAME}'
          message: |
            Das Problem wurde behoben um {EVENT.RECOVERY.TIME} am {EVENT.RECOVERY.DATE}
            Problemname: {EVENT.NAME}
            Problemdauer: {EVENT.DURATION}
            Host: {HOST.NAME}
            Schweregrad: {EVENT.SEVERITY}
            Ursprüngliche Problem-ID: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: UPDATE
          subject: 'Aktualisiertes Problem in {EVENT.AGE}: {EVENT.NAME}'
          message: |
            {USER.FULLNAME} {EVENT.UPDATE.ACTION} das Problem am {EVENT.UPDATE.DATE} um {EVENT.UPDATE.TIME}.
            {EVENT.UPDATE.MESSAGE}

            Der aktuelle Problemstatus ist {EVENT.STATUS}, das Alter beträgt {EVENT.AGE}, bestätigt: {EVENT.ACK.STATUS}.
        - event_source: DISCOVERY
          operation_mode: PROBLEM
          subject: 'Erkennung: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}'
          message: |
            Erkennungsregel: {DISCOVERY.RULE.NAME}

            Geräte-IP: {DISCOVERY.DEVICE.IPADDRESS}
            Geräte-DNS: {DISCOVERY.DEVICE.DNS}
            Gerätestatus: {DISCOVERY.DEVICE.STATUS}
            Geräte-Uptime: {DISCOVERY.DEVICE.UPTIME}

            Name des Gerätedienstes: {DISCOVERY.SERVICE.NAME}
            Port des Gerätedienstes: {DISCOVERY.SERVICE.PORT}
            Status des Gerätedienstes: {DISCOVERY.SERVICE.STATUS}
            Uptime des Gerätedienstes: {DISCOVERY.SERVICE.UPTIME}
        - event_source: AUTOREGISTRATION
          operation_mode: PROBLEM
          subject: 'Automatische Registrierung: {HOST.HOST}'
          message: |
            Hostname: {HOST.HOST}
            Host-IP: {HOST.IP}
            Agent-Port: {HOST.PORT}

Exportierte Elemente

Exportierte Elemente werden in der folgenden Tabelle erläutert.

E-Mail

Die folgenden zusätzlichen Elemente werden nur für den Medientyp E-Mail exportiert.

SMS

Die folgenden zusätzlichen Elemente werden nur für den Medientyp SMS exportiert.

Skript

Die folgenden zusätzlichen Elemente werden nur für den Medientyp Skript exportiert.

webhook

Die folgenden zusätzlichen Elemente werden nur für den Medientyp webhook exportiert.

Fußnoten

¹ API-Ganzzahlwerte in Klammern, zum Beispiel ENABLED (0), werden nur als Referenz angegeben. Weitere Informationen finden Sie auf der verlinkten API-Objektseite im Tabelleneintrag oder am Ende jedes Abschnitts.