docs(cpt): add tutorial

Author: nerda-codes

pages/cockpit/index.mdx

@@ -52,8 +52,8 @@ meta:
 <Grid>
 
     <DefaultCard
-        title="Using Cockpit with Terraform"
-        url="/tutorials/use-cockpit-with-terraform/"
+        title="Configuring Slack for Grafana alerting using a Webhook URL"
+        url="/tutorials/configure-slack-grafana-alerting/"
         label="Read more"
     />
     <DefaultCard

tutorials/configure-slack-grafana-alerting/assets/scaleway-slack-alerts-firing.webp

@@ -1,18 +1,18 @@
 ---
 meta:
-  title: How to configure Slack for Grafana alerting using a Webhook URL
+  title: Configuring Slack for Grafana alerting using a Webhook URL
   description: Learn how to send your Grafana alert notifications to your Slack channels for more efficient monitoring.
 content:
-  h1: How to configure Slack for Grafana alerting using a Webhook URL
+  h1: Configuring Slack for Grafana alerting using a Webhook URL
   paragraph: Learn how to send your Grafana alert notifications to your Slack channels for more efficient monitoring.
 categories:
   - observability
 dates:
-  validation: 2025-02-10
-  posted: 2025-02-10
+  validation: 2025-02-11
+  posted: 2025-02-11
 ---
 
-This page shows you how to use the Slack `Incoming Webhooks` feature to send your Grafana alert notifications to a Slack channel.
+This page shows you how to create a Slack app, create a Slack webhook, create your Slack integration in Grafana using the Scaleway Alerting and the Grafana alert managers, and how to configure notification policies to receive your Grafana alert notifications to your Slack channel.
 
 <Macro id="requirements" />
 
@@ -24,7 +24,7 @@ This page shows you how to use the Slack `Incoming Webhooks` feature to send you
  - [Configured](/cockpit/how-to/configure-alerts-for-scw-resources/) Grafana alerts for your resources
  - Created a Slack workspace in which you want to receive the alert notifications
 
-## How to create a Slack app
+## Creating a Slack app
 
 1. Refer to the [Slack documentation](https://api.slack.com/messaging/webhooks#create-app) and click **Create your Slack app**. You are redirected to a new page and a pop-up appears prompting you to either create your app **from a manifest** or **from scratch**.
 2. Click **From scratch**.
@@ -38,7 +38,7 @@ This page shows you how to use the Slack `Incoming Webhooks` feature to send you
     - Add a long description
 7. Click **Save Changes** Once you are done configuring your app.
 
-## How to activate incoming webhooks
+## Activating incoming Webhooks
 
 1. Click **Incoming Webhooks** under the **Features** section.
 2. Click the toggle icon to activate incoming webhooks. The **Webhook URLs for Your Workspace** section displays.
@@ -47,22 +47,26 @@ This page shows you how to use the Slack `Incoming Webhooks` feature to send you
 5. Click **Allow**.
 6. Click **Copy** under the **Webhook URL** section, as you will need it in the next steps.
 
-## How to create your Slack integration in Grafana
+## Creating your Slack integration in Grafana
 
-### With the Scaleway Alerting alert manager
+### Using the Scaleway Alerting alert manager
 
 1. [Access](/cockpit/how-to/access-grafana-and-managed-dashboards/) your Grafana dashboard.
 2. Click the **Toggle menu** icon next to **Home** in the top left corner of your screen.
 3. Click **Alerting**, then click **Contact points**.
 4. Choose the **Scaleway Alerting** alert manager in the drop-down next to the **Choose Alertmanager** field.
 5. Click **+ Add contact point**.
-6. Enter a contact point name.
+6. Enter a contact point name. For example, `Slack alerts`.
 7. Select **Slack** from the **Integration** drop-down.
 8. In the **Channel** field, paste the name of the Slack channel or user to send notifications to.
 9. Click **Optional Slack settings** and paste your Slack app Webhook URL in the **Webhook URL** field.
 10. Click **Save contact point**.
 
-### With the Grafana alert manager
+    <Message type="important">
+     If you have already created contact points, you need to [configure a nested notification policy](#configuring-a-notification-policy) to define which contact point should receive which alert.
+    </Message>
+
+### Using the Grafana alert manager
 
 1. [Access](/cockpit/how-to/access-grafana-and-managed-dashboards/) your Grafana dashboard.
 2. Click the **Toggle menu** icon next to **Home** in the top left corner of your screen.
@@ -77,3 +81,25 @@ This page shows you how to use the Slack `Incoming Webhooks` feature to send you
 11. Optionally, click **Test** to send a test notification to the recipient you have configured in step 8.
     <Lightbox src="scaleway-slack-alert-test.webp" alt="Grafana test alert notification on Slack" />
 12. Click **Save contact point**.
+
+    <Message type="important">
+     If you have already created contact points, you need to [configure a nested notification policy](#configuring-a-notification-policy) to define which contact point should receive which alert.
+    </Message>
+
+## Configuring a notification policy
+
+If you have created multiple contact points in Grafana, the default contact point will receive alerts by default. To make sure your alerts are sent to the desired contact point, you need to define notification policies.
+
+1. [Access](/cockpit/how-to/access-grafana-and-managed-dashboards/) your Grafana dashboard.
+2. Click the **Toggle menu** icon next to **Home** in the top left corner of your screen.
+3. Click **Alerting**, then click **Notification policies**.
+4. Click **+ New nested policy**.
+5. In the **Label** field, enter the label `alertname`.
+6. In the **Operator** field, select **Equals**.
+7. In the **Value** field, enter the name of an existing alert you want your contact point to be notified for. For example, `alert-for-high-cpu-usage`.
+8. Optionally, click **+Add matcher** to add more labels.
+9. In the **Contact point** field, select the contact point you have configured for Slack.
+10. Click **Save policy**. Your nested policy displays. You should now get notified on Slack.
+
+    <Lightbox src="scaleway-slack-alerts-firing.webp" alt="Grafana alert for high CPU usage notification on Slack" />
+