6 Tipi di supporto

Panoramica

I tipi di supporto vengono esportati con tutti gli oggetti correlati e le relative relazioni.

Esportazione

Per esportare i tipi di supporto, procedere come segue:

1. Vai in Avvisi → Tipi di media.
2. Seleziona le caselle di controllo dei tipi di supporto da esportare.
3. Fai clic su Esporta sotto l'elenco.

A seconda del formato selezionato, i tipi di supporto vengono esportati in un file locale con un nome predefinito:

• zabbix_export_mediatypes.yaml - nell'esportazione YAML (opzione predefinita per l'esportazione);
• zabbix_export_mediatypes.xml - nell'esportazione XML;
• zabbix_export_mediatypes.json - nell'esportazione JSON.

Importazione

Per importare i tipi di supporto, procedere come segue:

1. Andare su Avvisi → Tipi di supporto.
2. Fare clic su Importa nell'angolo superiore destro.
3. Selezionare il file di importazione.
4. Selezionare le opzioni richieste nelle regole di importazione.
5. Fare clic su Importa nell'angolo inferiore destro del modulo di configurazione.

Regole di importazione:

Nel frontend verrà visualizzato un messaggio di esito positivo o negativo dell'importazione.

Formato di esportazione

Esporta in 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: '<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 'Parametro "event_source" fornito non corretto: "' + params.event_source + '".\nDeve essere 0-3.';
            }

            if (params.event_value !== '0' && params.event_value !== '1'
                && (params.event_source === '0' || params.event_source === '3')) {
                throw 'Parametro "event_value" fornito non corretto: ' + params.event_value + '\nDeve essere 0 o 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" deve essere compreso tra -2 e 2';
            }

            if (params.event_source === '0' && isNaN(params.triggerid)) {
                throw 'il campo "triggerid" non è un numero';
            }

            if (isNaN(params.eventid)) {
                throw 'il campo "eventid" non è un numero';
            }

            if (typeof params.message !== 'string' || params.message.trim() === '') {
                throw 'il campo "message" non può essere vuoto';
            }

            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 'il campo "retry" deve essere un numero con valore di almeno 30 se "priority" è impostato a 2';
                }

                if (isNaN(params.expire) || params.expire > 10800) {
                    throw 'il campo "expire" deve essere un numero con valore massimo di 10800 se "priority" è impostato a 2';
                }

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

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

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

            Zabbix.log(4, '[ Pushover Webhook ] Risposta ricevuta con codice di stato ' + request.getStatus() + '\n' + response);

            if (response !== null) {
                try {
                    response = JSON.parse(response);
                }
                catch (error) {
                    Zabbix.log(4, '[ Pushover Webhook ] Impossibile analizzare la risposta ricevuta da 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 'Errore sconosciuto. Controllare il log di debug per ulteriori informazioni.';
                }
            }

            return 'OK';
        }
        catch (error) {
            Zabbix.log(4, '[ Pushover Webhook ] Notifica Pushover non riuscita: ' + error);
            throw 'Notifica Pushover non riuscita: ' + error;
        }
      description: |
        Fare riferimento alla guida di configurazione qui: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover

        Impostare il parametro token con la chiave dell'applicazione Pushover.
        Quando si assegna il tipo di supporto Pushover all'utente Zabbix, aggiungere la chiave utente nel campo send to.
      message_templates:
        - event_source: TRIGGERS
          operation_mode: PROBLEM
          subject: 'Problema: {EVENT.NAME}'
          message: |
            Problema iniziato alle {EVENT.TIME} del {EVENT.DATE}
            Nome del problema: {EVENT.NAME}
            Host: {HOST.NAME}
            Gravità: {EVENT.SEVERITY}
            Dati operativi: {EVENT.OPDATA}
            ID problema originale: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: RECOVERY
          subject: 'Risolto in {EVENT.DURATION}: {EVENT.NAME}'
          message: |
            Il problema è stato risolto alle {EVENT.RECOVERY.TIME} del {EVENT.RECOVERY.DATE}
            Nome del problema: {EVENT.NAME}
            Durata del problema: {EVENT.DURATION}
            Host: {HOST.NAME}
            Gravità: {EVENT.SEVERITY}
            ID problema originale: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: UPDATE
          subject: 'Problema aggiornato in {EVENT.AGE}: {EVENT.NAME}'
          message: |
            {USER.FULLNAME} ha {EVENT.UPDATE.ACTION} il problema il {EVENT.UPDATE.DATE} alle {EVENT.UPDATE.TIME}.
            {EVENT.UPDATE.MESSAGE}

            Lo stato attuale del problema è {EVENT.STATUS}, l'età è {EVENT.AGE}, riconosciuto: {EVENT.ACK.STATUS}.
        - event_source: DISCOVERY
          operation_mode: PROBLEM
          subject: 'Rilevamento: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}'
          message: |
            Regola di rilevamento: {DISCOVERY.RULE.NAME}

            IP del dispositivo: {DISCOVERY.DEVICE.IPADDRESS}
            DNS del dispositivo: {DISCOVERY.DEVICE.DNS}
            Stato del dispositivo: {DISCOVERY.DEVICE.STATUS}
            Uptime del dispositivo: {DISCOVERY.DEVICE.UPTIME}

            Nome del servizio del dispositivo: {DISCOVERY.SERVICE.NAME}
            Porta del servizio del dispositivo: {DISCOVERY.SERVICE.PORT}
            Stato del servizio del dispositivo: {DISCOVERY.SERVICE.STATUS}
            Uptime del servizio del dispositivo: {DISCOVERY.SERVICE.UPTIME}
        - event_source: AUTOREGISTRATION
          operation_mode: PROBLEM
          subject: 'Autoregistrazione: {HOST.HOST}'
          message: |
            Nome host: {HOST.HOST}
            IP host: {HOST.IP}
            Porta agent: {HOST.PORT}

Elementi esportati

Gli elementi esportati sono spiegati nella tabella seguente.

Email

I seguenti elementi aggiuntivi vengono esportati solo per il tipo di supporto Email.

SMS

I seguenti elementi aggiuntivi vengono esportati solo per il tipo di supporto SMS.

Script

I seguenti elementi aggiuntivi vengono esportati solo per il tipo di supporto Script.

Webhook

I seguenti elementi aggiuntivi vengono esportati solo per il tipo di supporto Webhook.

Note a piè di pagina

¹ I valori interi dell'API tra parentesi, ad esempio ENABLED (0), sono riportati solo a scopo di riferimento. Per ulteriori informazioni, vedere la pagina dell'oggetto API collegata nella voce della tabella o alla fine di ciascuna sezione.