Merge pull request #96552 from MikeDodaro/alerts-action

New tutorial for Spring alerts, work item: 1642092

Author: megvanhuygen

articles/spring-cloud/media/alerts-action-groups/action-1-a.png

@@ -0,0 +1,85 @@
+---
+title: "Tutorial: Monitor Azure Spring Cloud resources using alerts and action groups | Microsoft Docs"
+description: Learn how to use Spring Cloud alerts.
+author: MikeDodaro
+ms.author: barbkess
+ms.service: spring-cloud
+ms.topic: tutorial
+ms.date: 11/18/2019
+
+---
+# Tutorial: Monitor Spring Cloud resources using alerts and action groups
+
+Azure Spring Cloud alerts support monitoring resources based on conditions such as available storage, rate of requests, or data usage. An alert sends notification when rates or conditions meet the defined specifications.
+
+There are two steps to set up an alert pipeline: 
+1. Set up an Action Group with the actions to be taken when an alert is triggered, such as email, SMS, Runbook, or Webhook. Action Groups can be re-used among different alerts.
+2. Set up Alert rules. The rules bind metric patterns with the action groups based on target resource, metric, condition, time aggregation, etc.
+
+## Prerequisites
+In addition to the Azure Spring requirements, this tutorial depends on the following resources.
+
+* A deployed Azure Spring Cloud instance.  Follow our [quickstart](spring-cloud-quickstart-launch-app-cli.md) to get started.
+
+* An Azure resource to monitor, for example the database implemented in this article: [How to use Spring Data Apache Cassandra API with Azure Cosmos DB](https://docs.microsoft.com/azure/java/spring-framework/configure-spring-data-apache-cassandra-with-cosmos-db)
+ 
+The following procedures initialize both **Action Group** and **Alert** starting from the **Alerts** option in the left navigation pane of a Spring Cloud instance. (The procedure can also start from the **Monitor Overview** page of the Azure portal.) 
+
+Navigate from a resource group to your Spring Cloud instance. Select **Alerts** in the left pane, then select **Manage actions**:
+
+![Screenshot portal resource group page](media/alerts-action-groups/action-1-a.png)
+
+## Set up Action Group
+
+To begin the procedure to initialize a new **Action Group**, select **+ Add action group**.
+
+![Screenshot portal Add action group](media/alerts-action-groups/action-1.png)
+
+On the **Add action group** page:
+
+ 1. Specify an **Action group name** and **Short name**.
+
+ 1. Specify **Subscription** and **Resource group**.
+
+ 1. Specify **Action Name**.
+
+ 1. Select **Action Type**.  This will open another pane on the right to define the action that will be taken on activation.
+
+ 1. Define the action using the options in the right pane.  This case uses email notification.
+
+ 1. Click **OK** in the right action pane.
+
+ 1. Click **OK** in the **Add action group** dialog. 
+
+  ![Screenshot Portal define action](media/alerts-action-groups/action-2.png)
+
+## Set up Alert 
+
+The previous steps created an **Action Group** that uses email. You could also use phone notification, webhooks, Azure functions, etc.  
+
+To configure an **Alert**, navigate back to the **Alerts** page, and click **Manage Alert Rules**.
+
+  ![Screenshot Portal define alert](media/alerts-action-groups/alerts-2.png)
+
+1. Select the **Resource** for the alert.
+
+1. Click **+ New alert rule**.
+
+  ![Screenshot Portal new alert rule](media/alerts-action-groups/alerts-3.png)
+
+1. On the **Create rule** page, specify the **RESOURCE**, **CONDITION**, and **ACTIONS**.  From **ACTIONS** pane select the previously defined **Action Group**.
+
+1. Under **ALERT DETAILS**, Name the alert rule.
+
+1. Click **Create alert rule**.
+
+  ![Screenshot Portal new alert rule](media/alerts-action-groups/alerts-4.png)
+
+Verify that the new alert rule is enabled.
+
+  ![Screenshot Portal new alert rule](media/alerts-action-groups/alerts-5.png)
+
+## Next steps
+* [Create and manage action groups in the Azure portal](https://docs.microsoft.com/azure/azure-monitor/platform/action-groups)
+* [SMS Alert Behavior in Action Groups](https://docs.microsoft.com/azure/azure-monitor/platform/alerts-sms-behavior)
+* [Tutorial: Using Distributed Tracing with Azure Spring Cloud](https://docs.microsoft.com/azure/spring-cloud/spring-cloud-tutorial-distributed-tracing)

articles/spring-cloud/media/alerts-action-groups/action-1.png

@@ -26,6 +26,8 @@
       href: spring-cloud-tutorial-scale-manual.md
     - name: Monitor your application using distributed tracing and App Insights
       href: spring-cloud-tutorial-distributed-tracing.md
+    - name: Monitor Spring Cloud resources using alerts and action groups
+      href: spring-cloud-tutorial-alerts-action-groups.md
     - name: Bind your application to Azure CosmosDB
       href: spring-cloud-tutorial-bind-cosmos.md
     - name: Bind your application with Azure Cache for Redis