Navegar na documentação

Sirene: o alerta máximo

A Sirene é o alerta máximo do Sentrya: no Android pode virar uma ligação em tela cheia que insiste até você parar; no iPhone pode chegar como Alerta Crítico, no volume máximo, mesmo no silencioso. Existe para acordar quem está de plantão, e por isso tem regras próprias.

O contrato da Sirene

A Sirene é exclusiva da severidade Desastre. O servidor garante isso em três pontos:

  • Na criação do ouvinte: só gatilhos específicos (trigger ou key), no máximo 10 por ouvinte, sem host inteiro, grupo inteiro, fonte inteira, palavra-chave ou severidade mínima. O assistente do Zabbix lista apenas triggers de Desastre.
  • No recebimento do webhook: um alerta de problema cuja key está coberta por ouvinte Sirene precisa vir com severity: 5. Abaixo disso a API responde 422 e não aceita o alerta. Resoluções passam sempre.
  • Na entrega: se um incidente de severidade menor ainda assim chegar a um ouvinte Sirene, o push sai como Crítico.
POST/api/v1/alerts
{
  "success": false,
  "siren_listener": true,
  "error": "este alerta está direcionado a um ouvinte com urgência SIRENE, exclusiva de incidentes críticos — envie severity: 5 (Desastre) ou mude a urgência do ouvinte"
}

Com severity: 5, a resposta 202 traz "siren_listener": true. Um ouvinte Sirene desativado deixa de reservar a key: enquanto ele estiver mudo, alertas de severidade menor voltam a ser aceitos. Veja Referência do payload.

Ativar o perfil Sirene?

Ao escolher Sirene, o app abre a folha ALERTA MÁXIMO · Ativar o perfil Sirene? com três blocos, e só ativa depois do toque em Ativar Sirene. Arrastar a folha para baixo vale como recusa.

BlocoAndroidiOS
1Toca como uma chamada: o celular acende e o alarme toma a tela inteira, mesmo bloqueado.Sempre no volume máximo: nem o botão físico de volume reduz a sirene.
2Fura o Não Perturbe: o som sai no volume de alarme, como um despertador.Fura absolutamente tudo: silencioso, Não Perturbe, qualquer Foco e volume zerado.
3Só para o realmente crítico: reserve para incidentes que exigem ação imediata, a qualquer hora.

No Android: a ligação em tela cheia

Quando o servidor está configurado para isso, o push da Sirene chega ao app como dados e o próprio app cria a "ligação": a tela acende mesmo com o aparelho bloqueado, a sirene toca em loop e o alarme mostra o rótulo ALERTA SIRENE, o nome do incidente e dois botões, Ver incidente e Parar sirene. Um novo disparo substitui o alarme anterior; sirenes não se empilham.

O app conduz você por até três permissões, cada uma pedida uma vez:

  1. Alarme em tela cheia No Android 14 ou mais recente, a tela cheia é um acesso especial. Ao escolher Sirene, o diálogo Alarme em tela cheia oferece Permitir, que abre a tela do sistema. Se já estiver ativado, não é preciso mudar nada.
  2. Sua sirene está enfraquecida Se o Android rebaixou a notificação da sirene, o app avisa ao abrir e oferece Corrigir: na categoria Sirene (fura o Não Perturbe), deixe a importância no máximo e ative Ignorar Não Perturbe.
  3. Sirene com o app fechado A otimização de bateria pode impedir o alarme quando o app está fechado. O diálogo oferece Ajustar: escolha Não otimizar para o Flowbix Sentrya (em aparelhos Samsung, coloque o app em "nunca suspensos").
Não pule o passo da bateria. Sem a isenção, o aparelho pode suspender o app e a ligação nunca nasce, embora a notificação comum continue chegando. Veja Android: canais, bateria e tela cheia.

No iPhone: Alertas Críticos

No iOS a Sirene pode usar os Alertas Críticos da Apple, que tocam no volume definido pelo servidor ignorando o silencioso, o Não Perturbe e os modos Foco. Ao escolher o perfil, o app pede a permissão de Alertas Críticos, que o sistema mostra uma única vez. Se ela for negada, aparece Permissão necessária com o botão Abrir Ajustes: permita os Alertas Críticos do Flowbix Sentrya em Ajustes › Notificações. Sem a permissão, o perfil não é ativado. Se o servidor não estiver configurado para Alertas Críticos, a Sirene chega como alerta sensível ao tempo. Veja iOS: sons, Foco e alertas críticos.

Testar antes do primeiro incidente

O card da Sirene tem o botão Testar. No iPhone, ele envia um Alerta Crítico real a 50% do volume; no Android, abre a mesma tela do alarme com a sirene em volume reduzido, sem push. Faça o teste depois de ativar as permissões, para descobrir agora se algo está bloqueando. Veja Urgências e sons.

Quando usar e quando não usar

Use a Sirene paraNão use a Sirene para
Poucos gatilhos que significam queda total: link principal, roteador de borda, energia do data center.Alertas frequentes ou ruidosos: cada disparo acorda alguém e desgasta a confiança no alarme.
O que exige ação em minutos, a qualquer hora.Host inteiro, grupo inteiro ou palavra-chave: a Sirene não aceita, use Crítico.
Triggers de severidade Desastre no Zabbix, ou alertas de webhook que sempre chegam com severity: 5.Fontes de webhook que não controlam a severidade enviada: os alertas seriam recusados com 422.

Veja também