Grafana OnCall

TraceStax integrates with Grafana OnCall via its inbound webhook integration. When a TraceStax alert fires, a payload is sent to your OnCall integration URL, which routes it through your escalation chains and notifies on-call engineers.

---

Setup

1. Create a Webhook integration in Grafana OnCall

   In Grafana, navigate to Alerts & IRM → OnCall → Integrations → New integration.

   Select Webhook from the integration list.

   Give it a name (e.g. “TraceStax”) and click Create.

2. Copy the Integration URL

   After creating the integration, Grafana OnCall shows an Integration URL that looks like:

   https://oncall.example.grafana.net/integrations/v1/webhook/abc123.../

   Copy it.

3. Add the URL in TraceStax

   In the TraceStax dashboard, go to your project → Integrations → Grafana OnCall → paste the Integration URL → Save.

Note

If you’re using Grafana Cloud (not self-hosted), your Integration URL will be under grafana.net. For self-hosted Grafana, the URL will match your Grafana instance domain.

---

What TraceStax sends to OnCall

When an alert fires, TraceStax sends a JSON payload to the Integration URL containing:

• title — the alert title
• severity — critical, warning, or info
• project — the TraceStax project name
• alert_id — unique identifier (used for grouping in OnCall)
• url — direct link to the alert in the TraceStax dashboard
• resolved — true when the alert clears (triggers auto-resolution in OnCall if configured)

You can customize how OnCall parses this payload in the integration’s Templates settings.

---

Configuring escalation in OnCall

After setting up the integration, go to Escalation chains in Grafana OnCall and link the integration to an appropriate chain. The chain determines who gets paged, in what order, and after how long.

---

Troubleshooting

Alerts not reaching OnCall

• Paste the Integration URL into a tool like curl and verify it returns 200.
• Confirm the OnCall plugin is installed and enabled in your Grafana instance.
• Check the integration’s Event log in OnCall for incoming payloads and any parsing errors.

Alerts not resolving automatically

• Enable the auto-resolution template in the integration’s Templates settings by mapping the resolved field to the resolution condition.