Multivides tipi

Pārskats

Multivides tipi tiek eksportēti kopā ar visiem saistītajiem objektiem un objektu attiecībām.

Eksportēšana

Lai eksportētu mediju tipus, rīkojieties šādi:

1. Dodieties uz Alerts > Media types.
2. Atzīmējiet eksportējamo mediju tipu izvēles rūtiņas.
3. Noklikšķiniet uz Export zem saraksta, lai eksportētu noklusējuma YAML formātā, vai noklikšķiniet uz bultiņas, lai atlasītu citu eksporta formātu.

Atkarībā no atlasītā formāta mediju tipi tiek eksportēti uz lokālu failu ar noklusējuma nosaukumu:

• zabbix_export_mediatypes.yaml - YAML eksportā;
• zabbix_export_mediatypes.xml - XML eksportā;
• zabbix_export_mediatypes.json - JSON eksportā.

Importēšana

Lai importētu multivides tipus, rīkojieties, kā norādīts tālāk:

1. Atveriet Alerts > Media types.
2. Augšējā labajā stūrī noklikšķiniet uz Import.
3. Atlasiet importēšanas failu.
4. Atzīmējiet to importēšanas noteikumu izvēles rūtiņas, kurus vēlaties lietot (skatiet tālāk).
5. Konfigurācijas formas apakšējā labajā stūrī noklikšķiniet uz Import.

Importēšanas noteikumi:

Importēšanas laikā nevar pārskatīt multivides tipu izmaiņas. Lietotāja saskarnē tiks parādīts importēšanas veiksmes vai kļūmes ziņojums.

Eksportēšanas formāts

Eksportēšana uz YAML:

zabbix_export:
  version: '8.2'
  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: |
        Skatiet iestatīšanas rokasgrāmatu šeit: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover

        Iestatiet parametru token ar savas Pushover lietotnes atslēgu.
        Piešķirot Pushover multivides tipu Zabbix lietotājam, laukā “Nosūtīt uz” pievienojiet lietotāja atslēgu.
      message_templates:
        - event_source: TRIGGERS
          operation_mode: PROBLEM
          subject: 'Problēma: {EVENT.NAME}'
          message: |
            Problēma sākās {EVENT.TIME} {EVENT.DATE}
            Problēmas nosaukums: {EVENT.NAME}
            Hosts: {HOST.NAME}
            Smaguma pakāpe: {EVENT.SEVERITY}
            Darbības dati: {EVENT.OPDATA}
            Sākotnējās problēmas ID: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: RECOVERY
          subject: 'Atrisināts pēc {EVENT.DURATION}: {EVENT.NAME}'
          message: |
            Problēma tika atrisināta {EVENT.RECOVERY.TIME} {EVENT.RECOVERY.DATE}
            Problēmas nosaukums: {EVENT.NAME}
            Problēmas ilgums: {EVENT.DURATION}
            Hosts: {HOST.NAME}
            Smaguma pakāpe: {EVENT.SEVERITY}
            Sākotnējās problēmas ID: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: UPDATE
          subject: 'Atjaunināta problēma pēc {EVENT.AGE}: {EVENT.NAME}'
          message: |
            {USER.FULLNAME} {EVENT.UPDATE.ACTION} problēmu {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}.
            {EVENT.UPDATE.MESSAGE}

            Pašreizējais problēmas stāvoklis ir {EVENT.STATUS}, tās ilgums ir {EVENT.AGE}, apstiprināta: {EVENT.ACK.STATUS}.
        - event_source: DISCOVERY
          operation_mode: PROBLEM
          subject: 'Atklāšana: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}'
          message: |
            Atklāšanas noteikums: {DISCOVERY.RULE.NAME}

            Ierīces IP: {DISCOVERY.DEVICE.IPADDRESS}
            Ierīces DNS: {DISCOVERY.DEVICE.DNS}
            Ierīces statuss: {DISCOVERY.DEVICE.STATUS}
            Ierīces darbspējas laiks: {DISCOVERY.DEVICE.UPTIME}

            Ierīces servisa nosaukums: {DISCOVERY.SERVICE.NAME}
            Ierīces servisa ports: {DISCOVERY.SERVICE.PORT}
            Ierīces servisa statuss: {DISCOVERY.SERVICE.STATUS}
            Ierīces servisa darbspējas laiks: {DISCOVERY.SERVICE.UPTIME}
        - event_source: AUTOREGISTRATION
          operation_mode: PROBLEM
          subject: 'Automātiskā reģistrācija: {HOST.HOST}'
          message: |
            Hosta nosaukums: {HOST.HOST}
            Hosta IP: {HOST.IP}
            Aģenta ports: {HOST.PORT}

Eksportētie elementi

Eksportētie elementi ir izskaidroti tabulā zemāk.

Email

Tālāk norādītie papildu elementi tiek eksportēti tikai Email mediju tipam.

SMS

Tālāk norādītie papildu elementi tiek eksportēti tikai SMS multivides tipam.

Skripts

Tālāk norādītie papildu elementi tiek eksportēti tikai Skripts multivides tipam.

webhook

Tālāk norādītie papildu elementi tiek eksportēti tikai webhook multivides tipam.

Piezīmes

¹ API veselo skaitļu vērtības iekavās, piemēram, ENABLED (0), ir minētas tikai uzziņai. Papildu informāciju skatiet saistītajā API objekta lapā tabulas ierakstā vai katras sadaļas beigās.