oncall-engine/docs/sources/manage/notify/_index.md
Jack Baldry 9ae442faa6
Replace docs/reference shortcode with ref URIs (#4301)
You can use `ref` URIs in admonitions (or any shortcodes) because they
are inline and not subject to the issues noted in the [`admonition`
shortcode](https://grafana.com/docs/writers-toolkit/write/shortcodes/#code-shortcode:~:text=to%20core%20understanding.-,WARNING,For%20more%20information%2C%20refer%20to%20Markdown%20Reference%20Links%20in%20Shortcodes.,-Examples).

The `ref` URIs perform the same pattern matching as `docs/reference` but
don't require the use of reference-style links and the destinations are
ordinary (full) URLs that can include version substitution. Unlike
`docs/reference`, the implementation doesn't use `relref` so you don't
have to be careful with omitting trailing slashes and the links will
follow redirects.

Documentation:
https://grafana.com/docs/writers-toolkit/write/links/#link-from-source-content-thats-used-in-multiple-projects

To check the links, refer to the deploy preview in
https://github.com/grafana/website/pull/19630.

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

---------

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
2024-07-29 14:13:24 +00:00

2.4 KiB

title menuTitle description weight keywords canonical aliases refs
Notifications Notifications Configure notifications and ChatOps integrations for Grafana OnCall. 200
OnCall
Notifications
ChatOps
Slack
MS Teams
Telegram
Phone
https://grafana.com/docs/oncall/latest/manage/notify/
/docs/grafana-cloud/alerting-and-irm/oncall/manage/notify/
/docs/grafana-cloud/alerting-and-irm/oncall/notify/
../notify/
outgoing-webhooks
pattern destination
/docs/oncall/ /docs/oncall/<ONCALL_VERSION>/configure/integrations/outgoing-webhooks/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/oncall/configure/integrations/outgoing-webhooks/

Notifications

Grafana OnCall directly supports the export of alert notifications to some popular messaging applications like Slack and Telegram. You can use Outgoing webhooks for applications that aren't directly supported.

To configure supported messaging apps, refer to the following topics:

{{< section >}}

Configure user notification policies

Notification policies are a configurable set of notification steps that determine how you're notified of alert in OnCall. Users with the Admin or Editor role are able to receive notifications. Users can verify phone numbers and email addresses in the Users tab of Grafana OnCall.

  • Default Notifications dictate how a user is notified for most escalation thresholds.

  • Important Notifications are labeled in escalation chains. If an escalation event is marked as an important notification, it will bypass Default Notification settings and notify the user by the method specified.

NOTE: You cannot add users or manage permissions in Grafana OnCall. User settings are found on the organizational level of your Grafana instance in Configuration > Users.

To configure a users notification policy:

  1. Navigate to the Users tab of Grafana OnCall and search for or select a user.

  2. Click Edit to the right of a user to open the User Info window.

  3. Verify that there is a valid and verified phone number, along with ChatOps accounts in order to receive notifications via those methods.

  4. Click Add notification step and use the dropdowns to specify the notification method and frequency. Notification steps will be followed in the order they are listed.