6 Mediju tipi

Pārskats

Paziņojumu nesēju tipi tiek eksportēti kopā ar visiem saistītajiem objektiem un objektu attiecībām.

Eksportēšana

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

1. Dodieties uz Alerts → Media types.
2. Atzīmējiet eksportējamo multivides 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 multivides 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 mediju tipus, rīkojieties šādi:

1. Dodieties uz Alerts → Media types.
2. Augšējā labajā stūrī noklikšķiniet uz Import.
3. Atlasiet importēšanas failu.
4. Importēšanas noteikumos atzīmējiet nepieciešamās opcijas.
5. Konfigurācijas formas apakšējā labajā stūrī noklikšķiniet uz Import.

Importēšanas noteikumi:

Veiksmīgas vai neveiksmīgas importēšanas ziņojums tiks parādīts lietotāja saskarne.

Eksporta formāts

Eksportēt uz 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 'Nekorekts parametrs "event_source": "' + params.event_source + '".\nTam jābūt 0-3.';
            }

            if (params.event_value !== '0' && params.event_value !== '1'
                && (params.event_source === '0' || params.event_source === '3')) {
                throw 'Nekorekts parametrs "event_value": ' + params.event_value + '\nTam jābūt 0 vai 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" jābūt diapazonā -2..2';
            }

            if (params.event_source === '0' && isNaN(params.triggerid)) {
                throw 'lauks "triggerid" nav skaitlis';
            }

            if (isNaN(params.eventid)) {
                throw 'lauks "eventid" nav skaitlis';
            }

            if (typeof params.message !== 'string' || params.message.trim() === '') {
                throw 'lauks "message" nevar būt tukšs';
            }

            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 'lauks "retry" jābūt skaitlim ar vērtību vismaz 30, ja "priority" ir iestatīts uz 2';
                }

                if (isNaN(params.expire) || params.expire > 10800) {
                    throw 'lauks "expire" jābūt skaitlim ar vērtību ne vairāk kā 10800, ja "priority" ir iestatīts uz 2';
                }

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

            data = JSON.stringify(data);
            Zabbix.log(4, '[ Pushover Webhook ] Sūta pieprasījumu: ' + params.endpoint + '\n' + data);

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

            Zabbix.log(4, '[ Pushover Webhook ] Saņemta atbilde ar statusa kodu ' + request.getStatus() + '\n' + response);

            if (response !== null) {
                try {
                    response = JSON.parse(response);
                }
                catch (error) {
                    Zabbix.log(4, '[ Pushover Webhook ] Neizdevās parsēt no Pushover saņemto atbildi');
                    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 'Nezināma kļūda. Lai iegūtu vairāk informācijas, pārbaudiet atkļūdošanas žurnālu.';
                }
            }

            return 'OK';
        }
        catch (error) {
            Zabbix.log(4, '[ Pushover Webhook ] Pushover paziņojuma nosūtīšana neizdevās: ' + error);
            throw 'Pushover paziņojuma nosūtīšana neizdevās: ' + error;
        }
      description: |
        Lūdzu, skatiet iestatīšanas rokasgrāmatu šeit: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover

        Iestatiet parametru token ar savu Pushover lietotnes atslēgu.
        Piešķirot Pushover mediju Zabbix lietotājam, laukā "send to" 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}
            Smagums: {EVENT.SEVERITY}
            Operatīvie dati: {EVENT.OPDATA}
            Sākotnējās problēmas ID: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: RECOVERY
          subject: 'Atrisināts {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}
            Smagums: {EVENT.SEVERITY}
            Sākotnējās problēmas ID: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: UPDATE
          subject: 'Atjaunināta problēma {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 statuss ir {EVENT.STATUS}, vecums ir {EVENT.AGE}, apstiprināts: {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 darbības laiks: {DISCOVERY.DEVICE.UPTIME}

            Ierīces pakalpojuma nosaukums: {DISCOVERY.SERVICE.NAME}
            Ierīces pakalpojuma ports: {DISCOVERY.SERVICE.PORT}
            Ierīces pakalpojuma statuss: {DISCOVERY.SERVICE.STATUS}
            Ierīces pakalpojuma darbības laiks: {DISCOVERY.SERVICE.UPTIME}
        - event_source: AUTOREGISTRATION
          operation_mode: PROBLEM
          subject: 'Automātiska reģistrācija: {HOST.HOST}'
          message: |
            Hosts nosaukums: {HOST.HOST}
            Hosts IP: {HOST.IP}
            Aģenta ports: {HOST.PORT}

Eksportētie elementi

Eksportētie elementi ir izskaidroti zemāk esošajā tabulā.

Email

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

SMS

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

Skripts

Tālāk norādītie papildu elementi tiek eksportēti tikai Skripts paziņojumu nesēja tipam.

Webhook

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

Piezīmes

¹ API integer vērtības iekavās, piemēram, ENABLED (0), ir minētas tikai atsaucei. Papildinformāciju skatiet saistītā API objekta lapā tabulas ierakstā vai katras sadaļas beigās.