Navegar na documentação

Descartar alertas de webhook

Um alerta de webhook só resolve quando a fonte manda dizer que resolveu — ou quando alguém resolve à mão. Descartar alerta (um) e Resolver (vários) são esse caminho manual. Esta página explica o que eles fazem, o que não fazem e por que o ACK não substitui nenhum dos dois.

Quando usar

Use quando a fonte não vai enviar status: "resolved": um script que só sabe abrir alerta, um alerta solto sem key, um teste de integração, ou um problema que já foi tratado fora do sistema. O ideal continua sendo a fonte fechar o que abriu — veja Ciclo de vida do alerta e a key.

Onde está

LugarBotãoAlcance
Detalhe do incidenteDescartar alerta (texto vermelho, no fim da folha)Um incidente
Aba Incidentes → Webhooks, em modo seleçãoResolverAté 500 selecionados
Notificação de webhookDescartarUm incidente; o botão abre o app para concluir

O que acontece

  1. O incidente vira Resolvido No Sentrya, o estado muda para Resolvido com a data de agora. Nada é apagado: ele continua no filtro Situação: Resolvidos e no histórico.
  2. A fonte não é avisada Descartar é uma ação local. O sistema que enviou o alerta não recebe nenhuma chamada.
  3. O app confirma "Alerta descartado ✓" (um) ou "Selecionados resolvidos ✓" (lote). O feed e o Resumo atualizam em seguida.

Se a fonte enviar de novo a mesma key, o mesmo card reabre em Problema e a contagem de Recorrências sobe — o descarte não impede o problema de voltar. Quando as Conversas estão habilitadas no seu ambiente, a sala do incidente recebe um aviso de resolução.

Descartar não é ACK

Reconhecer (ACK)Descartar alerta / Resolver
EstadoContinua em ProblemaVira Resolvido
O que registraSelo Reconhecido, mensagem, nova severidade — na trilha do Histórico de ACKsData de resolução
Some da lista de ativos?NãoSim (após alguns segundos em verde)
Vale para Zabbix?SimNão

Em webhooks o ACK nunca fecha. Marcar Fechar problema num lote com webhook devolve o erro "incidentes de webhook não podem ser fechados pelo ACK; use dispensar" — e por isso o formulário nem mostra essa opção quando o alvo é um webhook. Veja Reconhecer, fechar e comentar (ACK).

Incidentes do Zabbix não podem ser descartados. O Zabbix é a fonte de verdade: um problema descartado no Sentrya voltaria na próxima coleta. O servidor recusa com "incidente não pode ser dispensado (não é de webhook ativo)" e o app não mostra o botão. Para encerrar um problema do Zabbix use Fechar problema no ACK (se a trigger permitir) ou resolva a causa no Zabbix.

Quem pode

Admin e Operador. O Visualizador não vê o botão e o servidor recusa a chamada. Veja Papéis e permissões.

Regras do lote

  • Até 500 incidentes por chamada.
  • Só incidentes de webhook ativos da sua empresa são resolvidos; ids de Zabbix, de outra origem ou já resolvidos são ignorados em silêncio.
  • A resposta informa quantos foram de fato resolvidos; o app usa esse número para conciliar a seleção.
POST/api/v1/incidents-dismiss/:id
POST/api/v1/incidents-dismiss

Para automatizar, veja Reconhecer e dispensar pela API.

Prefira mandar a key. Se você controla a fonte, envie sempre uma key estável e um evento resolved quando o problema acabar. Descartar à mão deve ser exceção, não rotina — veja Exemplos de integração.