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

# Criar uma fonte de alerta

> Cada ferramenta de monitoramento recebe sua própria URL de ingestão e seu próprio token.

A fonte de alerta é o ponto de entrada de uma ferramenta externa no aciona.me. Ela define a organização dona do alerta e como o payload será interpretado.

## Criando

<Steps>
  <Step title="Abra Fontes de alerta e crie uma nova">
    Owners e admins podem criar fontes.
  </Step>

  <Step title="Escolha o tipo">
    O tipo determina o tradutor de payload usado:

    `Genérico` · `Grafana` · `Prometheus` · `Zabbix` · `Datadog` · `New Relic` · `CloudWatch`
  </Step>

  <Step title="Dê um nome claro">
    Use algo que identifique a origem real: `Grafana - produção`, `Datadog - checkout`, `CloudWatch - conta 1111`.
  </Step>

  <Step title="Copie a URL e o token">
    Ao salvar, o aciona.me exibe:

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

    <Warning>
      O token aparece **uma única vez**. Se você perdê-lo, será preciso rotacioná-lo — o que exige reconfigurar a ferramenta externa.
    </Warning>
  </Step>
</Steps>

## Boas práticas

<AccordionGroup>
  <Accordion title="Uma fonte por ferramenta e ambiente" icon="split">
    Separe `Grafana - produção` de `Grafana - staging`. Isso permite desativar uma origem barulhenta sem derrubar as outras e mantém a auditoria limpa.
  </Accordion>

  <Accordion title="Guarde o token como segredo" icon="key-round">
    Trate-o como credencial: cofre de segredos, variável de ambiente, secret manager. Quem tem o token pode abrir acionamentos na sua organização.
  </Accordion>

  <Accordion title="Desative em vez de apagar" icon="power">
    Uma fonte inativa passa a recusar alertas com `403`, sem perder o histórico já ingerido.
  </Accordion>
</AccordionGroup>

<Card title="Agora conecte sua ferramenta" icon="plug" href="/pt-br/fontes-de-alerta/visao-geral" horizontal>
  Guias passo a passo para Grafana, Prometheus, Datadog, CloudWatch, Zabbix, New Relic e webhook genérico.
</Card>