DOCS

Set up Grafana alert ingestion

Send Grafana alert-rule notifications into HowlOps as incidents using a webhook contact point.

What you will configure

  • Create a Grafana integration in HowlOps and copy its webhook URL
  • Add a webhook contact point in Grafana
  • Route an alert rule to it and verify the incident in HowlOps

Time: ~5 minutes · Requires: Grafana 9+ (unified alerting). Works on any plan, including Free On-call — external alert ingestion is free.

Step 1 — Create the Grafana integration in HowlOps

  1. In HowlOps go to Settings → Integrations.
  2. Add an integration of type Grafana.
  3. Copy the webhook URL — it looks like:
https://api.howlops.com/api/v1/webhooks/incoming/<your-token>

Step 2 — Add a webhook contact point in Grafana

In Grafana: Alerting → Contact points → Add contact point.

  • Integration: Webhook
  • URL: the HowlOps webhook URL from Step 1
  • HTTP Method: POST

Save. (Optional: use Alerting → Notification policies to route specific alert rules to this contact point, or set the contact point directly on a rule.)

Step 3 — Point an alert rule at HowlOps

Open (or create) an alert rule and, under its notification settings, select the howlops contact point. Anything that rule fires will now POST to HowlOps.

Step 4 — Test it

The fastest check: create a throwaway always-firing rule (expression 1, condition > 0) routed to the contact point. Within one evaluation interval HowlOps shows a new incident:

[GRAFANA] [FIRING:1] <your rule name>

HowlOps reads the alert's severity label, so add severity: critical (or warning / info) on your rule's labels to control the incident severity. When the rule recovers, HowlOps auto-resolves the incident.

Severity & dedup

Grafana labelHowlOps severity
severity: criticalcritical
severity: warningwarning
(none)info

HowlOps dedups and auto-resolves using Grafana's per-alert fingerprint, so re-fires update the same incident instead of creating duplicates.

Troubleshooting

  • No incident — confirm the contact point URL has no typo and the rule actually routes to it (check Grafana's Notification policies). Use Grafana's contact-point Test button to send a sample payload.
  • Everything shows as warning — add a severity label to your alert rule; without it HowlOps defaults to info/warning.

See also

Was this page helpful?