Grafana Alerting

Visão geral

O Grafana envia os alertas para o aciona.me por um contact point do tipo webhook. Cada item de alerts[] do payload vira um alerta no aciona.me, e itens resolvidos fecham automaticamente o acionamento correspondente.


Tipo de fonte	`Grafana`
Mecanismo	Contact point webhook
Correlação	`fingerprint` do Grafana
Auto-resolução	✅

Pré-requisitos

Grafana com Grafana Alerting habilitado e permissão para criar contact points.
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 Grafana — por exemplo Grafana - produção.

2. Copie a URL e o token

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

O token é exibido uma única vez. Copie agora.

3. Configure o contact point no Grafana

Pela interface
Por provisioning (YAML)

Alerting → Contact points → Add contact point

Nome: aciona-me. Integração: Webhook.

URL

https://ingress.aciona.me/webhooks/<idDaFonte>

HTTP Method

POST

Header de autenticação

Adicione o header X-Aciona-Token com o token da fonte. Em versões que expõem o campo como Authorization Header, use o nome X-Aciona-Token e o token como valor.

Disable resolved message

Deixe desativado. Este é o passo crítico da integração.

Salve e use o contact point

Aponte a notification policy (ou as regras de alerta) para o contact point aciona-me.

contact-points.yaml

contactPoints:
  - orgId: 1
    name: aciona-me
    receivers:
      - uid: aciona-me-webhook
        type: webhook
        settings:
          url: https://ingress.aciona.me/webhooks/<idDaFonte>
          httpMethod: POST
          disableResolveMessage: false
        secureSettings:
          authorizationHeaderValue: '<tokenDaFonte>'

disableResolveMessage: false é o equivalente ao send_resolved: true do Alertmanager.

4. Envie um alerta de teste

Use Test no contact point do Grafana, ou force uma regra de alerta a disparar.

5. Confirme o acionamento

Em Acionamentos, o alerta deve aparecer em segundos, com título vindo do alerta do Grafana e severidade traduzida a partir da label severity.

6. Configure a resolução automática

“Disable resolved message” precisa permanecer desativado, tanto no contact point quanto na notification policy. Com essa opção ativa, o Grafana não envia os itens resolved e o aciona.me não tem como fechar o acionamento — ele fica aberto indefinidamente.

Estados normalizados pelo aciona.me, item por item:

`alerts[].status`	Efeito no aciona.me
`firing`	Cria ou agrega acionamento
`alerting`	Cria ou agrega acionamento
`resolved`	Resolve automaticamente o acionamento correlacionado
`normal`	Resolve automaticamente o acionamento correlacionado
`paused`, `pending`, `no_data`	Ignorado

A correlação usa o fingerprint do Grafana, com alternativas baseadas no identificador da regra. Esse identificador precisa permanecer estável entre o disparo e a recuperação.

Roteamento para o serviço certo

Inclua uma label service nas suas regras de alerta com o nome exato do serviço no aciona.me:

labels:
  service: api-pagamentos
  severity: critical

Solução de problemas

O acionamento abre, mas nunca fecha sozinho

“Disable resolved message” está ativo em algum ponto — contact point ou notification policy. Desative nos dois.

Resposta 401 no Grafana

O header X-Aciona-Token está ausente ou com valor errado. Se o token foi rotacionado, atualize o contact point.

O acionamento cai no serviço errado

Adicione a label service na regra de alerta, com o nome exato do serviço no aciona.me. Sem ela, o roteamento usa outras pistas do payload.

Vários acionamentos para o mesmo problema

O fingerprint está mudando entre disparos — geralmente porque as labels da regra mudam. Estabilize as labels que compõem a identidade do alerta.

Fontes de alerta

Guias por ferramenta

Visão geral

Pré-requisitos

1. Crie a fonte de alerta no aciona.me

2. Copie a URL e o token

3. Configure o contact point no Grafana

4. Envie um alerta de teste

5. Confirme o acionamento

6. Configure a resolução automática

Roteamento para o serviço certo

Solução de problemas

Mais soluções

​Visão geral

​Pré-requisitos

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

​2. Copie a URL e o token

​3. Configure o contact point no Grafana

​4. Envie um alerta de teste

​5. Confirme o acionamento

​6. Configure a resolução automática

​Roteamento para o serviço certo

​Solução de problemas

Mais soluções

Visão geral

Pré-requisitos

1. Crie a fonte de alerta no aciona.me

2. Copie a URL e o token

3. Configure o contact point no Grafana

4. Envie um alerta de teste

5. Confirme o acionamento

6. Configure a resolução automática

Roteamento para o serviço certo

Solução de problemas