Skip to main content

Grafana Alerting Integration

Overview​

Configure Grafana's unified alerting to send alert notifications to OpsWorker for automatic investigation. This is the Grafana Alerting integration (Grafana → OpsWorker). For enabling OpsWorker to query Grafana during investigations, see the separate Grafana MCP integration.

Requires Grafana 9 or later with unified alerting enabled.

Prerequisites​

  • Grafana 9+ with unified alerting enabled (or Grafana Cloud)
  • OpsWorker cluster set up with the Kubernetes Agent installed
  • Your OpsWorker webhook URL and credentials (available in the portal under Integrations → Grafana Alerting)

Setup​

1. Get Your Webhook URL​

  1. In the OpsWorker portal, go to Integrations
  2. Select your cluster
  3. Find Grafana Alerting, click Install, and copy:
    • The webhook URL
    • The credentials (used for authenticating requests)

All clusters POST to the same endpoint: https://alerts.ow-saas-prod-ext.opsworker.ai/alerts (dev: https://alerts-dev.opsworker.ai/alerts). The cluster token is not part of the URL. The cluster is identified by the credentials the portal generates. Grafana delivers alerts in an AlertManager-compatible format, which OpsWorker parses with the same path as Prometheus AlertManager.

2. Create a Contact Point in Grafana​

  1. In Grafana, navigate to Alerting → Contact Points
  2. Click New Contact Point
  3. Configure:
    • Name: OpsWorker
    • Type: Webhook
    • URL: Your OpsWorker webhook URL
    • HTTP Method: POST
    • Authorization: scheme Bearer, with the credentials from the portal. This is required, not optional. Without it the webhook is rejected.
  4. Click Test to send a test notification
  5. Click Save

3. Configure Notification Policies​

  1. Go to Alerting → Notification Policies
  2. Either:
    • Add OpsWorker to the default policy: all Grafana alerts go to OpsWorker
    • Create a specific policy: route certain alerts (by label, folder, or severity) to OpsWorker
  3. Set the contact point to OpsWorker
  4. Save the policy

4. Verify​

Trigger a Grafana alert rule or wait for a real one. Check the OpsWorker portal under Alerts to confirm signals are arriving.

Grafana Cloud​

The same setup works with Grafana Cloud: create a webhook contact point using your OpsWorker webhook URL. No additional configuration is needed.

What About Grafana MCP?​

Grafana Alerting and Grafana MCP are separate integrations:

IntegrationDirectionPurpose
Grafana Alerting (this page)Grafana → OpsWorkerSends alerts for investigation
Grafana MCPOpsWorker → GrafanaAI queries Grafana metrics, logs, dashboards

You can use both together for the richest experience: alerts trigger investigations, and the AI uses Grafana MCP to query metrics and logs for deeper context during those investigations.

See the Grafana MCP setup for configuration.

Next Steps​