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>
2.4 KiB
| title | menuTitle | description | weight | keywords | canonical | aliases | refs | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Notifications | Notifications | Configure notifications and ChatOps integrations for Grafana OnCall. | 200 |
|
https://grafana.com/docs/oncall/latest/manage/notify/ |
|
|
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:
-
Navigate to the Users tab of Grafana OnCall and search for or select a user.
-
Click Edit to the right of a user to open the User Info window.
-
Verify that there is a valid and verified phone number, along with ChatOps accounts in order to receive notifications via those methods.
-
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.