Caution
As of 2025-03-11, Grafana OnCall OSS has entered maintenance mode, and will be archived on 2026-03-24. No further feature development will occur; however, we will still provide fixes for critical bugs and for valid CVEs with a CVSS score of 7.0 or higher. For more information, refer to our blog post.
Configure push notifications for Grafana OnCall OSS
Grafana OnCall OSS allows you to set up a personal notification webhook, which provides flexibility and control over how you receive push notifications.
To enable push notifications as a notification method, you can configure a webhook to send notifications via a third-party push notification service, such as Pushover, ntfy, or Gotify.
Configure webhooks for push notifications
The personal notification webhook feature allows you to configure customized notifications based on your preferred push notification provider. The configuration process is similar across push notification services like Pushover, Gotify, or ntfy.
Choose a push notification provider
- Pushover – Third-party push notification service.
- ntfy – Open-source push notification service.
- Gotify – Self-hosted push notification server.
Create an outgoing webhook in OnCall OSS
- Navigate to Outgoing Webhooks in Grafana OnCall OSS.
- Click + Outgoing Webhook, then select Advanced.
- Set the Trigger Type to Personal Notification.
- Configure the webhook:
- URL: Enter the URL for your chosen push notification service.
- Method: POST
- Headers: (Optional, based on service requirements.)
- Body: Ensure the message format aligns with the selected service.
- Click Save.
Tip
Define your webhook using templates where needed so that each user can personalize it by providing their own values via the context in their profile. Templating can be applied to different parts of the webhook configuration, such as the URL, headers, or body payload. Depending on the service you are integrating with, you may need to template a specific field (e.g., setting a payload field referencing the user ID or a header with a specific key). See examples below.
Assign the webhook as a personal notification channel
- Navigate to your User Profile.
- Under Notification Channels, click Connect for Webhook.
- On the Webhook Connection tab, select the webhook created in the previous step.
- If you used a templated webhook URL, define your JSON key/value in the Context section.
- Add the webhook as a notification step in your notification rules.
Once configured, notifications from OnCall OSS will be sent through the webhook to your chosen push notification provider. Ensure all necessary configurations are completed with your provider.
Example: Configure Pushover for OnCall OSS
Before you begin, ensure you have:
- A Pushover account (sign up at pushover.net).
- The Pushover mobile app installed and configured (iOS/Android). Ensure notifications are enabled and can override Do Not Disturb (DnD) mode if needed.
- A Pushover API token (generated from the Pushover website).
- Administrator access to your Grafana OnCall OSS instance.
Create a Pushover application
- Log in to Pushover.
- Navigate to Apps & Plugins > Create an Application.
- Enter an Application Name (e.g., Grafana OnCall Alerts).
- Copy and save the API token provided.
Configure an outgoing webhook in OnCall
- In Grafana OnCall OSS, go to Outgoing Webhooks.
- Click + Outgoing Webhook, then select Advanced.
- Set the Trigger Type to Personal Notification.
- Configure the webhook:
- URL:
https://api.pushover.net/1/messages.json
- Method: POST
- Headers:
- URL:
{
"Content-Type": "application/json"
}
- Body:
{
"token": "YOUR_PUSHOVER_APP_TOKEN",
"user": "USER_KEY",
"message": "New Alert: {{ alert_title }}",
"title": "Grafana OnCall Alert"
}
- Replace
YOUR_PUSHOVER_APP_TOKEN
with your Pushover API token. - Replace
USER_KEY
with your personal Pushover key. - Click Save & test to verify the configuration.
Assign the webhook as a personal notification channel
- Navigate to User Profile.
- Under Notification Channels, click Connect for Webhook.
- Select the webhook created in the previous step from the dropdown.
- (Optional) Provide additional context data for webhook templates in JSON key/value pair.
- Add the webhook as a notification step in your notification rules.
Example: Configure push notifications with ntfy
ntfy is an open-source push notification service that allows you to send notifications via REST API. A simple message can be sent using:
curl -d "Backup successful 😀" ntfy.sh/mytopic
For more customization options, refer to the ntfy documentation.
Set up an outgoing webhook for ntfy
Tip
Use a templated webhook URL to configure your webhook to be reused by multiple users. This allows users to set that value according to their personal information (i.e. the ntfy topic in our example).
- In Grafana OnCall OSS, click + Outgoing Webhook, then select Advanced.
- Set the Trigger Type to Personal Notification.
- Configure the webhook:
- URL:
https://ntfy.sh/{{ user_defined_topic }}
- Method: POST
- Headers:
- URL:
{
"Title": "Grafana OnCall Alert",
"Priority": "5"
}
- Body:
{
"message": "New Alert: {{ alert_title }}"
}
- Click Save.
Once configured, each user can set up a new notification channel in their profile and provide a ntfy_topic
key with their desired topic name as the value.
Assign the webhook as a personal notification channel
- Navigate to User Profile.
- Under Notification Channels, click Connect for Webhook.
- Select the webhook created in the previous step.
- In the Context section, define your
ntfy_topic
as a JSON key/value pair. - Add the webhook as a notification step in your notification rules.