1 E-mail

Visão geral

Para configurar o e-mail como canal de entrega de mensagens, é necessário configurar o e-mail como tipo de mídia e atribuir endereços específicos aos usuários.

Várias notificações para um único evento serão agrupadas na mesma conversa de e-mail.

Configuração

Para configurar e-mail como tipo de mídia:

  1. Vá para Alertas > Tipos de mídia.
  2. Clique em Criar tipo de mídia (ou clique em Email na lista de tipos de mídia predefinidos).

A aba Tipo de mídia contém os atributos gerais do tipo de mídia:

Todos os campos de entrada obrigatórios são marcados com um asterisco vermelho.

A senha é exportada em texto claro ao exportar a configuração do tipo de mídia de e-mail.

Os seguintes parâmetros são específicos do tipo de mídia de e-mail:

Parâmetro Descrição
Provedor de e-mail Selecione o provedor de e-mail: SMTP genérico, Gmail, Relay do Gmail, Office365 ou Relay do Office365.
Se você selecionar as opções relacionadas ao Gmail/Office365, será necessário informar apenas o endereço de e-mail do remetente e a senha; opções como Servidor SMTP, Porta do servidor SMTP, SMTP helo e Segurança da conexão serão preenchidas automaticamente pelo Zabbix. Veja também: Tipos de mídia automatizados do Gmail/Office365.
Servidor SMTP Defina um servidor SMTP para processar mensagens de saída.
Este campo estará disponível se SMTP genérico for selecionado como provedor de e-mail.
Porta do servidor SMTP Defina a porta do servidor SMTP para processar mensagens de saída.
Este campo estará disponível se SMTP genérico for selecionado como provedor de e-mail.
Email O endereço informado aqui será usado como endereço De para as mensagens enviadas.
É suportada a adição de um nome de exibição do remetente (como "Zabbix_info" em Zabbix_info zabbix\@company.com na captura de tela acima) junto com o endereço de e-mail real.
Há algumas restrições para nomes de exibição em e-mails do Zabbix em comparação com o que é permitido pela RFC 5322, conforme ilustrado pelos exemplos:
Exemplos válidos:
zabbix\@company.com (somente endereço de e-mail, sem necessidade de usar colchetes angulares)
Zabbix_info zabbix\@company.com (nome de exibição e endereço de e-mail entre colchetes angulares)
∑Ω-monitoring zabbix\@company.com (caracteres UTF-8 no nome de exibição)
Exemplos inválidos:
Zabbix HQ zabbix\@company.com (nome de exibição presente, mas sem colchetes angulares ao redor do endereço de e-mail)
"Zabbix\@\<H(comment)Q\>" zabbix\@company.com (embora válido pela RFC 5322, pares entre aspas e comentários não são suportados em e-mails do Zabbix)
SMTP helo Defina um valor SMTP helo correto, normalmente um nome de domínio.
Se estiver vazio, o nome de domínio do e-mail será enviado (ou seja, o que vem após @ no campo Email). Se não for possível obter o nome de domínio, um aviso em nível de depuração será registrado no log e o hostname do server será enviado como domínio para o comando HELO.
Este campo estará disponível se SMTP genérico for selecionado como provedor de e-mail.
Segurança da conexão Selecione o nível de segurança da conexão:
Nenhuma - não usar a opção CURLOPT_USE_SSL
STARTTLS - usar a opção CURLOPT_USE_SSL com o valor CURLUSESSL_ALL
SSL/TLS - o uso de CURLOPT_USE_SSL é opcional
Verificar par SSL Marque a caixa de seleção para verificar o certificado SSL do servidor SMTP.
O valor da diretiva de configuração do server "SSLCALocation" deve ser colocado em CURLOPT_CAPATH para validação do certificado.
Isso define a opção cURL CURLOPT_SSL_VERIFYPEER.
Verificar host SSL Marque a caixa de seleção para verificar se o campo Common Name ou o campo Subject Alternate Name do certificado do servidor SMTP corresponde.
Isso define a opção cURL CURLOPT_SSL_VERIFYHOST.
Autenticação Selecione o nível de autenticação:
Nenhuma - nenhuma opção cURL é definida
Nome de usuário e senha - implica "AUTH=*", deixando a escolha do mecanismo de autenticação para o cURL
OAuth - autenticação OAuth
A autenticação OAuth não é suportada para o provedor de e-mail Relay do Office365.
Nome de usuário Nome de usuário a ser usado na autenticação.
Isso define o valor de CURLOPT_USERNAME.
Macros de usuário suportadas.
Senha Senha a ser usada na autenticação.
Isso define o valor de CURLOPT_PASSWORD.
Macros de usuário suportadas.
O valor informado aqui é exportado como está quando a configuração do tipo de mídia é exportada. Para evitar expor credenciais sensíveis em arquivos exportados, use uma macro de usuário (por exemplo, {$EMAIL_SMTP_PASSWORD}) em vez de uma senha literal — a referência da macro será exportada, enquanto o valor secreto deverá ser (re)configurado no sistema de destino.
Tokens OAuth Clique em Configurar para definir os parâmetros para recuperar tokens OAuth em uma nova janela.
Este campo está disponível somente se "OAuth" for selecionado no campo Autenticação.
Formato da mensagem Selecione o formato da mensagem:
HTML - enviar como HTML
Texto simples - enviar como texto simples

