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 media, procedere come segue:

1. Andare su Alerts → Media types.
2. Fare clic su Import nell'angolo in alto a destra.
3. Selezionare il file di importazione.
4. Selezionare le opzioni richieste nelle regole di importazione.
5. Fare clic su Import nell'angolo in basso a destra del modulo di configurazione.

Regole di importazione:

Un messaggio di successo o di errore dell'importazione verrà visualizzato nel frontend.

Formato di esportazione

Esporta in 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 'Parametro "event_source" 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" 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 -2..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 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 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 ] Ricevuta risposta 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. Controlla 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

        Imposta il parametro token con la chiave dell'applicazione Pushover.
        Quando assegni il media Pushover all'utente Zabbix, aggiungi la chiave utente nel campo send to.
      message_templates:
        - event_source: TRIGGERS
          operation_mode: PROBLEM
          subject: 'Problema: {EVENT.NAME}'
          message: |
            Il 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} {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}, confermato: {EVENT.ACK.STATUS}.
        - event_source: DISCOVERY
          operation_mode: PROBLEM
          subject: 'Discovery: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}'
          message: |
            Regola di discovery: {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 media 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.