Merge pull request #185179 from ishasahni1/patch-20

Added Test action rate limits

Author: ShannonLeavitt

articles/azure-monitor/alerts/action-groups.md

@@ -3,8 +3,9 @@ title: Create and manage action groups in the Azure portal
 description: Learn how to create and manage action groups in the Azure portal.
 author: dkamstra
 ms.topic: conceptual
-ms.date: 11/18/2021
+ms.date: 01/15/2022
 ms.author: dukek
+ms.custom: references_regions
 ---
 # Create and manage action groups in the Azure portal
 An action group is a collection of notification preferences defined by the owner of an Azure subscription. Azure Monitor, Service Health and Azure Advisor alerts use action groups to notify users that an alert has been triggered. Various alerts may use the same action group or different action groups depending on the user's requirements. 
@@ -94,6 +95,33 @@ Under **Instance details**:
 
 > [!NOTE]
 > When you configure an action to notify a person by email or SMS, they receive a confirmation indicating they have been added to the action group.
+### Test an action group in the Azure portal (Preview)
+
+When creating or updating an action group in the Azure portal, you can **test** the action group.
+1. After creating an action rule, click on **Review + create**.  Select *Test action group*.
+
+    ![The Test Action Group](./media/action-groups/test-action-group.png)
+    
+1. Select the *sample type* and select the notification and action types that you want to test and select **Test**.
+    
+    ![Select Sample Type + notification + action type](./media/action-groups/test-sample-action-group.png)
+
+1. If you close the window or select **Back to test setup** while the test is running, the test is stopped, and you will not get test results. 
+
+    ![Stop running test](./media/action-groups/stop-running-test.png)
+
+1. When the test is complete either a **Success** or **Failed** test status is displayed. If the test failed, you could select *View details* to get more information.  
+    ![Test sample failed](./media/action-groups/test-sample-failed.png)
+
+You can use the information in the **Error details section**, to understand the issue so that you can edit and test the action group again.
+To allow you to check the action groups are working as expected before you enable them in a production environment, you will get email and SMS alerts with the subject: Test.
+
+All the details and links in Test email notifications for the alerts fired are a sample set for reference. 
+
+> [!NOTE]
+> You may have a limited number of actions in a test Action Group. See the [rate limiting information](./alerts-rate-limiting.md) article.
+>
+> You can opt in or opt out to the common alert schema through Action Groups, on the portal. You can [find common schema samples for test action groups for all the sample types](./alerts-common-schema-test-action-definitions.md).
 
 ## Manage your action groups
 
@@ -153,11 +181,11 @@ While setting up *Email ARM Role* you need to make sure below 3 conditions are m
 > [!NOTE]
 > It can take upto **24 hours** for customer to start receiving notifications after they add new ARM Role to their subscription.
 
-### Event Hub (Preview)
+### Event hub (preview)
 > [!NOTE]
-> The Event Hub action type is currently in *Preview*. During the preview there may be bugs and disruptions in availability of the functionality.
+> The event hub action type is currently in *Preview*. During the preview there may be bugs and disruptions in availability of the functionality.
 
-An Event Hub action publishes notifications to an [Azure Event Hub](~/articles/event-hubs/event-hubs-about.md). You may then subscribe to the alert notification stream from your event receiver.
+An event hub action publishes notifications to [Azure Event Hubs](~/articles/event-hubs/event-hubs-about.md). You may then subscribe to the alert notification stream from your event receiver.
 
 ### Function
 Calls an existing HTTP trigger endpoint in [Azure Functions](../../azure-functions/functions-get-started.md). To handle a request, your endpoint must handle the HTTP POST verb.

articles/azure-monitor/alerts/alerts-common-schema-test-action-definitions.md

@@ -10,14 +10,22 @@ ms.date: 3/12/2018
 # Rate limiting for Voice, SMS, emails, Azure App push notifications and webhook posts
 Rate limiting is a suspension of notifications that occurs when too many are sent to a particular phone number, email address or device. Rate limiting ensures that alerts are manageable and actionable.
 
-The rate limit thresholds are:
+The rate limit thresholds in **production** are:
 
 - **SMS**: No more than 1 SMS every 5 minutes.
 - **Voice**: No more than 1 Voice call every 5 minutes.
 - **Email**: No more than 100 emails in an hour.
 
   Other actions are not rate limited.
 
+The rate limit thresholds for **test action group** are:
+
+- **SMS**: No more than 1 SMS every 1 minute.
+- **Voice**: No more than 1 Voice call every 1 minute.
+- **Email**: No more than 2 emails in every 1 minute.
+ 
+  Other actions are not rate limited.
+
 ## Rate limit rules
 - A particular phone number or email is rate limited when it receives more messages than the threshold allows.
 - A phone number or email can be part of action groups across many subscriptions. Rate limiting applies across all subscriptions. It applies as soon as the threshold is reached, even if messages are sent from multiple subscriptions.
@@ -26,4 +34,4 @@ The rate limit thresholds are:
 ## Next steps ##
 * Learn more about [SMS alert behavior](alerts-sms-behavior.md).
 * Get an [overview of activity log alerts](./alerts-overview.md), and learn how to receive alerts.  
-* Learn how to [configure alerts whenever a service health notification is posted](../../service-health/alerts-activity-log-service-notifications-portal.md).
+* Learn how to [configure alerts whenever a service health notification is posted](../../service-health/alerts-activity-log-service-notifications-portal.md).

articles/azure-monitor/alerts/alerts-rate-limiting.md

@@ -586,6 +586,8 @@ items:
         href: alerts/alerts-common-schema.md
       - name: Common alert schema definition
         href: alerts/alerts-common-schema-definitions.md
+      - name: Common alert schema definition for Test action group
+        href: alerts/alerts-common-schema-test-action-definitions.md       
       - name: Integrate the common alert schema with Logic Apps
         href: alerts/alerts-common-schema-integrations.md
       - name: SMS alert behavior
@@ -1556,4 +1558,4 @@ items:
   - name: Pricing calculator
     href: https://azure.microsoft.com/pricing/calculator/
   - name: Regional availability
-    href: https://azure.microsoft.com/global-infrastructure/services/?regions=all&products=monitor
+    href: https://azure.microsoft.com/global-infrastructure/services/?regions=all&products=monitor