This integration allows you to create Better Stack incidents from Grafana automatically.

Connecting Grafana and Better Stack

1. Go to Integrations.
2. Click the Importing data tab.
3. Scroll down and look for the Infrastructure monitoring section.
4. Find the Grafana card and click Add.
5. In the new window, name your Grafana integration (e.g., Backend service) and click Save changes. Keep this page open; you will need the webhook URL in a moment.

In Grafana

1. Open the Grafana instance you want to integrate with Better Stack.
2. Open Alerting → Contact points from the left-hand sidebar.
3. Click Create contact point and fill in the Name of your choice.
4. Select the Webhook integration.
5. In the URL field, input the Webhook URL found in the Grafana integration settings in Better Stack.
6. In the Webhook settings, select POST as the HTTP Method.
7. Click Save contact point to save contact point settings.

Assign the contact point to an alert rule

1. In Grafana, open Alerting → Alert rules and edit the rule you want to send to Better Stack.
2. In the alert rule settings, scroll down to the Configure notifications section.
3. Select the contact point you created in the previous step.
4. Click Save rule and exit to apply the changes.

That is it! 🎉 Now, when Grafana triggers an alert, it will be sent into Better Stack.

Set the incident name and cause

Fill in your Grafana alert rule's annotations to control how each incident reads:

• The summary annotation becomes the incident name, for example {{ $labels.service }} is down. Without it, Better Stack uses the folder and alert rule, for example Production → HighErrorRate.
• The description annotation becomes the incident cause, for example {{ $labels.alertname }} on {{ $labels.instance }}. Without it, the cause is the alert rule name.

Incident named after the alert rule instead of your summary?

Grafana sends alerts from the same rule in one notification, and Better Stack uses an annotation only when every alert in it has the same value, so checkout is down and payments is down firing together fall back to Production → HighErrorRate. To get one incident per summary, edit the alert rule and, in its Configure notifications section:

1. Open Muting, grouping and timings.
2. Turn on Override grouping.
3. Add the labels your summary uses, such as service, to Group by.

How the integration works

Grafana sends alert notifications to the Better Stack webhook URL as HTTP POST requests. Better Stack supports both:

• Grafana native alerts — legacy format with state, dashboardId, panelId, and ruleId fields.
• Grafana Alertmanager format — used in Grafana 8+ Unified Alerting, which sends Prometheus-compatible payloads with an alerts array.

When Grafana sends an alerting or no_data state, Better Stack creates a new incident. When the state changes to ok, the corresponding incident is automatically resolved.