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 and copy:
    • The webhook URL
    • The Authorization header value (used for authenticating requests)

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 Header (optional): If provided in the portal, add as a custom header
  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​