Skip to content

Commit 18fb7a8

Browse files
authored
Merge pull request #308896 from TimShererWithAquent/us508796-06
AI Freshness Edit: App Service: Routine planned maintenance for Azure App Service
2 parents 823fda8 + 2f93bff commit 18fb7a8

2 files changed

Lines changed: 19 additions & 17 deletions

File tree

-49.5 KB
Loading

articles/app-service/routine-maintenance.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: msangapu-msft
55
tags: app-service
66

77
ms.topic: concept-article
8-
ms.date: 05/19/2025
8+
ms.date: 12/02/2025
99
ms.update-cycle: 180-days
1010
ms.author: msangapu
1111
ms.collection: ce-skilling-ai-copilot
@@ -14,38 +14,38 @@ ms.custom:
1414
- build-2025
1515
- sfi-image-nochange
1616

17-
# As an App Service user, I want to learn about routine planned maintenance so that I know what to expect.
17+
#customer intent: As an App Service user, I want to learn about routine planned maintenance so that I know what to expect.
1818

1919
---
2020

2121
# Routine planned maintenance for Azure App Service
2222

23-
Routine maintenance includes behind-the-scenes updates to Azure App Service. These updates may include performance improvements, bug fixes, new features, or security updates. Maintenance can apply to the App Service platform or the underlying operating system.
23+
Routine maintenance includes behind-the-scenes updates to Azure App Service. These updates can include performance improvements, bug fixes, new features, or security updates. Maintenance can apply to the App Service platform or the underlying operating system.
2424

2525
> [!IMPORTANT]
2626
> A breaking change or deprecation of functionality isn't part of routine maintenance. For more information, see [Modern Lifecycle Policy](/lifecycle/policies/modern).
2727
28-
Microsoft's service quality and uptime guarantees continue to apply during maintenance periods. Notifications are provided to give customers visibility into platform changes.
28+
Microsoft's service quality and uptime guarantees continue to apply during maintenance periods. We notify customers to provide visibility into platform changes.
2929

3030
## What to expect
3131

32-
Like personal computers, mobile phones, and other devices, machines in the cloud need regular updates. Unlike physical devices, Azure App Service handles routine maintenance with minimal disruption. Workloads can be shifted to updated hardware in seconds, allowing updates to proceed without downtime.
32+
Like personal computers, mobile phones, and other devices, computers in the cloud need regular updates. Unlike physical devices, Azure App Service handles routine maintenance with minimal disruption. Workloads can be shifted to updated hardware in seconds, which allows updates to proceed without downtime.
3333

34-
Maintenance typically occurs monthly but may vary depending on your organization's needs and other factors.
34+
Maintenance typically occurs monthly but might vary depending on your organization's needs and other factors.
3535

36-
Because a typical cloud solution consists of multiple applications, databases, storage accounts, functions, and other resources, parts of your solution may undergo maintenance at different times. This variation can be due to geography, region, datacenters, and availability zones. For more information, see [Safe deployment practices](/devops/operate/safe-deployment-practices).
36+
Because a typical cloud solution consists of multiple applications, databases, storage accounts, functions, and other resources, parts of your solution might undergo maintenance at different times. This variation can be due to geography, region, datacenters, and availability zones. For more information, see [Safe deployment practices](/devops/operate/safe-deployment-practices).
3737

38-
To find maintenance events, search for **Service Health** in the Azure portal. Under **Active Events**, select **Planned maintenance**.
38+
To find maintenance events, search for **Service Health** in the Azure portal. Under **ACTIVE EVENTS**, select **Planned maintenance**.
3939

4040
:::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":::
4141

42-
From top to bottom, the example shows:
42+
The Azure portal provides this information:
4343

4444
- A descriptive title of the maintenance event.
4545
- Affected regions and subscriptions.
4646
- The expected maintenance window.
4747

48-
The following screenshots show additional information available through the **Impacted Resources** tab:
48+
The following screenshots show information available through the **Impacted Resources** tab:
4949

5050
:::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":::
5151

@@ -55,20 +55,20 @@ From left to right, the example shows:
5555
- The **More info** option.
5656

