Grafana & Better Stack integration

This integration allows you to create Uptime incidents from Grafana automatically.

Connecting Grafana and Uptime

1. In the Uptime dashboard

  1. Log into your Uptime dashboard and on the left panel click Integrations.
  2. Click the Importing data tab.
  3. Scroll down and look for the Infrastructure monitoring section.
  4. Find the Grafana card and click the Add button.
  5. In the new window, name your Grafana integration (e.g.: Backend service) and click Save changes. Don't close the Uptime dashboard just yet, you'll need the webhook URL in a moment.

2. In the Grafana dashboard

  1. Open the Grafana instance you want to integrate with Better Stack.
  2. Open AlertingContact 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 Uptime Grafana integration settings.
  6. In the Webhook settings, select POST as the HTTP Method.
  7. Click Save contact point to save contact point settings.

3. Assign the contact point to an alert rule

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

That's 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, 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.