> ## 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.

# Fontes de alerta

> Como ferramentas externas enviam alertas para o aciona.me.

Toda ferramenta de monitoramento entra no aciona.me pelo mesmo caminho: uma **fonte de alerta** com URL e token próprios.

```bash theme={null}
POST https://ingress.aciona.me/webhooks/<idDaFonte>
X-Aciona-Token: <tokenDaFonte>
Content-Type: application/json
```

A fonte define **de quem é o alerta** (a organização) e **como o payload é lido** (o tipo da fonte). O aciona.me nunca aceita identificação de organização vinda do corpo da requisição.

## Escolha sua ferramenta

<Columns cols={2}>
  <Card title="Grafana Alerting" icon="chart-line" href="/pt-br/integracoes/grafana" horizontal>
    Contact point do tipo webhook.
  </Card>

  <Card title="Prometheus Alertmanager" icon="flame" href="/pt-br/integracoes/prometheus" horizontal>
    Receiver com `send_resolved`.
  </Card>

  <Card title="Datadog" icon="dog" href="/pt-br/integracoes/datadog" horizontal>
    Webhooks Integration com template de payload.
  </Card>

  <Card title="AWS CloudWatch" icon="cloud" href="/pt-br/integracoes/cloudwatch" horizontal>
    SNS + Lambda de transformação.
  </Card>

  <Card title="Zabbix" icon="activity" href="/pt-br/integracoes/zabbix" horizontal>
    Media type webhook customizada.
  </Card>

  <Card title="New Relic" icon="circle-gauge" href="/pt-br/integracoes/new-relic" horizontal>
    Workflows + Webhook destination.
  </Card>

  <Card title="Webhook genérico" icon="code" href="/pt-br/integracoes/webhook-generico" horizontal>
    Qualquer sistema que faça um POST JSON.
  </Card>
</Columns>

## O que o tipo da fonte muda

O tipo determina o tradutor usado para transformar o payload da ferramenta no formato interno do aciona.me. Isso afeta:

* De onde vêm **título**, **descrição** e **severidade**.
* Como é identificado o **serviço afetado**.
* Qual campo é usado para **correlacionar** disparo e recuperação.
* Se a fonte suporta **auto-resolução**.

<Warning>
  Usar o tipo errado é um erro comum. Um payload do Grafana enviado para uma fonte do tipo `Genérico` é aceito, mas os campos caem em valores padrão e a auto-resolução não funciona. Crie uma fonte com o tipo correto da ferramenta.
</Warning>

## Suporte a auto-resolução

| Tipo de fonte           | Auto-resolução |
| ----------------------- | -------------- |
| Grafana                 | ✅              |
| Prometheus Alertmanager | ✅              |
| Datadog                 | ✅              |
| New Relic               | ✅              |
| Zabbix                  | ✅              |
| AWS CloudWatch          | ✅              |
| Webhook genérico        | —              |

<Columns cols={2}>
  <Card title="URL e token" icon="key-round" href="/pt-br/fontes-de-alerta/webhook-e-token" horizontal />

  <Card title="Testar uma fonte" icon="terminal" href="/pt-br/fontes-de-alerta/testar-fonte" horizontal />
</Columns>