Merge pull request #270516 from rcdun/maintenance_notifications_for_communications_gateway

v-ccolin · web-flow · commit fdb38a4f3c91 · 2024-04-12T15:23:45.000+01:00
Add short article about maintenance notifications for Azure Communications Gateway
diff --git a/articles/communications-gateway/deploy.md b/articles/communications-gateway/deploy.md
@@ -224,6 +224,20 @@ If you chose to delegate a subdomain when you created Azure Communications Gatew
 1. Note down the names of these name servers, including the trailing `.` at the end of the address.
 1. Follow [Delegate the domain](../dns/dns-delegate-domain-azure-dns.md#delegate-the-domain) and [Verify the delegation](../dns/dns-delegate-domain-azure-dns.md#verify-the-delegation) to configure all four name servers in your NS records. We recommend configuring a time-to-live (TTL) of two days.
 
+## Configure alerts for upgrades, maintenance and resource health
+
+Azure Communications Gateway is integrated with Azure Service Health and Azure Resource Health.
+
+- We use Azure Service Health's service health notifications to inform you of upcoming upgrades and scheduled maintenance activities.
+- Azure Resource Health gives you a personalized dashboard of the health of your resources, so you can see the current and historical health status of your resources.
+
+You must set up the following alerts for your operations team.
+
+- [Alerts for service health notifications](/azure/service-health/alerts-activity-log-service-notifications-portal), for upgrades and maintenance activities.
+- [Alerts for resource health](/azure/service-health/resource-health-alert-monitor-guide), for changes in the health of Azure Communications Gateway.
+
+Alerts allow you to send your operations team proactive notifications of changes. For example, you can configure emails and/or SMS notifications. For an overview of alerts, see [What are Azure Monitor alerts?](/azure/azure-monitor/alerts/alerts-overview). For more information on Azure Service Health and Azure Resource Health, see [What is Azure Service Health?](/azure/service-health/overview) and [Resource Health overview](/azure/service-health/resource-health-overview).
+
 ## Next steps
 
 > [!div class="nextstepaction"]
diff --git a/articles/communications-gateway/includes/communications-gateway-monitoring-maintenance.md b/articles/communications-gateway/includes/communications-gateway-monitoring-maintenance.md
@@ -0,0 +1,13 @@
+---
+author: rcdun
+ms.author: rdunstan
+ms.service: communications-gateway
+ms.topic: include
+ms.date: 04/10/2024
+---
+
+Your operations team can use a selection of key metrics to monitor Azure Communications Gateway. These metrics are available to anyone with the Reader role on the subscription for Azure Communications Gateway. See [Monitoring Azure Communications Gateway](/azure/communications-gateway/monitor-azure-communications-gateway).
+
+Your operations team must have Azure Monitor alerts for:
+- [Azure Service Health notifications](/azure/service-health/alerts-activity-log-service-notifications-portal) to stay informed about upcoming upgrades and scheduled maintenance activities.  
+- [Azure resource health notifications](/azure/service-health/resource-health-alert-monitor-guide) to stay informed about changes in the health of Azure Communications Gateway.
diff --git a/articles/communications-gateway/index.yml b/articles/communications-gateway/index.yml
@@ -124,6 +124,8 @@ landingContent:
         links:
           - text: Monitoring Azure Communications Gateway
             url: monitor-azure-communications-gateway.md
+          - text: Maintenance notifications
+            url: maintenance-notifications.md
       - linkListType: how-to-guide
         links:
           - text: Get support or request changes
diff --git a/articles/communications-gateway/maintenance-notifications.md b/articles/communications-gateway/maintenance-notifications.md
@@ -0,0 +1,42 @@
+---
+title: Check for Azure Communications Gateway upgrades and maintenance
+description: Learn how to use Azure Service Health to check for upgrades and maintenance notifications for Azure Communications Gateway.
+author: rcdun
+ms.author: rdunstan
+ms.service: communications-gateway
+ms.topic: concept-article
+ms.date: 04/10/2024
+
+#CustomerIntent: As a customer managing Azure Communications Gateway, I want to learn about upcoming changes so that I can plan for service impact.
+---
+
+# Maintenance notifications for Azure Communications Gateway
+
+We manage Azure Communications Gateway for you, including upgrades and maintenance activities.
+
+Azure Communications Gateway is integrated with [Azure Service Health](/azure/service-health/overview). We use Azure Service Health's service health notifications to inform you of upcoming upgrades and scheduled maintenance activities.
+
+You must monitor Azure Service Health and enable alerts for notifications about planned maintenance.
+
+## Viewing information about upgrades
+
+To view information about upcoming upgrades, sign in to the [Azure portal](https://portal.azure.com/), and select **Monitor** followed by  **Service Health**. The Azure portal displays a list of notifications. Notifications about upgrades and other maintenance activities are listed under **Planned maintenance**.
+
+:::image type="content" source="media/maintenance-notifications/planned-maintenance-list.png" alt-text="Screenshot of a list of planned maintenance notifications in the Azure portal." lightbox="media/maintenance-notifications/planned-maintenance-list.png":::
+
+To view more information about a notification, select it. Each notification provides more details about the upgrade, including any expected impact.
+
+:::image type="content" source="media/maintenance-notifications/maintenance-notification.png" alt-text="Screenshot of an upgrade notification in the Azure portal." lightbox="media/maintenance-notifications/maintenance-notification.png":::
+
+For more on viewing notifications, see [View service health notifications by using the Azure portal](/azure/service-health/service-notifications).
+
+## Setting up alerts
+
+Alerts allow you to send your operations team proactive notifications of upcoming maintenance activities. For example, you can configure emails and/or SMS notifications. For an overview of alerts, see [What are Azure Monitor alerts?](/azure/azure-monitor/alerts/alerts-overview).
+
+You can configure alerts for planned maintenance notifications by selecting **Create service health alert** from the **Planned maintenance** pane for Service Health or by following [Set up alerts for service health notifications](/azure/service-health/alerts-activity-log-service-notifications-portal).
+
+## Next step
+
+> [!div class="nextstepaction"]
+> [Set up alerts for service health notifications](/azure/service-health/alerts-activity-log-service-notifications-portal)
diff --git a/articles/communications-gateway/media/maintenance-notifications/maintenance-notification.png b/articles/communications-gateway/media/maintenance-notifications/maintenance-notification.png
diff --git a/articles/communications-gateway/media/maintenance-notifications/planned-maintenance-list.png b/articles/communications-gateway/media/maintenance-notifications/planned-maintenance-list.png
diff --git a/articles/communications-gateway/prepare-for-live-traffic-operator-connect.md b/articles/communications-gateway/prepare-for-live-traffic-operator-connect.md
@@ -175,9 +175,9 @@ Before you can go live, you must get your customer-facing materials approved by
 
 You must test that you can raise tickets in the Azure portal to report problems with Azure Communications Gateway. See [Get support or request changes for Azure Communications Gateway](request-changes.md).
 
-## Learn about monitoring Azure Communications Gateway
+## Learn about monitoring and maintenance
 
-Your staff can use a selection of key metrics to monitor Azure Communications Gateway. These metrics are available to anyone with the Reader role on the subscription for Azure Communications Gateway. See [Monitoring Azure Communications Gateway](monitor-azure-communications-gateway.md).
+[!INCLUDE [monitoring and service health notifications](includes/communications-gateway-monitoring-maintenance.md)]
 
 ## Verify API integration
 
@@ -229,3 +229,4 @@ Your service can be launched on specific dates each month. Your onboarding team
 - Learn about [getting support and requesting changes for Azure Communications Gateway](request-changes.md).
 - Learn about [using the Number Management Portal to manage enterprises](manage-enterprise-operator-connect.md).
 - Learn about [monitoring Azure Communications Gateway](monitor-azure-communications-gateway.md).
+- Learn about [maintenance notifications](maintenance-notifications.md).
diff --git a/articles/communications-gateway/prepare-for-live-traffic-teams-direct-routing.md b/articles/communications-gateway/prepare-for-live-traffic-teams-direct-routing.md
@@ -44,11 +44,12 @@ You must test typical call flows for your network. Your onboarding team will pro
 
 You must test that you can raise tickets in the Azure portal to report problems with Azure Communications Gateway. See [Get support or request changes for Azure Communications Gateway](request-changes.md).
 
-## Learn about monitoring Azure Communications Gateway
+## Learn about monitoring and maintenance
 
-Your staff can use a selection of key metrics to monitor Azure Communications Gateway. These metrics are available to anyone with the Reader role on the subscription for Azure Communications Gateway. See [Monitoring Azure Communications Gateway](monitor-azure-communications-gateway.md).
+[!INCLUDE [monitoring and service health notifications](includes/communications-gateway-monitoring-maintenance.md)]
 
 ## Next steps
 
 - Learn about [getting support and requesting changes for Azure Communications Gateway](request-changes.md).
 - Learn about [monitoring Azure Communications Gateway](monitor-azure-communications-gateway.md).
+- Learn about [maintenance notifications](maintenance-notifications.md).
diff --git a/articles/communications-gateway/prepare-for-live-traffic-zoom.md b/articles/communications-gateway/prepare-for-live-traffic-zoom.md
@@ -54,9 +54,9 @@ You must test that you can raise tickets in the Azure portal to report problems
 > [!NOTE]
 > If we think a problem is caused by traffic from Zoom servers, we might ask you to raise a separate support request with Zoom. Ensure you also know how to raise a support request with Zoom.
 
-## Learn about monitoring Azure Communications Gateway
+## Learn about monitoring and maintenance
 
-Your staff can use a selection of key metrics to monitor Azure Communications Gateway. These metrics are available to anyone with the Reader role on the subscription for Azure Communications Gateway. See [Monitoring Azure Communications Gateway](monitor-azure-communications-gateway.md).
+[!INCLUDE [monitoring and service health notifications](includes/communications-gateway-monitoring-maintenance.md)]
 
 ## Schedule launch
 
@@ -66,3 +66,4 @@ Your launch date is the date that you'll be able to start selling Zoom Phone Clo
 
 - Learn about [getting support and requesting changes for Azure Communications Gateway](request-changes.md).
 - Learn about [monitoring Azure Communications Gateway](monitor-azure-communications-gateway.md).
+- Learn about [maintenance notifications](maintenance-notifications.md).
diff --git a/articles/communications-gateway/toc.yml b/articles/communications-gateway/toc.yml
@@ -98,6 +98,8 @@ items:
       href: monitor-azure-communications-gateway.md
     - name: Monitoring data reference
       href: monitoring-azure-communications-gateway-data-reference.md
+  - name: Maintenance notifications
+    href: maintenance-notifications.md
   - name: Get support or request changes
     href: request-changes.md
 - name: Reference