Para habilitar a autenticação SMTP, o Zabbix server deve ser compilado com a opção de compilação --with-libcurl, que requer libcurl (consulte os requisitos do server para detalhes da versão).

Veja também parâmetros comuns de tipos de mídia para detalhes sobre como configurar mensagens padrão e opções de processamento de alertas.

Tokens OAuth

Os seguintes parâmetros são necessários para recuperar tokens OAuth:

Parâmetro Descrição
Redirection endpoint Insira a URL do frontend do Zabbix para onde o serviço OAuth irá redirecionar a autorização OAuth (usando o formato https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize).
É definido automaticamente para um novo tipo de mídia de e-mail quando a URL do frontend está definida.
Client ID Insira o identificador exclusivo do aplicativo cliente registrado no servidor de autorização OAuth.
Client secret Insira o segredo privado do aplicativo cliente registrado no servidor de autorização OAuth.
Authorization endpoint Insira a URL do servidor de autorização OAuth para solicitar a autorização do usuário.
Authorization parameters Insira os parâmetros para o endpoint de autorização.
Authorization code Insira o código de autorização:
Automático - o código será recuperado automaticamente por meio de uma página de redirecionamento
Manual - insira o código manualmente se a recuperação automática falhar
Token endpoint Insira a URL do servidor de autorização OAuth para trocar o código de autorização por tokens de acesso e atualização.
Token parameters Insira os parâmetros para o token de acesso.

A recuperação de tokens OAuth possui recursos automatizados para os provedores de e-mail Gmail, Gmail relay e Office365. É necessário apenas fornecer os valores dos parâmetros Redirection endpoint, Client ID e Client secret. O Zabbix preencherá automaticamente os outros valores necessários (consulte Padrões de URL OAuth por provedor).

Recuperação do token de acesso e atualização do OAuth

Após enviar os parâmetros do OAuth:

  1. Uma janela pop-up do navegador é aberta, direcionando o usuário para o ponto de extremidade de autorização.

  2. O usuário autoriza o Zabbix no serviço OAuth.

  3. O serviço OAuth redireciona o usuário para a ação do frontend do Zabbix oauth.authorize com o código de autorização e o valor do escopo.

  4. Em resposta, o Zabbix fará uma solicitação ao ponto de extremidade do token para trocar o código de autorização por tokens de acesso e atualização.

Testando

Para testar se um tipo de mídia de e-mail configurado funciona corretamente:

  1. Localize o e-mail relevante na lista de tipos de mídia.
  2. Clique em Testar na última coluna da lista (uma janela de teste será aberta).
  3. Insira um endereço de destinatário em Enviar para, o corpo da mensagem e, opcionalmente, o assunto.
  4. Clique em Testar para enviar uma mensagem de teste.

Uma mensagem de sucesso ou falha será exibida na mesma janela:

Mídia do usuário

Depois que o tipo de mídia de e-mail estiver configurado, vá para a seção Usuários > Usuários e edite o perfil do usuário para atribuir a mídia de e-mail ao usuário. As etapas para configurar a mídia do usuário, comuns a todos os tipos de mídia, estão descritas na página Tipos de mídia.