Get your Obsy webhook URL
Your per-org Grafana webhook URL is:{orgId} in Settings → Organization or from the Create Monitors modal in OTel Collector.
Add Obsy as a contact point
- In Grafana, go to Alerting → Contact points.
- Click Add contact point.
- Set Name to
Obsy. - Under Integration, choose Webhook.
- Set URL to your Obsy webhook URL.
- Leave method as POST and content type as
application/json. - Click Test — Grafana sends a test payload. Check Alerts in Obsy to confirm it arrived.
- Click Save contact point.
Add Obsy to a notification policy
- Go to Alerting → Notification policies.
- Either edit the Default policy or add a new nested policy.
- Set the Contact point to
Obsy. - Optionally add label matchers to route only specific alerts.
Alert payload format
Obsy accepts the standard Grafana AlertManager webhook format. Each POST can contain multiple alerts in a single group. Obsy creates one Alert entity per item in thealerts array.
Key fields mapped:
Using labels for routing
Obsy infers service and environment from Grafana labels. Set these on your alert rules for best results:Troubleshooting
Test payload arrives but real alerts don't
Test payload arrives but real alerts don't
Check your notification policy — the policy must match the labels on your alert rules. Use Grafana’s Contact point testing section to send a real alert through.
Service name shows as empty
Service name shows as empty
Add a
service or app label to your Grafana alert rule. Without this label, Obsy stores the alert without a service association.