From 086def3f57a107e102e57f310c5ec5c6e9046b37 Mon Sep 17 00:00:00 2001 From: antonio <45235678+tonypowa@users.noreply.github.com> Date: Thu, 16 May 2024 12:19:44 +0200 Subject: [PATCH] alerting: contact points - links (#87955) * alerting: contact points - links * fundamentals: alerting instructions update * updated steps * prettier --- .../manage-contact-points/_index.md | 4 +-- .../tutorials/grafana-fundamentals/index.md | 36 ++++++++++++------- 2 files changed, 26 insertions(+), 14 deletions(-) diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/_index.md b/docs/sources/alerting/configure-notifications/manage-contact-points/_index.md index 344c6db270b..1243b149f7b 100644 --- a/docs/sources/alerting/configure-notifications/manage-contact-points/_index.md +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/_index.md @@ -110,7 +110,7 @@ Once configured, you can use integrations as part of your contact points to rece | ------------------------ | ------------------------- | | DingDing | `dingding` | | Discord | `discord` | -| Email[email] | `email` | +| [Email][email] | `email` | | Google Chat | `googlechat` | | [Grafana Oncall][oncall] | `oncall` | | Hipchat | `hipchat` | @@ -124,7 +124,7 @@ Once configured, you can use integrations as part of your contact points to rece | Sensu | `sensu` | | Sensu Go | `sensugo` | | [Slack][slack] | `slack` | -| Telegram[telegram] | `telegram` | +| [Telegram][telegram] | `telegram` | | Threema | `threema` | | VictorOps | `victorops` | | [Webhook][webhook] | `webhook` | diff --git a/docs/sources/tutorials/grafana-fundamentals/index.md b/docs/sources/tutorials/grafana-fundamentals/index.md index c822b3e172c..1ce921f3d5b 100644 --- a/docs/sources/tutorials/grafana-fundamentals/index.md +++ b/docs/sources/tutorials/grafana-fundamentals/index.md @@ -283,11 +283,11 @@ The most basic alert consists of two parts: Some popular channels include: - - Email - - [Webhooks](#create-a-contact-point-for-grafana-managed-alerts) - - [Telegram](https://grafana.com/blog/2023/12/28/how-to-integrate-grafana-alerting-and-telegram/) - - [Slack](https://grafana.com/docs/grafana/latest/alerting/alerting-rules/manage-contact-points/integrations/configure-slack/) - - PagerDuty + - [Email][email] + - [Webhooks][webhook] + - [Telegram][telegram] + - [Slack][slack] + - [PagerDuty][pagerduty] 1. An _Alert rule_ - An Alert rule defines one or more _conditions_ that Grafana regularly evaluates. When these evaluations meet the rule's criteria, the alert is triggered. @@ -339,15 +339,8 @@ Now that Grafana knows how to notify us, it's time to set up an alert rule: 1. Choose an Evaluation interval (how often the alert will be evaluated). For example, every `10s` (10 seconds). 1. Set the pending period. This is the time that a condition has to be met until the alert enters in Firing state and a notification is sent. Enter `0s`. For the purposes of this tutorial, the evaluation interval is intentionally short. This makes it easier to test. This setting makes Grafana wait until an alert has fired for a given time before Grafana sends the notification. 1. In **Section 4**, choose **RequestBin** as the **Contact point**. -1. In **Section 5**, you can optionally add some sample text to your summary message. [Read more about message templating here](/docs/grafana/latest/alerting/unified-alerting/message-templating/). 1. Click **Save rule and exit** at the top of the page. 1. In Grafana's sidebar, navigate to **Notification policies**. -1. Under **Default policy**, select **...** › **Edit** and change the **Default contact point** from **grafana-default-email** to **RequestBin**. -1. Expand the **Timing options** dropdown and under **Group wait** and **Group interval** update the value to `30s` for testing purposes. Group wait is the time Grafana waits before sending the first notification for a new group of alerts. In contrast, group interval is the time Grafana waits before sending notifications about changes to the group. -1. Click **Update default policy**. - - As a system grows, admins can use the **Notification policies** setting to organize and match alert rules to - specific contact points. ### Trigger a Grafana Managed Alert @@ -404,3 +397,22 @@ Check out the links below to continue your learning journey with Grafana's LGTM - [Alerting Overview](/docs/grafana/latest/alerting/) - [Alert rules](/docs/grafana/latest/alerting/create-alerts/) - [Contact points](/docs/grafana/latest/alerting/fundamentals/contact-points/) + +{{% docs/reference %}} + +[email]: "/docs/grafana/ -> /docs/grafana//alerting/configure-notifications/manage-contact-points/integrations/configure-email" +[email]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/configure-email" + +[pagerduty]: "/docs/grafana/ -> /docs/grafana//alerting/configure-notifications/manage-contact-points/integrations/pager-duty" +[pagerduty]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/pager-duty" + +[telegram]: "/docs/grafana/ -> /docs/grafana//alerting/configure-notifications/manage-contact-points/integrations/configure-telegram" +[telegram]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/configure-telegram" + +[slack]: "/docs/grafana/ -> /docs/grafana//alerting/configure-notifications/manage-contact-points/integrations/configure-slack" +[slack]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/configure-slack" + +[webhook]: "/docs/grafana/ -> /docs/grafana//alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier" +[webhook]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier" + +{{% /docs/reference %}}