Navegar na documentação

Reconhecer, fechar e comentar (ACK)

Reconhecer (dar ACK) é dizer "estou nisso". No Sentrya o ACK vai até o Zabbix de origem — com o seu nome, se a sua conta estiver vinculada — e volta para o app na mesma hora. Esta página cobre o formulário, quem pode usá-lo, o que acontece com webhooks e os erros mais comuns.

Onde dar ACK

  • No detalhe, pelo botão Reconhecer incidente.
  • Na aba Incidentes, em modo seleção: ACK em massa (Zabbix) ou Reconhecer (Webhooks).
  • Direto no push de um incidente do Zabbix, pelo botão Dar ACK.

O formulário "Reconhecer incidente(s)"

O subtítulo mostra quantos incidentes estão no lote ("N incidente(s) selecionado(s)"). Cada opção liga uma operação do event.acknowledge do Zabbix:

OpçãoO que fazBit no Zabbix
Confirmar (acknowledge)Marca o problema como reconhecido no Zabbix. Vem marcada por padrão.2
MensagemComentário do reconhecimento (opcional, até 2048 caracteres). Um texto preenchido já conta como ação.4
Mudar severidadeAbre Nova severidade com as seis opções e atualiza a severidade do problema.8
Fechar problemaFecha manualmente o problema, se a trigger permitir. Só aparece para incidentes do Zabbix.1

É preciso escolher ao menos uma ação; senão o app avisa "Escolha ao menos uma ação". Aplicar ACK envia. Ao terminar, o app mostra "ACK aplicado ✓" e o selo Reconhecido aparece no card e no detalhe imediatamente — o Sentrya reflete o estado na hora, sem esperar a próxima coleta.

Passo a passo

  1. Abra o formulário No detalhe, toque em Reconhecer incidente. Para vários de uma vez, dê um toque longo num card, marque os demais e toque em ACK em massa.
  2. Escolha as ações Mantenha Confirmar (acknowledge), escreva a Mensagem se quiser deixar contexto, e ligue Mudar severidade ou Fechar problema quando fizer sentido.
  3. Aplique Toque em Aplicar ACK. Se a confirmação por biometria estiver ativa, confirme.

Quem pode

PapelDar ACKObservação
AdminSimEm qualquer incidente que enxerga.
OperadorSimNos incidentes dos seus Grupos visíveis.
VisualizadorNãoVê o aviso "Para dar ACK, vincule sua conta ao Zabbix no seu perfil." O servidor também recusa.

Veja Papéis e permissões.

Em nome de quem o ACK sai

Se você tem um Vínculo com o Zabbix válido para o servidor daquele incidente, o Sentrya faz login com a sua credencial e o ACK aparece no Zabbix com o seu usuário. Sem vínculo, com vínculo de outro servidor ou com senha que não bate mais, o ACK sai com a credencial cadastrada em Servidores Zabbix — e o vínculo quebrado fica marcado no seu perfil para você atualizar. A trilha do Sentrya registra o nome da sua conta nos dois casos.

Espelho com o painel do Zabbix

O Zabbix é a fonte de verdade do estado do evento. A cada coleta o Sentrya copia o campo acknowledged do problema: um ACK dado no painel do Zabbix aparece no app, e um ACK removido lá deixa o card sem o selo. O Histórico de ACKs do detalhe junta as duas trilhas; veja Detalhe do incidente.

Erros traduzidos

Mensagem no appCausa
"este problema não pode ser fechado manualmente: a trigger no Zabbix não permite fechamento manual. Você ainda pode reconhecer (ACK) o problema."A trigger não tem Allow manual close. Desmarque Fechar problema.
"o Zabbix recusou a operação: …"O Zabbix devolveu outro erro (permissão, evento já fechado…). O texto após os dois-pontos é a mensagem real do Zabbix.
"nenhum incidente encontrado para reconhecer"Os ids do lote não existem mais na sua empresa.
"incidentes de webhook não podem ser fechados pelo ACK; use dispensar"Você marcou Fechar problema num lote com webhook. Use Resolver / Descartar alerta.

ACK em incidentes de webhook

Webhook não tem Zabbix para onde ir, então o ACK é local: Reconhecer liga o selo Reconhecido, grava a mensagem e a mudança de severidade na trilha, e nunca fecha. Para encerrar um alerta de webhook use Resolver (na seleção) ou Descartar alerta (no detalhe) — veja Descartar alertas de webhook. O ACK só vale enquanto o incidente está em Problema.

Lotes

Um lote aceita até 500 incidentes e pode misturar servidores Zabbix diferentes: o Sentrya agrupa por servidor e manda um event.acknowledge para cada um. Se algum servidor recusar, o app mostra o erro daquele servidor.

POST/api/v1/incidents/ack

Detalhes do corpo em Reconhecer e dispensar pela API.

ACK direto pelo push

Notificações de incidentes do Zabbix trazem o botão Dar ACK com um campo "Mensagem do ACK (opcional)" e o botão Enviar. O ACK sai do próprio card, sem abrir o app, e só faz Confirmar (acknowledge) com a mensagem digitada; para mudar severidade ou fechar, abra o detalhe. Veja Tipos de notificação e botões de ação.

Filtre pelo que ainda ninguém pegou. Em Filtros → Reconhecimento, "Não reconhecidos" mostra só o que está sem dono; "Por mim" mostra o que você assumiu.