Reconhecer, fechar e comentar (ACK)
Reconhecer (dar ACK) é dizer "estou nisso". No Sentrya o ACK vai até o Zabbix de origem — com o seu usuário do Zabbix, 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ção | O que faz | Bit no Zabbix |
|---|---|---|
| Confirmar (acknowledge) | Marca o problema como reconhecido no Zabbix. Vem marcada por padrão. | 2 |
| Mensagem | Comentário do reconhecimento (opcional, até 2048 caracteres). Um texto preenchido já conta como ação. | 4 |
| Mudar severidade | Abre Nova severidade com as seis opções e atualiza a severidade do problema. | 8 |
| Fechar problema | Fecha 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
- 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.
- Escolha as ações Mantenha Confirmar (acknowledge), escreva a Mensagem se quiser deixar contexto, e ligue Mudar severidade ou Fechar problema quando fizer sentido.
- Aplique Toque em Aplicar ACK. Se a confirmação por biometria estiver ativa, confirme.
Quem pode
| Papel | Dar ACK | Observação |
|---|---|---|
| Admin | Sim | Em qualquer incidente que enxerga. |
| Operador | Sim | Só nos incidentes que ele vê. Para o servidor, um incidente fora dos grupos de um Operador restrito é como um incidente que não existe: ele sai do lote, e um lote só com incidentes assim é recusado. |
| Visualizador | Não | Vê o aviso "Seu papel é Visualizador. Peça ao administrador para ser Operador." Vincular o Zabbix não muda o papel. O servidor também recusa. |
Veja Papéis e permissões.
Em nome de quem o ACK sai
O formulário diz, antes de você aplicar, em nome de quem o ACK vai aparecer no Zabbix:
| Situação no servidor do incidente | Linha no formulário | O que o Zabbix recebe |
|---|---|---|
| Você tem um Vínculo com o Zabbix válido | "Assinado como fulano.silva" | O ACK com o seu usuário do Zabbix e a mensagem como você a digitou. |
| Sem vínculo, com vínculo de outro servidor ou com o vínculo com problema (num servidor que não usa as permissões do Zabbix) | "Vai aparecer no Zabbix como api.sentrya, com seu nome no comentário.", com o atalho Vincular meu Zabbix (ou Revincular, quando o seu vínculo parou de funcionar) | O ACK com o usuário da coleta, o usuário com que o Sentrya lê aquele Zabbix. A mensagem ganha, numa linha própria no fim, o carimbo "— Fulano Silva, via Sentrya". Sem mensagem digitada, o comentário é só o carimbo. Se a mensagem e o carimbo passarem de 2048 caracteres, o fim do seu texto é cortado com "…"; o carimbo nunca. |
| O vínculo está com problema num servidor com Usar permissões do Zabbix | "Seu vínculo com o Zabbix parou de funcionar neste servidor. Revincule para reconhecer.", com o botão de aplicar desativado e o atalho Revincular | Nada. Nesse servidor você também deixa de ver os incidentes até revincular; veja Grupos visíveis: o que cada um enxerga. |
| A empresa exige vínculo e você não tem vínculo que funcione naquele servidor | "A empresa exige vínculo com o Zabbix para reconhecer.", com o botão de aplicar desativado e o atalho Vincular meu Zabbix | Nada. O ACK não sai até você vincular. |
O nome do exemplo, api.sentrya, é o usuário da coleta de cada empresa. O Sentrya descobre esse nome ao salvar o servidor, a cada Verificar conexão que dá certo e ao trocar a conexão. Enquanto ele não sabe o nome, o formulário diz "Vai aparecer no Zabbix como o usuário da coleta do servidor, com seu nome no comentário." Veja O que o Sentrya lê do seu Zabbix. Quando o Zabbix deixa de aceitar o seu vínculo (o token foi apagado ou venceu, ou o seu usuário foi desativado lá), o vínculo fica marcado como com problema no seu perfil para você revincular.
A trilha do Sentrya registra o nome da sua conta nos dois casos. No Histórico de ACKs, um ACK que saiu com o usuário da coleta aparece como "Fulano · via api.sentrya".
Num servidor ligado pelo Sentrya Connector, depende do conector:
- Conector atualizado, com os tokens de pessoa ligados (o padrão): o ACK com vínculo sai com o seu usuário, como numa conexão direta. O token do seu usuário fica guardado no conector, na máquina da sua empresa, e o Sentrya nunca o vê.
- Tokens de pessoa desligados no conector por quem cuida dele: o ACK sai com o usuário da coleta, com o carimbo, com ou sem vínculo. O formulário avisa: "Vai aparecer no Zabbix como
api.sentrya, com seu nome no comentário. Os tokens de pessoa estão desligados no Sentrya Connector deste servidor." - Conector de uma versão que ainda não guarda tokens de pessoa: o ACK sai com o usuário da coleta, com o carimbo, com ou sem vínculo, e o formulário avisa: "Para assinar com o seu usuário, o Sentrya Connector deste servidor precisa ser atualizado."
Num Zabbix anterior à 5.4, que não tem token de API, o ACK pelo conector sai sempre com o usuário da coleta, com o carimbo, com qualquer versão do conector: atualizar o conector não muda isso, e o formulário não pede a atualização.
Se você vinculou antes de o conector ser atualizado, o seu vínculo só diz quem você é: o ACK continua saindo com o usuário da coleta, com o carimbo, e o formulário oferece Revincular. E se o conector perdeu o seu token (foi registrado de novo, ou o endereço do Zabbix mudou nele), o vínculo passa a Com problema, e o ACK segue as linhas de vínculo com problema da tabela acima até você revincular. Veja Vínculo do usuário com o Zabbix.
Com vínculo, vale a permissão do seu usuário no Zabbix
Com vínculo, o ACK sai com o token de API do seu usuário do Zabbix, e o Zabbix decide o que esse usuário pode fazer. O seu papel no Sentrya continua valendo antes: um Visualizador não reconhece, mesmo que o Zabbix deixe.
| Permissão do seu usuário no grupo do host | Confirmar e Mensagem | Mudar severidade e Fechar problema |
|---|---|---|
| Leitura | Passam | O Zabbix recusa |
| Leitura e escrita | Passam | Passam |
O papel do seu usuário no Zabbix também pode tirar cada ação, por exemplo "Reconhecer problemas". Quando o Zabbix recusa a ação com o seu usuário, o Sentrya não refaz o ACK com o usuário da coleta (seria passar por cima da permissão do Zabbix): o app diz o motivo, conforme a tabela de Erros traduzidos abaixo. Peça a quem administra o Zabbix para liberar, ou reconheça sem as opções recusadas.
Nos servidores com Usar permissões do Zabbix, o Sentrya já sabe, antes, a sua permissão em cada incidente: vale a maior permissão do seu usuário entre os grupos de hosts do incidente. Num incidente em que você só tem leitura, Fechar problema e Mudar severidade não aparecem, e o formulário diz "Seu usuário do Zabbix só tem leitura neste grupo: dá para reconhecer e comentar." Num lote com algum incidente assim, as duas opções somem para o lote inteiro. Nos outros servidores, as opções aparecem e a palavra final é do Zabbix. Quando o Zabbix recusa uma ação por falta de permissão, o Sentrya copia de novo as suas permissões.
Nesses servidores, o Sentrya também confere antes de enviar: se você só tem leitura em algum incidente do lote, um pedido para fechar ou mudar a severidade é recusado com "Seu usuário do Zabbix não tem permissão de escrita neste grupo para fechar ou mudar a severidade.", e nada do lote é reconhecido. A conferência vale também quando o reconhecimento sairia com o usuário da coleta, por exemplo num servidor ligado por um Sentrya Connector que não guarda os tokens de pessoa: o usuário da coleta pode fechar no Zabbix, mas o Sentrya respeita a permissão do seu usuário. Reconhecer e comentar continuam liberados com leitura.
Exigir vínculo para reconhecer
A empresa pode exigir que todo reconhecimento saia com o usuário da própria pessoa. O administrador liga a opção no painel administrativo, em Empresa → Configurações, no cartão Reconhecimento de incidentes: Exigir vínculo com o Zabbix para reconhecer. Ela vem desligada.
- Desligada, quem não tem vínculo reconhece com o usuário da coleta, com o carimbo.
- Ligada, Operadores e Admins sem vínculo que funcione num servidor não reconhecem os incidentes daquele servidor até vincular. O formulário avisa antes, e o servidor recusa o lote inteiro sem chamar o Zabbix.
- Num servidor ligado por um Sentrya Connector que não guarda os tokens de pessoa (de uma versão anterior, ou com eles desligados), quem está vinculado continua reconhecendo, com o usuário da coleta e o carimbo: a limitação é do conector, não da pessoa. Já quem vinculou antes de o conector ser atualizado precisa revincular para reconhecer.
- Os reconhecimentos feitos por integração, com um token de serviço, não são afetados.
Ao ligar, a confirmação diz quantos operadores e administradores ativos estão hoje sem vínculo que funcione em algum servidor e deixam de reconhecer ali. Entra na conta também quem não tem vínculo num servidor ligado por um Sentrya Connector que não guarda os tokens de pessoa ou num Zabbix anterior à 5.4: com a política, essa pessoa fica bloqueada. Quem já está vinculado num desses servidores não entra, porque continua reconhecendo. Veja Papéis e permissões.
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 app | Causa |
|---|---|
| "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. |
| "A empresa exige vínculo com o Zabbix para reconhecer." | A opção Exigir vínculo com o Zabbix para reconhecer está ligada e você não tem vínculo que funcione num dos servidores do lote. Faça o Vínculo com o Zabbix. |
| "Seu vínculo com o Zabbix parou de funcionar neste servidor. Revincule para reconhecer." | O seu vínculo parou de funcionar num servidor do lote que usa Usar permissões do Zabbix. Nada do lote é reconhecido. Faça o Vínculo com o Zabbix de novo no cartão do servidor. |
| "Seu usuário do Zabbix não tem permissão de escrita neste grupo para fechar ou mudar a severidade." | Com vínculo, o seu usuário do Zabbix só tem leitura naquele grupo de hosts. Num servidor com Usar permissões do Zabbix, o Sentrya recusa antes de enviar, mesmo quando o reconhecimento sairia com o usuário da coleta. Desmarque Fechar problema e Mudar severidade. |
| "Seu usuário do Zabbix não tem permissão neste grupo de hosts." | Com vínculo, o seu usuário do Zabbix não tem acesso ao grupo de hosts do incidente. Peça a quem administra o Zabbix para liberar o grupo. |
| "Seu papel no Zabbix não permite reconhecer problemas." | O papel do seu usuário no Zabbix não tem "Reconhecer problemas" (Acknowledge problems). |
| "Seu papel no Zabbix não permite usar a API." | O papel do seu usuário no Zabbix não deixa a API reconhecer problemas (o event.acknowledge está fora da lista de métodos do papel). Se o papel perdeu o acesso à API por inteiro, o Sentrya não mostra esse erro: o seu vínculo passa a Com problema e o ACK sai com o usuário da coleta, com o carimbo. |
| "Seu papel é Visualizador. Peça ao administrador para ser Operador." | O seu papel no Sentrya não reconhece incidentes, com ou sem vínculo. |
| "O Zabbix recusou esta ação com o seu usuário." | O Zabbix recusou por outro motivo de permissão. Confira com quem administra o Zabbix. |
| "nenhum incidente encontrado para reconhecer" | Os ids do lote não existem mais na sua empresa, ou estão fora do que você vê. |
| "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.
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.