Skip to content

Commit a07ea00

Browse files
Merge pull request #299234 from MicrosoftDocs/main
Merged by Learn.Build PR Management system
2 parents da12376 + 8f9c51f commit a07ea00

14 files changed

+137
-188
lines changed

articles/app-service/routine-maintenance.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
2-
title: Routine maintenance for Azure App Service
2+
title: Routine Maintenance for Azure App Service
33
description: Learn more about routine, planned maintenance to help keep the App Service platform up to date and secure.
44
author: msangapu-msft
55
tags: app-service
66

77
ms.topic: article
8-
ms.date: 02/08/2023
8+
ms.date: 04/29/2025
99
ms.author: msangapu
1010
---
1111

12-
# Routine (planned) maintenance for Azure App Service
12+
# Routine planned maintenance for Azure App Service
1313

14-
Routine maintenance covers behind-the-scenes updates to Azure App Service. Types of maintenance can be performance improvements, bug fixes, new features, or security updates. App Service maintenance can be on the service itself or the underlying operating system.
14+
Routine maintenance covers behind-the-scenes updates to Azure App Service. Types of maintenance can be performance improvements, bug fixes, new features, or security updates. App Service maintenance can be on the service itself or on the underlying operating system.
1515

1616
> [!IMPORTANT]
17-
> A breaking change or deprecation of functionality is not a part of routine maintenance. For more information, see [Modern Lifecycle Policy](/lifecycle/policies/modern).
17+
> A breaking change or deprecation of functionality isn't a part of routine maintenance. For more information, see [Modern Lifecycle Policy](/lifecycle/policies/modern).
1818
1919
Microsoft service quality and uptime guarantees continue to apply during maintenance periods. Notifications mention maintenance periods to help customers get visibility into platform changes.
2020

@@ -24,38 +24,38 @@ Like personal computers, mobile phones, and other devices, machines in the cloud
2424

2525
Because a typical cloud solution consists of multiple applications, databases, storage accounts, functions, and other resources, parts of your solutions can undergo maintenance at different times. Some of this coordination is related to geography, region, datacenters, and availability zones. It can also be due to the cloud, where not everything is touched simultaneously. For more information, see [Safe deployment practices](/devops/operate/safe-deployment-practices).
2626

27-
The following screenshot shows an example of a maintenance event:
27+
To find maintenance events, search for **Service Health** in the Azure portal. Under **Active Events**, select **Planned maintenance**.
2828

29-
:::image type="content" source="./media/routine-maintenance/routine-maintenance.png" alt-text="Screenshot of a maintenance event in the Azure portal.":::
29+
:::image type="content" source="media/routine-maintenance/routine-maintenance.png" alt-text="Screenshot of a maintenance event in the Azure portal." lightbox="media/routine-maintenance/routine-maintenance.png":::
3030

31-
In order from top to bottom, the example shows:
31+
From top to bottom, the example shows:
3232

3333
- A descriptive title of the maintenance event.
3434
- Affected regions and subscriptions.
3535
- The expected maintenance window.
3636

37-
The following screenshots show additional information available through the Impacted Resources dropdown:
37+
The following screenshots show additional information available through the **Impacted Resources** tab:
3838

39-
:::image type="content" source="./media/routine-maintenance/routine-maintenance-first-page.png" alt-text="Screenshot of the Impacted Resources blade in the Azure portal.":::
39+
:::image type="content" source="media/routine-maintenance/routine-maintenance-first-page.png" alt-text="Screenshot of the Impacted Resources section in the Azure portal." lightbox="media/routine-maintenance/routine-maintenance-first-page.png":::
4040

41-
In order from left to right, the example shows:
41+
From left to right, the example shows:
4242

43-
- Selecting the "Impacted Resources" dropdown.
44-
- The "More info" option.
43+
- Selecting the **Impacted Resources** tab.
44+
- The **More info** option.
4545

46-
:::image type="content" source="./media/routine-maintenance/routine-maintenance-more.png" alt-text="Screenshot of more info for a maintenance event in the Azure portal.":::
46+
:::image type="content" source="./media/routine-maintenance/routine-maintenance-more.png" alt-text="Screenshot of more info for a maintenance event in the Azure portal." lightbox="media/routine-maintenance/routine-maintenance-more.png":::
4747

4848
This example shows:
4949

5050
- The state of the maintenance, which can be pending, started, or completed.
51-
- Once maintenance starts, timestamps can be viewed under "More info."
51+
- Once maintenance starts, timestamps can be viewed under **More info**.
5252

5353

5454
## Frequently asked questions
5555

5656
### Why is the maintenance taking so long?
5757

58-
Fundamentally, routine maintenance delivers the latest updates to the platform and service. It's hard to predict how the maintenance will affect individual apps down to a specific time, so notifications tend to be more general. The time ranges in notifications don't reflect the experiences at the app level, but rather the overall operation across all resources. Apps that undergo maintenance instantly restart on freshly updated machines and continue working. There's no downtime when requests and traffic aren't served.
58+
Fundamentally, routine maintenance delivers the latest updates to the platform and service. It's hard to predict how the maintenance affects individual apps down to a specific time, so notifications tend to be more general. The time ranges in notifications don't reflect the experiences at the app level, but rather the overall operation across all resources. Apps that undergo maintenance instantly restart on freshly updated machines and continue working. There's no downtime when requests and traffic aren't served.
5959

6060
### Why am I getting so many notifications?
6161

@@ -77,7 +77,7 @@ Maintenance operations upgrade machines iteratively while App Service monitors t
7777

7878
### Are business hours reflected?
7979

80-
Yes, business hours are reflected for the time zone of the region. Maintenance operations are optimized to start outside the standard business hours of 9 AM to 5 PM. Statistically, that's the best time for any interruptions and restarts of workloads because there's less stress on the system (in customer applications and transitively on the platform itself). App Service maintenance makes a best effort to reduce maintenance operations during these business hours. If resources are still upgrading by 9 AM in a given region, the upgrade will continue until reaching a safe stopping point, pausing before the next critical step and until the end of business hours.
80+
Yes, business hours are reflected for the time zone of the region. Maintenance operations are optimized to start outside the standard business hours of 9 AM to 5 PM. Statistically, that's the best time for any interruptions and restarts of workloads because there's less stress on the system (in customer applications and transitively on the platform itself). App Service maintenance makes a best effort to reduce maintenance operations during these business hours. If resources are still upgrading by 9 AM in a given region, the upgrade continues until reaching a safe stopping point, pausing before the next critical step and until the end of business hours.
8181

8282
### What are my options to control routine maintenance?
8383

@@ -93,6 +93,6 @@ You can use health check to inform the platform that your application isn't read
9393

9494
Updates and maintenance events have been happening to the platform since its inception. The frequency of updates decreased over time, so the number of interruptions also decreased and uptime increased. However, you now have more visibility into all changes. Increased visibility might cause the perception that more changes are happening.
9595

96-
## Next steps
96+
## Related content
9797

98-
Get more information about maintenance notifications by reading the blog post [Routine Planned Maintenance Notifications for Azure App Service](https://azure.github.io/AppService/2022/02/01/App-Service-Planned-Notification-Feature.html).
98+
- [Routine Planned Maintenance Notifications for Azure App Service](https://azure.github.io/AppService/2022/02/01/App-Service-Planned-Notification-Feature.html)

0 commit comments

Comments
 (0)