> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aciona.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Agrupamento e auto-resolução

> Como o aciona.me evita acionamentos duplicados e fecha sozinho o que a ferramenta recuperou.

Um alerta que dispara cem vezes não deve gerar cem acionamentos. E um alerta que se recupera sozinho não deve deixar um acionamento aberto para sempre. As duas coisas dependem do mesmo mecanismo: **correlação**.

## Agrupamento (deduplicação)

Quando um alerta chega, o aciona.me procura um acionamento **aberto** para a mesma origem, considerando organização, serviço, identificador externo do alerta e uma assinatura calculada a partir do conteúdo normalizado.

<Steps>
  <Step title="Encontrou acionamento aberto">
    O alerta é **agregado** ao acionamento existente. A linha do tempo registra o evento de alerta agregado, e nenhuma duplicata é criada.
  </Step>

  <Step title="Não encontrou">
    Um novo acionamento é criado, com notificação e cronômetro de escalonamento próprios.
  </Step>
</Steps>

<Tip>
  Se você está vendo acionamentos duplicados para o mesmo problema, o identificador de correlação enviado pela ferramenta provavelmente muda a cada disparo. Confira a tabela abaixo.
</Tip>

## Auto-resolução

Quando a ferramenta de origem envia o evento de recuperação, o aciona.me localiza o acionamento aberto correlacionado e o resolve automaticamente.

Comportamentos garantidos:

* **Recuperação sem acionamento aberto correspondente:** nada acontece. O alerta é registrado, nenhum acionamento é criado e nenhum erro é lançado.
* **Recuperação para acionamento já resolvido ou encerrado:** ignorado, sem reabrir nem modificar.
* **A auto-resolução registra o evento na linha do tempo**, identificando a fonte que resolveu.

## O identificador de correlação por ferramenta

| Ferramenta              | Identificador                               | O que precisa estar ligado                    |
| ----------------------- | ------------------------------------------- | --------------------------------------------- |
| Prometheus Alertmanager | `fingerprint`                               | `send_resolved: true` no receiver             |
| Grafana Alerting        | `fingerprint` (com alternativas de regra)   | "Disable resolved message" **desativado**     |
| Datadog                 | `alert_cycle_key` (alternativa: `alert_id`) | `@webhook-<nome>` fora de `{"{{#is_alert}}"}` |
| New Relic               | `issueId`                                   | `Closed` marcado em "Notify when"             |
| Zabbix                  | `triggerId`                                 | Action disparando em PROBLEM **e** RECOVERY   |
| AWS CloudWatch          | `alarmArn`                                  | `OKActions` apontando para o topic SNS        |
| Webhook genérico        | `externalId`                                | Não há auto-resolução                         |

<Warning>
  Em todas as ferramentas, o item da direita é o passo mais esquecido da configuração. Sem ele, os acionamentos abrem normalmente mas **nunca fecham sozinhos** — e a falha é silenciosa.
</Warning>

<Columns cols={2}>
  <Card title="Acionamento não resolveu sozinho" icon="life-buoy" href="/pt-br/solucao-de-problemas/sem-auto-resolucao" horizontal />

  <Card title="Referência de correlação" icon="list" href="/pt-br/referencia/correlacao-e-auto-resolucao" horizontal />
</Columns>