6 Tipos de mídia

Visão geral

Os tipos de mídia são exportados com todos os objetos relacionados e relações de objetos.

Exportando

Para exportar tipos de mídia, faça o seguinte:

1. Acesse Alerts → Media types.
2. Marque as caixas de seleção dos tipos de mídia a serem exportados.
3. Clique em Export abaixo da lista para exportar no formato YAML padrão ou clique na seta para selecionar um formato de exportação diferente.

Dependendo do formato selecionado, os tipos de mídia são exportados para um arquivo local com um nome padrão:

• zabbix_export_mediatypes.yaml - na exportação YAML;
• zabbix_export_mediatypes.xml - na exportação XML;
• zabbix_export_mediatypes.json - na exportação JSON.

Importando

Para importar tipos de mídia, faça o seguinte:

1. Vá para Alertas → Tipos de mídia.
2. Clique em Importar no canto superior direito.
3. Selecione o arquivo de importação.
4. Marque as opções necessárias nas regras de importação.
5. Clique em Importar no canto inferior direito do formulário de configuração.

Regras de importação:

Uma mensagem de sucesso ou falha da importação será exibida no frontend.

Formato de exportação

Exportar para 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 'Parâmetro "event_source" incorreto fornecido: "' + params.event_source + '".\nDeve ser 0-3.';
            }

            if (params.event_value !== '0' && params.event_value !== '1'
                && (params.event_source === '0' || params.event_source === '3')) {
                throw 'Parâmetro "event_value" incorreto fornecido: ' + params.event_value + '\nDeve ser 0 ou 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 ser -2..2';
            }

            if (params.event_source === '0' && isNaN(params.triggerid)) {
                throw 'o campo "triggerid" não é um número';
            }

            if (isNaN(params.eventid)) {
                throw 'o campo "eventid" não é um número';
            }

            if (typeof params.message !== 'string' || params.message.trim() === '') {
                throw 'o campo "message" não pode estar vazio';
            }

            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 'o campo "retry" deve ser um número com valor de pelo menos 30 se "priority" estiver definido como 2';
                }

                if (isNaN(params.expire) || params.expire > 10800) {
                    throw 'o campo "expire" deve ser um número com valor de no máximo 10800 se "priority" estiver definido como 2';
                }

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

            data = JSON.stringify(data);
            Zabbix.log(4, '[ Pushover Webhook ] Enviando solicitação: ' + params.endpoint + '\n' + data);

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

            Zabbix.log(4, '[ Pushover Webhook ] Resposta recebida com código de status ' + request.getStatus() + '\n' + response);

            if (response !== null) {
                try {
                    response = JSON.parse(response);
                }
                catch (error) {
                    Zabbix.log(4, '[ Pushover Webhook ] Falha ao analisar a resposta recebida do 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 'Erro desconhecido. Verifique o log de depuração para mais informações.';
                }
            }

            return 'OK';
        }
        catch (error) {
            Zabbix.log(4, '[ Pushover Webhook ] Falha na notificação do Pushover: ' + error);
            throw 'Falha na notificação do Pushover: ' + error;
        }
      description: |
        Consulte o guia de configuração aqui: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover?at=refs%2Fheads%2Frelease%2F7.4

        Defina o parâmetro token com a chave da sua aplicação Pushover.
        Ao atribuir a mídia Pushover ao usuário do Zabbix, adicione a chave do usuário no campo enviar para.
      message_templates:
        - event_source: TRIGGERS
          operation_mode: PROBLEM
          subject: 'Problema: {EVENT.NAME}'
          message: |
            O problema começou em {EVENT.TIME} em {EVENT.DATE}
            Nome do problema: {EVENT.NAME}
            Host: {HOST.NAME}
            Severidade: {EVENT.SEVERITY}
            Dados operacionais: {EVENT.OPDATA}
            ID original do problema: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: RECOVERY
          subject: 'Resolvido em {EVENT.DURATION}: {EVENT.NAME}'
          message: |
            O problema foi resolvido em {EVENT.RECOVERY.TIME} em {EVENT.RECOVERY.DATE}
            Nome do problema: {EVENT.NAME}
            Duração do problema: {EVENT.DURATION}
            Host: {HOST.NAME}
            Severidade: {EVENT.SEVERITY}
            ID original do problema: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: UPDATE
          subject: 'Problema atualizado em {EVENT.AGE}: {EVENT.NAME}'
          message: |
            {USER.FULLNAME} {EVENT.UPDATE.ACTION} o problema em {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}.
            {EVENT.UPDATE.MESSAGE}

            O status atual do problema é {EVENT.STATUS}, a idade é {EVENT.AGE}, reconhecido: {EVENT.ACK.STATUS}.
        - event_source: DISCOVERY
          operation_mode: PROBLEM
          subject: 'Descoberta: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}'
          message: |
            Regra de descoberta: {DISCOVERY.RULE.NAME}

            IP do dispositivo: {DISCOVERY.DEVICE.IPADDRESS}
            DNS do dispositivo: {DISCOVERY.DEVICE.DNS}
            Status do dispositivo: {DISCOVERY.DEVICE.STATUS}
            Tempo de atividade do dispositivo: {DISCOVERY.DEVICE.UPTIME}

            Nome do serviço do dispositivo: {DISCOVERY.SERVICE.NAME}
            Porta do serviço do dispositivo: {DISCOVERY.SERVICE.PORT}
            Status do serviço do dispositivo: {DISCOVERY.SERVICE.STATUS}
            Tempo de atividade do serviço do dispositivo: {DISCOVERY.SERVICE.UPTIME}
        - event_source: AUTOREGISTRATION
          operation_mode: PROBLEM
          subject: 'Autoregistro: {HOST.HOST}'
          message: |
            Nome do host: {HOST.HOST}
            IP do host: {HOST.IP}
            Porta do agent: {HOST.PORT}

Elementos exportados

Os elementos exportados são explicados na tabela abaixo.

Email

Os seguintes elementos adicionais são exportados apenas para o tipo de mídia Email.

SMS

Os seguintes elementos adicionais são exportados apenas para o tipo de mídia SMS.

Script

Os seguintes elementos adicionais são exportados apenas para o tipo de mídia Script.

Webhook

Os seguintes elementos adicionais são exportados apenas para o tipo de mídia Webhook.

Notas de rodapé

¹ Os valores inteiros da API entre parênteses, por exemplo, ENABLED (0), são mencionados apenas para referência. Para obter mais informações, consulte a página do objeto da API vinculada na entrada da tabela ou no final de cada seção.