From 36102bbaefddd697cfa5818f1b12e308efe0f1f0 Mon Sep 17 00:00:00 2001 From: "grafana-delivery-bot[bot]" <132647405+grafana-delivery-bot[bot]@users.noreply.github.com> Date: Tue, 25 Jun 2024 18:08:05 +0200 Subject: [PATCH] [v11.1.x] alerting: teams contact point + updates (#89702) alerting: teams contact point + updates (#89695) * alerting: teams contact point + updates * typo * all pretty no pity * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-email.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-email.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-slack.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-slack.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-slack.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/pager-duty.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * formatting * formatting --------- Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> (cherry picked from commit 891cc0512fc3a43dcd9a3b7f1a44f8508baa2cdb) Co-authored-by: antonio <45235678+tonypowa@users.noreply.github.com> --- .../integrations/configure-email.md | 16 ++--- .../integrations/configure-slack.md | 15 ++--- .../integrations/configure-teams.md | 59 +++++++++++++++++++ .../integrations/configure-telegram.md | 16 ++--- .../integrations/pager-duty.md | 14 +++-- .../integrations/webhook-notifier.md | 16 ++--- 6 files changed, 99 insertions(+), 37 deletions(-) create mode 100644 docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-teams.md diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-email.md b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-email.md index a490f375241..f9700eac7e6 100644 --- a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-email.md +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-email.md @@ -80,13 +80,13 @@ To set up email integration, complete the following steps. ## Next steps -To add the contact point and integration you created to your default notification policy, complete the following steps. +The email contact point is ready to receive alert notifications. -1. Navigate to **Alerts & IRM** -> **Alerting** -> **Notification policies**. -1. In the **Default policy**, click the ellipsis icon (…) and then **Edit**. -1. Change the default policy to the contact point you created. -1. Click **Update default policy**. +To add this contact point to your alert, complete the following steps. -{{% admonition type="note" %}} -If you have more than one contact point, add a new child notification policy rather than edit the default one, so you can route specific alerts to one or multiple email addresses. -{{% /admonition %}} +1. In Grafana, navigate to **Alerting** > **Alert rules**. +1. Edit or create a new alert rule. +1. Scroll down to the **Configure labels and notifications** section. +1. Under Notifications click **Select contact point**. +1. From the drop-down menu, select the previously created contact point. +1. **Click Save rule and exit**. diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-slack.md b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-slack.md index e23b5947e1c..c29f0c34945 100644 --- a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-slack.md +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-slack.md @@ -82,12 +82,13 @@ To create your Slack integration in Grafana Alerting, complete the following ste ## Next steps -To add the contact point and integration you created to your default notification policy, complete the following steps. +The Slack contact point is ready to receive alert notifications. -1. Navigate to **Alerts & IRM** -> **Alerting** -> **Notification policies**. -1. In the **Default policy**, click the ellipsis icon (…) and then **Edit**. -1. Change the default policy to the contact point you created. -1. Click **Update default policy**. +To add this contact point to your alert, complete the following steps. -**Note:** -If you have more than one contact point, add a new notification policy rather than edit the default one, so you can route specific alerts to Slack. For more information, refer to [Notification policies](ref:nested-policy). +1. In Grafana, navigate to **Alerting** > **Alert rules**. +1. Edit or create a new alert rule. +1. Scroll down to the **Configure labels and notifications** section. +1. Under Notifications click **Select contact point**. +1. From the drop-down menu, select the previously created contact point. +1. **Click Save rule and exit**. diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-teams.md b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-teams.md new file mode 100644 index 00000000000..54272489097 --- /dev/null +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-teams.md @@ -0,0 +1,59 @@ +--- +canonical: https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/configure-teams/ +description: Configure Microsoft Teams integration to receive notifications when your alerts are firing +keywords: + - grafana + - alerting + - Microsoft Teams + - integration +labels: + products: + - cloud + - enterprise + - oss +menuTitle: Microsoft Teams +title: Configure Microsoft Teams for Alerting +weight: 300 +--- + +# Configure Microsoft Teams for Alerting + +Use the Grafana Alerting - Microsoft Teams integration to receive notifications in your team’s channel when your alerts are firing. + +## Before you begin + +To set up Microsoft Teams for integration with Grafana Alerting, you need to create an incoming Webhook. This allows Grafana to send alert notifications to Microsoft Teams channels. + +### Create an incoming Webhook in Microsoft Teams + +1. To add an incoming Webhook to a Teams channel, follow the steps in the [Create an Incoming Webhook guide](https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook?tabs=newteams%2Cdotnet#create-an-incoming-webhook). + + Note: The steps to create incoming Webhooks may vary depending on the version of Microsoft Teams you are using. You can switch between the "New Teams" and "Classic Teams" tabs to view the relevant instructions for your version. + +1. Copy the Webhook URL. + +## Procedure + +To create your MS Teams integration in Grafana Alerting, complete the following steps. + +1. Navigate to **Alerts & IRM** -> **Alerting** -> **Contact points**. +1. Click **+ Add contact point**. +1. Enter a contact point name. +1. From the Integration list, select **Microsoft Teams**. +1. In the **URL** field, copy in your Webhook URL. +1. Click **Test** to check that your integration works. + A test alert notification should be sent to the MS Team channel. +1. Click **Save** contact point. + +## Next steps + +The Microsoft Teams contact point is ready to receive alert notifications. + +To add this contact point to your alert, complete the following steps. + +1. In Grafana, navigate to **Alerting** > **Alert rules**. +1. Edit or create a new alert rule. +1. Scroll down to the **Configure labels and notifications** section. +1. Under Notifications click **Select contact point**. +1. From the drop-down menu, select the previously created contact point. +1. **Click Save rule and exit**. diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-telegram.md b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-telegram.md index e0c237211de..de616f7fd96 100644 --- a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-telegram.md +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-telegram.md @@ -83,13 +83,13 @@ To create your Telegram integration in Grafana Alerting, complete the following ## Next steps -To add the contact point and integration you created to your default notification policy, complete the following steps. +The Telegram contact point is ready to receive alert notifications. -1. Navigate to **Alerts & IRM** -> **Alerting** -> **Notification policies**. -1. In the **Default policy**, click the ellipsis icon (…) and then **Edit**. -1. Change the default policy to the contact point you created. -1. Click **Update default policy**. +To add this contact point to your alert, complete the following steps. -{{}} -If you have more than one contact point, add a new child notification policy rather than edit the default one, so you can route specific alerts to Telegram. -{{}} +1. In Grafana, navigate to **Alerting** > **Alert rules**. +1. Edit or create a new alert rule. +1. Scroll down to the **Configure labels and notifications** section. +1. Under Notifications click **Select contact point**. +1. From the drop-down menu, select the previously created contact point. +1. **Click Save rule and exit**. diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/pager-duty.md b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/pager-duty.md index 40259557fb4..8c002ad1c89 100644 --- a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/pager-duty.md +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/pager-duty.md @@ -63,11 +63,13 @@ To create your PagerDuty integration in Grafana Alerting, complete the following ## Next steps -To add the contact point and integration you created to your default notification policy, complete the following steps. +The PagerDuty contact point is ready to receive alert notifications. -1. Navigate to **Alerts & IRM** -> **Alerting** -> **Notification policies**. -1. In the Default policy, click the ellipsis icon (…) and then **Edit**. -1. Change the default policy to the contact point you created. -1. Click **Update default policy**. +To add this contact point to your alert, complete the following steps. -{{< admonition type="note" >}} If you have more than one contact point, add a new notification policy rather than edit the default one, so you can route specific alerts to PagerDuty. {{< /admonition >}} +1. In Grafana, navigate to **Alerting** > **Alert rules**. +1. Edit or create a new alert rule. +1. Scroll down to the **Configure labels and notifications** section. +1. Under Notifications click **Select contact point**. +1. From the drop-down menu, select the previously created contact point. +1. **Click Save rule and exit**. diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier.md b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier.md index 13d072a0279..85fbc93846e 100644 --- a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier.md +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier.md @@ -156,13 +156,13 @@ To create your webhook integration in Grafana Alerting, complete the following s ## Next steps -To add the contact point and integration you created to your default notification policy, complete the following steps. +The Webhook contact point is ready to receive alert notifications. -1. Navigate to **Alerts & IRM** -> **Alerting** -> **Notification policies**. -1. In the **Default policy**, click the ellipsis icon (…) and then **Edit**. -1. Change the default policy to the contact point you created. -1. Click **Update default policy**. +To add this contact point to your alert, complete the following steps. -{{< admonition type="note" >}} -If you have more than one contact point, add a new notification policy rather than edit the default one, so you can route specific alerts to your webhook. -{{< /admonition >}} +1. In Grafana, navigate to **Alerting** > **Alert rules**. +1. Edit or create a new alert rule. +1. Scroll down to the **Configure labels and notifications** section. +1. Under Notifications, click **Select contact point**. +1. From the drop-down menu, select the previously created contact point. +1. **Click Save rule and exit**.