Tipos de mídia
Visão geral
Os tipos de mídia são os canais de entrega usados para enviar notificações e alertas do Zabbix.
Os tipos de mídia suportam os seguintes métodos de entrega:
Os tipos de mídia são mantidos em Alertas > Tipos de mídia. Alguns tipos de mídia vêm pré-definidos no conjunto de dados padrão. Você só precisa ajustar seus parâmetros para que funcionem.
Para ver como os tipos de mídia se encaixam no processo de alerta, vejamos os três requisitos para entregar notificações do Zabbix aos usuários finais:
- Uma operação de ação deve ser definida para enviar notificações
- Um tipo de mídia funcional deve ser definido (como E-mail que envia alertas usando SMTP)
- Detalhes de entrega no nível do usuário (como endereços de e-mail, números de telefone, etc.) devem ser definidos na mídia do usuário
Teste de tipo de mídia
Para testar se um tipo de mídia configurado funciona, clique em Test na lista de tipos de mídia.
A solicitação de teste será enviada ao Zabbix server. O Zabbix server tentará enviar um alerta usando o tipo de mídia especificado e retornará o resultado ao frontend. O frontend aguardará o server retornar os resultados. O teste de tipo de mídia tem um tempo limite padrão de 65 segundos (configurável em Administration > General > Timeouts).
Veja também os detalhes de teste para:
Configuração
Para criar um tipo de mídia no frontend do Zabbix:
- Acesse Alertas > Tipos de mídia.
- Clique em Criar tipo de mídia.
- Insira os parâmetros do tipo de mídia no formulário.
Alguns parâmetros são comuns a todos os métodos de entrega.
Se um ou mais métodos de entrega forem especificados no sinalizador de recurso $ZBX_FEATURE_FLAGS['media_type_denylist'] no arquivo de configuração do frontend (zabbix.conf.php), esses métodos de entrega não estarão disponíveis na lista Tipo.
| Parâmetro | Descrição |
|---|---|
| Nome | Nome do tipo de mídia. |
| Tipo | Selecione o método de entrega para o tipo de mídia. |
| Descrição | Insira uma descrição para o tipo de mídia. |
| Habilitado | Marque a caixa de seleção para habilitar o tipo de mídia. |
Para obter informações sobre os parâmetros específicos de cada método, consulte as páginas de e-mail, SMS, alertscript personalizado ou webhook.
Modelos de mensagem
A aba Modelos de mensagem contém mensagens padrão por tipo de evento (problema, recuperação de problema, descoberta etc).
Clique em Adicionar para definir uma mensagem padrão (ou em Editar para atualizar uma mensagem existente):
| Parameter | Description |
|---|---|
| Message type | Tipo de evento para o qual a mensagem padrão deve ser usada. Apenas uma mensagem padrão pode ser definida para cada tipo de evento. |
| Subject | Assunto da mensagem padrão. O assunto pode conter macros. Ele é limitado a 255 caracteres. O assunto não está disponível para o tipo de mídia SMS. |
| Message | A mensagem padrão. Ela é limitada a uma certa quantidade de caracteres, dependendo do tipo de banco de dados (consulte Sending messages para mais informações). A mensagem pode conter macros suportadas. Em mensagens de problema e atualização de problema, macros de expressão são suportadas (por exemplo, {?avg(/host/key,1h)}). |
Observe que as mensagens padrão são substituídas por mensagens personalizadas, se definidas em action operations.
Definir modelos de mensagem é obrigatório para todos os métodos de entrega, incluindo webhooks ou scripts de alerta personalizados que não usam mensagens padrão para notificações. Por exemplo, a action "Send message to Pushover webhook" falhará ao enviar notificações de problema, se a mensagem de problema para o Pushover webhook não estiver definida.
Opções
A aba Opções contém configurações de processamento de alertas.
O mesmo conjunto de opções pode ser configurado para cada tipo de mídia.
Todos os tipos de mídia são processados em paralelo.
Embora o número máximo de sessões simultâneas possa ser configurado por tipo de mídia,
o número total de processos alerter no server só pode ser limitado pelo parâmetro StartAlerters.
Os alertas gerados por um trigger são processados sequencialmente.
Portanto, várias notificações só poderão ser processadas simultaneamente se forem geradas por vários triggers.
| Parâmetro | Descrição |
|---|---|
| Sessões simultâneas | Selecione o número de sessões alerter paralelas para o tipo de mídia: Uma - uma sessão Ilimitado - número ilimitado de sessões Personalizado - selecione um número personalizado de sessões Valores ilimitados/altos significam mais sessões paralelas e maior capacidade para enviar notificações. Valores ilimitados/altos devem ser usados em ambientes grandes, nos quais muitas notificações podem precisar ser enviadas simultaneamente. Se for necessário enviar mais notificações do que o número de sessões simultâneas, as notificações restantes serão colocadas em fila; elas não serão perdidas. |
| Tentativas | Número de tentativas para enviar uma notificação. É possível especificar até 100 tentativas; o valor padrão é '3'. Se '1' for especificado, o Zabbix enviará a notificação apenas uma vez e não tentará novamente se o envio falhar. |
| Intervalo entre tentativas | Frequência das tentativas de reenviar uma notificação caso o envio falhe, em segundos (0-3600). Se '0' for especificado, o Zabbix tentará novamente imediatamente. Sufixos de tempo são compatíveis (por exemplo, 30s, 1m, 1h). |
Mídia do usuário
Enquanto os tipos de mídia definem como uma notificação será enviada, as mídias do usuário definem para onde a notificação deve ser enviada.
As mídias do usuário (por exemplo, endereço de e-mail, ID de usuário do webhook etc.) devem ser definidas no perfil do usuário, independentemente do método de entrega. Uma ação que envia mensagens ao usuário Admin usando o webhook X não conseguirá entregá-las se os detalhes de entrega do webhook X não estiverem definidos no perfil do usuário Admin.
Para definir as mídias do usuário:
- Acesse Usuários > Usuários e abra o formulário de propriedades do usuário. Como alternativa, acesse Configurações do usuário > Notificações no seu próprio perfil de usuário.
- Clique em Adicionar na aba Mídia.
- Insira os parâmetros da mídia do usuário no formulário.
| Parâmetro | Descrição |
|---|---|
| Tipo | A lista suspensa contém os nomes dos tipos de mídia habilitados. Observe que, ao editar uma mídia de um tipo de mídia desabilitado, o tipo será exibido em vermelho. |
| Enviar para | Insira as informações de contato para onde as mensagens devem ser enviadas. Para o tipo de mídia de e-mail, vários endereços podem ser adicionados clicando no botão  abaixo do campo de endereço. Nesse caso, as notificações serão enviadas para todos os endereços listados. Para obter exemplos de endereços, consulte a descrição do parâmetro E-mail para o tipo de mídia e-mail. |
| Quando ativo | Você pode limitar o período em que as mensagens são enviadas, por exemplo, definindo apenas os dias úteis (1-5,09:00-18:00). Observe que esse limite é baseado no fuso horário do usuário. Se o fuso horário do usuário for alterado e for diferente do fuso horário do sistema, talvez seja necessário ajustar esse limite para não perder mensagens importantes. Consulte a página Especificação de períodos para obter uma descrição do formato. Macros de usuário são compatíveis. |
| Usar se a severidade | Marque as caixas de seleção das severidades de trigger para as quais deseja receber notificações. Observação: a severidade padrão ('Não classificado') deve estar marcada se você quiser receber notificações para eventos que não sejam de trigger. Após salvar, as severidades de trigger selecionadas serão exibidas nas cores de severidade correspondentes, enquanto as não selecionadas ficarão esmaecidas. |
| Status | Status da mídia do usuário. Habilitado - está em uso. Desabilitado - não está sendo usado. |