Skip to main content
Back to Integrations
🔥

Alertmanager

Prometheus Alertmanager integration for cloud-native monitoring

Overview

Alertmanager handles alerts sent by client applications such as the Prometheus server. It takes care of deduplicating, grouping, and routing them to the correct receiver integration.

Configuration Steps

1

Create Alert Source in Akmatori

Go to Settings → Alert Sources and create a new Alertmanager source. Copy the generated webhook URL.

2

Configure Alertmanager

Add a webhook receiver to your alertmanager.yml configuration. Akmatori accepts either the native X-Alertmanager-Secret header or standard bearer auth when you set a webhook secret:

yaml
receivers:
  - name: 'akmatori'
    webhook_configs:
      - url: 'https://your-akmatori-url/webhook/alert/<uuid>'
        send_resolved: true
        http_config:
          authorization:
            type: Bearer
            credentials: '<your-webhook-secret>'
3

Update Routes

Route alerts to the Akmatori receiver:

yaml
route:
  receiver: 'akmatori'
  group_by: ['alertname', 'severity']
  group_wait: 10s
  group_interval: 10s
  repeat_interval: 1h

Webhook Payload

Here's an example of the payload Akmatori expects from Alertmanager:

json
{
  "receiver": "akmatori",
  "status": "firing",
  "alerts": [
    {
      "status": "firing",
      "labels": {
        "alertname": "HighCPUUsage",
        "severity": "critical",
        "instance": "server-01:9090"
      },
      "annotations": {
        "summary": "High CPU usage detected",
        "description": "CPU usage is above 90%"
      }
    }
  ]
}
Enable send_resolved to automatically close incidents when alerts are resolved.