Grafana OnCall Provider

​

Inputs

• title (required): The title of the alert
• message: The alert description
• alert_uid: Grouping ID which will be used on the OnCall side
• image_url: Image URL
• state: Either “alerting” or “resolved”
• link_to_upstream_details: Link assigned to the alert

​

Outputs

Grafana Oncall Provider does not currently support the query function.

​

Authentication Parameters

The Grafana Oncall Provider uses API token authentication. You need to provide the following authentication parameters to connect to Grafana OnCall:

• token (required): Your Grafana OnCall API Token.
• host (required): The URL of your Grafana OnCall host (e.g., https://oncall-prod-us-central-0.grafana.net/oncall/ or http://localhost:8000/) please note that in the Grafana Сloud, oncall’s API is under ../oncall/

​

Connecting with the Provider

To connect to Grafana OnCall, you need to create an API Token:

1. Log in to your Grafana account.
2. Go To “Alerts & IRM” -> OnCall.
3. Go to the Settings page.
4. Click the Create button and provide a name for your token.
5. Copy the token value and keep it secure.
6. Add the token value to the authentication section in the Grafana Oncall Provider configuration.

​

Notes

• This provider allows you to interact with Grafana OnCall to create alerts.
• Keep will create “Webhook” type integration called “Keep Integration” inside Grafana OnCall.

Payload example:

{
    "alert_uid": "08d6891a-835c-e661-39fa-96b6a9e26552",
    "title": "The whole system is down",
    "image_url": "https://upload.wikimedia.org/wikipedia/commons/e/ee/Grumpy_Cat_by_Gage_Skidmore.jpg",
    "state": "alerting",
    "link_to_upstream_details": "https://en.wikipedia.org/wiki/Downtime",
    "message": "Smth happened. Oh no!"
}

​

Useful Links

• Grafana OnCall Inbound Webhook Integration