​
Authentication

This provider requires authentication.

  • token: Token (required: True, sensitive: False)
  • host: Grafana OnCall Host (required: True, sensitive: False)

​
In workflows

This provider can be used in workflows.

As “action” to make changes or update data, example:

actions:
    - name: Query grafana_oncall
      provider: grafana_oncall
      config: "{{ provider.my_provider_name }}"
      with:
        title: {value}  
        alert_uid: {value}  
        message: {value}  
        image_url: {value}  
        state: {value}  
        link_to_upstream_details: {value}

If you need workflow examples with this provider, please raise a GitHub issue.

​
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!"
}