5757
> [!NOTE]
58-
> Manual initiation of maintenance is not supported for App Service Plans. However, App Service Environments (ASE) do support manual maintenance preferences.
58+
> Manual initiation of maintenance isn't supported for App Service Plans. App Service Environments (ASE) do support manual maintenance preferences.
5959
6060
:::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":::
6161

6262
This example shows:
6363

6464
- The state of the maintenance, which can be pending, started, or completed.
65-
- Once maintenance starts, timestamps can be viewed under **More info**.
65+
- After maintenance starts, you can view timestamps under **More info**.
6666

6767
## Frequently asked questions
6868

6969
### Why is the maintenance taking so long?
7070

71-
Routine maintenance delivers the latest updates to the platform and service. It's difficult to predict how maintenance affects individual apps, so notifications provide general time ranges. These ranges reflect the overall operation across all resources, not specific app-level experiences. Apps that undergo maintenance restart on freshly updated machines and continue working. There's no downtime when requests and traffic aren't served.
71+
Routine maintenance delivers the latest updates to the platform and service. It's difficult to predict how maintenance affects individual apps. Notifications provide general time ranges. These ranges reflect the overall operation across all resources, not specific app-level experiences. Apps that undergo maintenance restart on updated machines and continue to run. There's no downtime when requests and traffic aren't served.
7272

7373
### Why am I getting so many notifications?
7474

@@ -78,7 +78,7 @@ Customers often have multiple applications that are upgraded at different times.
7878

7979
Platform maintenance shouldn't affect application uptime or availability. Applications continue to stay online while platform maintenance occurs.
8080

81-
Platform maintenance might cause applications to be cold started on new virtual machines, which can lead to delays. An application is still considered to be online while it's cold starting. To minimize or avoid cold starts, consider using [local cache for Windows apps](overview-local-cache.md) and [health check](monitor-instances-health-check.md).
81+
Platform maintenance might cause applications to be started cold on new virtual machines, which can lead to delays. An application is still considered to be online while it's cold-starting. To minimize or avoid cold starts, consider using [local cache for Windows apps](overview-local-cache.md) and [health check](monitor-instances-health-check.md).
8282

8383
We don't expect sites to incur any service-level agreement (SLA) violations during the maintenance windows.
8484

@@ -90,11 +90,13 @@ Maintenance operations upgrade machines iteratively while App Service monitors t
9090

9191
### Are business hours reflected?
9292

93-
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 is designed to minimize disruption during business hours. If any upgrades are still in progress by 9 AM in a given region, they will attempt to pause before reaching critical phases. Some underlying instance movements may continue, but they are orchestrated to overlap safely and maintain site availability.
93+
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. There's less stress on the system in customer applications and on the platform itself.
94+
95+
App Service maintenance is designed to minimize disruption during business hours. If any upgrades are still in progress by 9 AM in a given region, they attempt to pause before reaching critical phases. Some underlying instance movements might continue, but they're orchestrated to overlap safely and maintain site availability.
9496

9597
### What are my options to control routine maintenance?
9698

97-
If you run your workloads in an isolated product via App Service Environment v3, you can schedule the upgrades if necessary. For more information about this capability, see the blog post [Control and automate planned maintenance for App Service Environment v3](https://azure.github.io/AppService/2022/09/15/Configure-automation-for-upgrade-preferences-in-App-Service-Environment.html).
99+
If you run your workloads in an isolated product by using App Service Environment v3, you can schedule the upgrades if necessary. For more information about this capability, see the blog post [Control and automate planned maintenance for App Service Environment v3](https://azure.github.io/AppService/2022/09/15/Configure-automation-for-upgrade-preferences-in-App-Service-Environment.html).
98100

99101
### Can I prepare my apps better for restarts?
100102

@@ -104,7 +106,7 @@ You can use health check to inform the platform that your application isn't read
104106

105107
### My applications have been online, but things are worse since these notifications started showing up. What changed?
106108

107-
Updates and maintenance events have been happening to the platform since its inception. The frequency of updates has decreased over time, so the number of interruptions has also decreased and uptime has increased. However, you now have more visibility into all changes. Increased visibility might cause the perception that more changes are happening.
109+
Updates and maintenance events have been happening to the platform since its inception. The frequency of updates decreased over time. 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.
108110

109111
## Related content
110112

0 commit comments

Comments
 (0)