Prometheus Alertmanager

Visão geral

O Alertmanager envia os alertas por um receiver do tipo webhook. Cada item de alerts[] vira um alerta no aciona.me, e o estado nativo resolved do Alertmanager resolve o acionamento automaticamente.


Tipo de fonte	`Prometheus`
Mecanismo	`webhook_configs` no receiver
Correlação	`fingerprint` do Alertmanager
Auto-resolução	✅

Pré-requisitos

Alertmanager acessível e permissão para editar sua configuração.
Um serviço criado no aciona.me e vinculado a um time com escala ativa.

1. Crie a fonte de alerta no aciona.me

Em Fontes de alerta, crie uma fonte do tipo Prometheus.

2. Copie a URL e o token

POST https://ingress.aciona.me/webhooks/<idDaFonte>
X-Aciona-Token: <tokenDaFonte>

3. Configure o receiver no Alertmanager

alertmanager.yml

receivers:
  - name: aciona-me
    webhook_configs:
      - url: https://ingress.aciona.me/webhooks/<idDaFonte>
        send_resolved: true
        http_config:
          http_headers:
            X-Aciona-Token:
              value: '<tokenDaFonte>'

route:
  receiver: aciona-me
  group_by: ['alertname', 'service']
  group_wait: 10s
  group_interval: 5m
  repeat_interval: 4h

send_resolved: true é obrigatório para a auto-resolução. Sem ele, o Alertmanager só envia itens firing e os acionamentos ficam abertos até alguém resolver manualmente.

Recarregue a configuração do Alertmanager depois de salvar.

4. Envie um alerta de teste

curl -X POST http://<seu-alertmanager>:9093/api/v2/alerts \
  -H "Content-Type: application/json" \
  -d '[{
    "labels": {
      "alertname": "TesteAcionaMe",
      "severity": "critical",
      "service": "api-pagamentos"
    },
    "annotations": { "description": "Alerta de teste do aciona.me" }
  }]'

5. Confirme o acionamento

O acionamento deve aparecer em Acionamentos com o título vindo da label alertname.

6. Como os campos são traduzidos

Campo no aciona.me	Origem no Alertmanager
Estado	`alerts[].status` (`firing` / `resolved`)
Correlação	`alerts[].fingerprint`
Severidade	label `severity` (padrão: `warning`)
Título	label `alertname`
Descrição	annotation `description`, depois `summary`
Serviço	labels `service` → `job` → `instance`
Link externo	`alerts[].generatorURL`

O aciona.me usa o status de cada item de alerts[], nunca o status do grupo. Isso evita que um grupo parcialmente resolvido feche acionamentos que ainda estão disparando.

Compatibilidade

O mesmo formato de payload é usado pelo Thanos Ruler, VictoriaMetrics Alertmanager e Grafana Mimir — a integração tende a funcionar com essas ferramentas sem ajustes.

Solução de problemas

O acionamento abre, mas nunca fecha sozinho

send_resolved: true está ausente no receiver. Adicione e recarregue a configuração.

Resposta 401

O header X-Aciona-Token não está chegando. Verifique a indentação do bloco http_headers e a versão do Alertmanager — versões antigas usam sintaxe diferente para headers customizados.

Severidade sempre warning

As regras não têm a label severity, ou usam valores não reconhecidos. Veja Severidades.

Serviço errado

Adicione a label service nas regras, com o nome exato do serviço no aciona.me.

​Visão geral

​Pré-requisitos

​1. Crie a fonte de alerta no aciona.me

​2. Copie a URL e o token

​3. Configure o receiver no Alertmanager

​4. Envie um alerta de teste

​5. Confirme o acionamento

​6. Como os campos são traduzidos

​Compatibilidade

​Solução de problemas

Visão geral

Pré-requisitos

1. Crie a fonte de alerta no aciona.me

2. Copie a URL e o token

3. Configure o receiver no Alertmanager

4. Envie um alerta de teste

5. Confirme o acionamento

6. Como os campos são traduzidos

Compatibilidade

Solução de problemas