Navegar na documentação

O que é o Modo Ouvinte

O Modo Ouvinte decide o que toca no seu celular. Um Ouvinte é um conjunto nomeado de gatilhos, uma urgência (como toca) e uma regra (quais problemas entram). Serve para quem está de plantão e não pode depender de olhar o feed.

O que compõe um Ouvinte

Cada ouvinte tem um nome, uma lista de gatilhos e um comportamento único: o mesmo som, os mesmos avisos extras e a mesma regra valem para todos os gatilhos daquele ouvinte. Um ouvinte pode misturar gatilhos do Zabbix e de webhooks.

ParteO que defineOnde configurar
GatilhosDo Zabbix: Servidor inteiro, Grupo inteiro, Host inteiro ou uma trigger específica. De webhook: Fonte inteira ou um alerta identificado pela key.Criar um ouvinte do Zabbix · Criar um ouvinte de webhook
UrgênciaSirene, Crítico, Padrão ou Silencioso. Define som, vibração e se atravessa o Não Perturbe. O Informativo é o som reservado ao aviso de resolução.Urgências e sons
RegraManual, Palavra-chave ou Tudo, com Severidade mínima opcional. Vale para o ouvinte inteiro.Regras dinâmicas e palavras-chave
Avisos extrasAvisar em recorrências e Avisar quando resolver. Sem eles, o ouvinte toca só no primeiro disparo.Urgências e sons

Ouvintes são pessoais

Cada usuário tem os próprios ouvintes. Eles ficam ligados à sua conta, e só você os edita. Um colega com o mesmo Zabbix precisa criar os dele. No app, qualquer papel cria e gerencia os próprios ouvintes, inclusive o Visualizador: ouvir não é gerir, e o ouvinte não executa nada no Zabbix. No painel web, o Visualizador só consulta os ouvintes que já tem.

Grupos visíveis mandam. Um ouvinte só fixa e só avisa incidentes de hosts que você pode ver. Se o seu acesso é restrito a alguns grupos, um ouvinte de servidor inteiro cobre apenas a parte que você enxerga. Veja Grupos visíveis.

Sem ouvinte, sem push

O servidor decide quem recebe cada notificação a partir dos ouvintes. Se nenhum ouvinte seu casa com o incidente, nada toca no seu celular, mesmo que o incidente apareça no feed. Os filtros e as Visões da aba Incidentes não interferem: eles mudam o que você vê, não o que toca. Por isso a aba mostra o lembrete Prioridade máxima · ignora filtros.

Um incidente gera até três eventos, e o ouvinte decide quais avisam: o primeiro disparo (sempre), a recorrência (se Avisar em recorrências estiver ligado) e a resolução (se Avisar quando resolver estiver ligado).

A aba Ouvinte

A aba Ouvinte tem duas áreas.

  • Alertando agora: os incidentes ativos que casam com algum ouvinte seu, das severidades mais altas para as mais baixas. Toque num deles para abrir o detalhe.
  • Ouvintes configurados: um card por ouvinte, com nome, origem (nome do servidor Zabbix ou da fonte), quantidade de gatilhos e a urgência. Quando você tem ouvintes das duas origens, a lista se agrupa em Servidores Zabbix e Fontes de Dados, e aparece o filtro Todos / Zabbix / Webhooks. A busca Buscar ouvinte… filtra pelo nome.

Dois selos podem aparecer no card: desativado, quando o ouvinte está guardado mas mudo, e do incidente, quando ele nasceu do atalho no detalhe de um incidente. No card, o sino ativa ou desativa, a lixeira exclui (com confirmação) e o toque no corpo abre Editar ouvinte. Para criar, use Começar pelo Zabbix ou Começar por webhook em Novo ouvinte.

O card fixado no feed

Na aba Incidentes, quando um ouvinte seu tem incidente ativo, um card fica fixado no topo sob o rótulo Modo Ouvinte. É um card só: o incidente ativo mais recente entre os que casam com seus ouvintes, respeitando a origem selecionada (Zabbix ou Webhooks). Os demais continuam no feed normal. Ouvintes desativados não fixam nada.

Ativar o Ouvinte com um toque

No detalhe de qualquer incidente existe o botão Modo Ouvinte. Um toque cria um ouvinte com o nome do incidente, urgência Padrão e um único gatilho: aquele host e aquela trigger (ou a key, no webhook). O botão passa a Ouvinte ativo e o card do ouvinte ganha o selo do incidente. Tocar de novo remove esse ouvinte.

Coberto por um ouvinte maior? Quando o incidente já é alcançado por um ouvinte nomeado (host inteiro, grupo, servidor ou palavra-chave), o detalhe mostra Ouvido por e o nome dele. Tocar em Ouvinte ativo nesse caso pergunta Desativar os ouvintes deste incidente?, porque calaria todos os incidentes daqueles ouvintes. Eles são desativados, não excluídos, e voltam pela aba Ouvinte.

Painel web

No painel web, a tela Modo Ouvinte mostra a faixa Alertando agora, a lista de ouvintes com busca e filtros, e uma gaveta que abre em leitura ao clicar num ouvinte. Editar é um passo explícito, com o botão Editar ouvinte.

Veja também