Skip to main content
Back to integrations

Grafana Alerting

Receive Grafana alerts; the agent can query dashboards, data sources and alert rules

Overview

Grafana Alerting sends notifications to Akmatori through a webhook contact point. Each alert in a notification becomes a separate alert in Akmatori. The Grafana connector can also hold Grafana API access, so the agent can query dashboards, data sources and alert rules during an investigation.

Setup steps

1

Create an alert source in Akmatori

Open Connectors → Discover → Grafana (or your existing Grafana connector), go to the Alerts tab and choose New Source. Copy the webhook URL.

2

Add a contact point

In Grafana, go to Alerting → Contact points → Add contact point, select "Webhook" as the integration and paste the Akmatori webhook URL. If you set a webhook secret in Akmatori, send it as a bearer token (Authorization header scheme Bearer) or in the X-Grafana-Secret header.

3

Configure a notification policy

Create or update a notification policy to route alerts to the Akmatori contact point.

Example payload

An example of the payload that Akmatori accepts from Grafana Alerting:

json
{
  "status": "firing",
  "alerts": [
    {
      "status": "firing",
      "labels": {
        "alertname": "HighRequestLatency",
        "grafana_folder": "Production",
        "severity": "warning",
        "instance": "api-01:8080"
      },
      "annotations": {
        "summary": "Request latency is above threshold"
      },
      "fingerprint": "f3a1c2b4d5e6a7b8"
    }
  ]
}
Akmatori reads the alertname, severity, instance and job labels and the summary, description and runbook_url annotations. Add a severity label to your alert rules: without it, the alert gets severity warning.