Explore documentation
Grafana & Better Stack integration
This integration allows you to create Uptime incidents from Grafana automatically.
Connecting Grafana and Uptime
- Go to Integrations.
- Click the Importing data tab.
- Scroll down and look for the Infrastructure monitoring section.
- Find the Grafana card and click Add.
- 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
- Open the Grafana instance you want to integrate with Better Stack.
- Open Alerting โ Contact points from the left-hand sidebar.
- Click Create contact point and fill in the Name of your choice.
- Select the Webhook integration.
- In the URL field, input the Webhook URL found in the Uptime Grafana integration settings.
- In the Webhook settings, select POST as the HTTP Method.
- Click Save contact point to save contact point settings.
Assign the contact point to an alert rule
- In Grafana, open Alerting โ Alert rules and edit the rule you want to send to Better Stack.
- In the alert rule settings, scroll down to the Notifications section.
- Select the contact point you created in the previous step.
- Click Save rule and exit to apply the changes.
That is it! ๐ Now, when Grafana triggers an alert, it will be sent into Uptime.
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, andruleIdfields. - Grafana Alertmanager format โ used in Grafana 8+ Unified Alerting, which sends Prometheus-compatible payloads with an
alertsarray.
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.