Aviso de coleta parada
Quando um Zabbix conectado para de responder, os alertas dele param de chegar ao Sentrya. O aviso de coleta parada percebe isso e avisa quem a empresa escolher, com a urgência escolhida — para que uma lista de incidentes parada nunca pareça "tudo em ordem".
Como o Sentrya percebe que a coleta parou
O Sentrya consulta cada servidor Zabbix a cada poucos segundos. Quando uma consulta falha, começa uma sequência de falhas:
- Falhando O servidor passa a mostrar "Falhando desde 14:32 · tentando de novo" na lista de Servidores Zabbix. Ninguém é notificado ainda: um reinício do Zabbix ou uma oscilação de rede costuma se resolver sozinho.
- Coleta parada Vencido o tempo de Avisar depois de (5 minutos, se a empresa não mudou), o Sentrya faz mais uma tentativa. Se ela também falhar, o servidor passa a "Coleta parada há …" e o aviso sai para quem a empresa escolheu.
- Voltou Na primeira consulta que der certo, a coleta volta ao normal, os alertas represados chegam e, se estiver ligado, sai o aviso de volta.
Se o Zabbix responder de novo antes do fim da carência, nada é enviado.
A volta é detectada rápido. Com a coleta parada confirmada, o Sentrya tenta de novo a cada cerca de 1 minuto no primeiro dia, para o aviso de volta e os alertas represados não demorarem.
Servidor que sai da coleta. Se o servidor é removido, volta para a Primeira coleta ou fica fora da coleta porque a empresa perdeu o acesso (teste encerrado ou empresa suspensa), a falha em curso é encerrada sem aviso de volta. Quando ele voltar a ser coletado e falhar de novo, a contagem recomeça do zero.
Quando a conexão usa o Sentrya Connector
O mesmo aviso vale para os servidores ligados pelo Sentrya Connector. O Sentrya distingue um conector offline, um conector conectado que não alcança o Zabbix, uma configuração local que recusa a coleta e uma chamada que não respondeu a tempo. O detalhe da falha aparece no estado da coleta.
Se um conector que já se conectou ficar offline antes de ter um servidor em coleta, os administradores da empresa também recebem o aviso depois da carência. Se a audiência estiver em Toda a empresa, todos os usuários ativos recebem. A volta é avisada depois que a conexão se mantiver estável por 1 minuto. Desativar ou revogar o conector encerra o episódio sem aviso de volta.
Falhas do lado do Sentrya. Se o nosso gateway estiver indisponível, houver queda em massa de conectores ou uma manutenção planejada, os avisos e lembretes correspondentes ficam segurados. A equipe do Sentrya é avisada para resolver a falha. Esses casos não devem ser tratados como problema da rede de cada empresa.
O motivo da falha
O aviso e a lista de servidores dizem por que a coleta parou, com o detalhe que o Sentrya recebeu (por exemplo "tempo esgotado" ou "HTTP 502"):
| Motivo | O que significa | O que conferir |
|---|---|---|
| Sem conexão | O Sentrya não consegue se conectar ao endereço do Zabbix: tempo esgotado, conexão recusada, endereço não encontrado (DNS) ou falha no certificado TLS. | Se o Zabbix e o servidor web estão no ar e se o firewall libera o acesso do Sentrya. |
| Erro HTTP | O endereço responde, mas não como a API do Zabbix — o típico HTTP 502 ou 503 quando o frontend do Zabbix caiu. | O frontend do Zabbix e o endereço cadastrado. |
| Credencial recusada | O Zabbix recusou o token de API ou o usuário e senha da conexão. | Se o token foi revogado ou expirou, ou se a senha do usuário mudou. |
| Erro da API do Zabbix | A API respondeu com erro, com a mensagem do próprio Zabbix. | O banco de dados do Zabbix e as permissões do usuário da integração. |
| Endereço bloqueado | O endereço do Zabbix passou a apontar para uma rede interna, que o Sentrya não acessa por segurança. | Use o endereço público do Zabbix. |
| Resposta grande demais | A resposta do Zabbix passou do tamanho máximo que o Sentrya aceita. | Se continuar, fale com o suporte. |
| Sentrya Connector offline | O Sentrya Connector deste servidor não está conectado ao Sentrya. | Se o Sentrya Connector está em execução e se a rede da empresa permite a conexão com o Sentrya. |
| Zabbix inacessível pelo Connector | O conector está online, mas não alcança o Zabbix na rede da empresa. | O endereço do Zabbix e o acesso a ele a partir da máquina do Sentrya Connector. |
| Configuração do Connector | A configuração local do conector recusou a coleta deste servidor. | Se este servidor está cadastrado e permitido na configuração do Sentrya Connector. |
| Sentrya Connector sem resposta | O conector está conectado, mas não respondeu dentro do prazo. | A máquina e a conexão de rede do Sentrya Connector. Se continuar sem resposta, fale com o suporte. |
| Falha de coleta | Qualquer outra falha, com o detalhe que o Sentrya registrou. | Se continuar, fale com o suporte. |
Falha de muitas empresas ao mesmo tempo. Se servidores de várias empresas diferentes ficam sem conexão no mesmo momento, o problema provavelmente é do lado do Sentrya, não do seu Zabbix. Nesse caso o aviso de "Sem conexão" não é disparado para cada empresa. Credencial recusada e erro de API continuam sendo avisados, porque provam que o seu Zabbix respondeu.
Falha do Sentrya no caminho até o conector. Num servidor ligado pelo Sentrya Connector, quando a falha é do próprio Sentrya — o serviço que fala com os conectores fora do ar, ou o conector no limite de chamadas ao mesmo tempo —, o Zabbix nem chega a ser chamado e o aviso de coleta parada não é disparado.
O que o aviso não enxerga. O Sentrya fala com a API do Zabbix. Se só o processo do servidor Zabbix parar e o frontend continuar respondendo, a coleta segue funcionando — só não aparecem problemas novos — e o aviso de coleta parada não dispara. Monitore o próprio Zabbix server com um item no Zabbix, como de costume.
Configurar o aviso
A configuração é da empresa e vale para todos os servidores Zabbix conectados. Ela nasce ligada. Só o Admin altera; Operadores e Visualizadores veem a configuração em leitura, para saber se e como serão avisados.
- No app: Ajustes → Servidores Zabbix → Aviso de coleta parada. No iPhone, salve pelo ✓ no topo; no Android, pelo botão Salvar no rodapé.
- No painel web: Ajustes → Servidores Zabbix, no bloco Aviso de coleta parada abaixo dos servidores. As mudanças ficam como "Alterações não salvas" até você clicar em Salvar (ou Descartar).
- No painel da empresa: Conexões → Zabbix, no cartão Aviso de coleta parada, botão Configurar aviso.
| Opção | Valores | Valor inicial |
|---|---|---|
| Avisar quando um Zabbix parar de coletar | Ligado ou desligado. Desligado, a coleta parada continua aparecendo na lista de servidores, mas ninguém recebe notificação. | Ligado |
| Urgência do aviso | Sirene, Crítico, Padrão ou Silencioso — a mesma escala dos ouvintes (veja Urgências e sons). Padrão toca o som de alerta sem furar o Não Perturbe; para quem tem plantão, suba para Crítico ou Sirene. | Padrão |
| Quem recebe | Administradores e quem ouve o servidor (quem tem ouvinte ativo com algum gatilho daquele Zabbix, inclusive por um ouvinte compartilhado que ativou, mais os administradores), Só administradores ou Toda a empresa. A opção do valor inicial aparece como recomendada. | Administradores e quem ouve o servidor |
| Avisar depois de | 3, 5, 10, 15 ou 30 minutos falhando sem parar. | 5 min |
| Repetir enquanto continuar parada | Não repetir, a cada 30 min, 1 h, 2 h ou 4 h. | Não repetir |
| Avisar quando a coleta voltar | Ligado ou desligado, com a Urgência do aviso de volta: Informativo, Padrão, Crítico ou Silencioso. A Sirene não é oferecida aqui: o aviso de volta é uma boa notícia. | Ligado, Informativo |
Sirene no aviso de coleta parada. É o alarme máximo: no app, escolher a Sirene pede a mesma confirmação dos ouvintes; no painel web e no painel da empresa, o aviso aparece ao lado da opção. No Android ela pode tocar em tela cheia; no iPhone ela só atravessa o modo silencioso em aparelhos que liberaram os alertas críticos do Sentrya, e toca no volume escolhido em Volume da sirene neste iPhone, o mesmo dos ouvintes. Como quem escolhe é o Admin, a tela Aviso de coleta parada do app mostra "Permitir a Sirene neste iPhone" a quem ainda não deu essa permissão.
O que chega no celular
| Aviso | Título | Corpo |
|---|---|---|
| Coleta parada | Coleta parada · nome do servidor | O motivo, há quanto tempo e "Alertas novos deste Zabbix não estão chegando." |
| Lembrete | Coleta ainda parada · nome do servidor | Há quanto tempo está parada e o motivo resumido. |
| Coleta voltou | Coleta normalizada · nome do servidor | Quanto tempo ficou parada e "Os alertas voltaram a chegar." |
Tocar no aviso abre Servidores Zabbix, onde estão o motivo e o que conferir. Com a Sirene no Android e o app fechado, o alarme em tela cheia leva à aba Incidentes, onde está a faixa de coleta parada. O aviso não mexe no contador do ícone e não tem botões de ação. Uma mudança na configuração vale também para o aviso que ainda não saiu: desligar o aviso ou trocar a urgência pega até o que estava na fila.
O que aparece na tela
- Faixa de coleta parada: enquanto houver servidor com a coleta parada, o app mostra a faixa no topo da aba Incidentes (em Zabbix), e o painel web a mostra no topo de todas as páginas: "Coleta parada no servidor há 12m. Alertas novos dele não estão chegando." O botão Ver leva à lista de servidores. A faixa some sozinha quando a coleta volta.
- Faixa do Sentrya Connector: se um conector ficar offline sem nenhum servidor em coleta, depois da carência o app mostra a faixa no topo da aba Incidentes (em Zabbix) e de Servidores Zabbix, e o painel web a mostra no topo de todas as páginas: "NOC-01 está offline há 2h 15m, sem servidor em coleta.", com o que conferir. O botão Ver leva à página do Sentrya Connector (para quem é visualizador, a faixa só informa).
- Lista de servidores: o servidor ganha o selo Coleta parada, há quanto tempo, se o aviso já foi enviado, o motivo e o que conferir. Na carência, aparece "Falhando desde … · tentando de novo".
- Painel da empresa: um alerta no topo de Conexões → Zabbix e o estado da coleta junto ao nome do servidor; com a coleta parada, o que conferir fica no ícone ao lado do estado. As falhas do Connector têm motivo e orientação próprios. Um Connector offline sem servidor em coleta também aparece no topo depois da carência, com o tempo desde o último contato e o que conferir.
No navegador. Com o painel web aberto, quem recebe o aviso também é notificado pelo navegador, com o som da urgência escolhida pela empresa. Vale o interruptor Incidentes das notificações do navegador em Perfil → Preferências (veja Notificações do navegador).