Skip to content

Commit 52ba1c6

Browse files
authored
Update slow-vm-start-extensions-troubleshooting.md
Edit review per CI 7213
1 parent 83c740f commit 52ba1c6

1 file changed

Lines changed: 22 additions & 47 deletions

File tree

Lines changed: 22 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,78 +1,53 @@
11
---
2-
title: Slow Azure Virtual Machine Start operations caused by extensions being in a failed state
3-
description: Troubleshooting guide for slow Azure Virtual Machine Start operations caused by the extensions being in a failed state.
2+
title: Slow Azure Virtual Machine Start Operations Caused by Extensions in failed state
3+
description: Troubleshooting guide for slow Azure Virtual Machine Start operations that are caused by the extensions being in a failed state.
44
ms.date: 08/28/2025
55
ms.reviewer: v-liuamson; v-gsitser
66
ms.service: azure-virtual-machines
77
ms.collection: windows
88
ms.custom: sap:Cannot start or stop my VM
99
---
10-
# Slow Azure Virtual Machine Start operations caused by extensions being in a failed state
10+
# Slow Azure VM Start operations when extensions are "Failed"
1111

1212
## Overview
1313

14-
You may experience slow Azure Virtual Machine (VM) **Start** or **Redeploy**
15-
operations when one or more of the VM extensions are in a **Failed** state.
16-
This article will cover possible causes and resolutions.
14+
You might experience slow Microsoft Azure Virtual Machine (VM) **Start** or **Redeploy** operations when one or more of the VM extensions are in a **Failed** state. This article discusses possible causes of this issue and resolutions.
1715

18-
## Symptom
16+
## Symptoms
1917

20-
In this scenario, the VM's guest OS can be active and working and the
21-
VM can connect successfully, but the operation is still appearing to run
22-
in the Azure portal.
18+
Although the Azure VM guest OS is active and working, and the VM can connect successfully, the operation still appears to run in the Azure portal.
2319

2420
## Cause
2521

26-
VM extensions are software components that run inside the VM to enable
27-
configuration management, security, monitoring, and other features. VM
28-
extensions have a 90-minute provisioning timeout, which means they must
29-
complete their installation or update within that time limit. If an
30-
extension fails to provision within the timeout, it will be marked as
31-
failed and will not be retried until the next VM operation that triggers
32-
the extension, such as a **Start** or a **Redeploy**.
22+
VM extensions are software components that run inside the VM to enable configuration management, security, monitoring, and other features. VM extensions have a 90-minute provisioning timeout. They must complete their installation or update within that time limit. If an extension doesn't provision within the timeout period, it's marked as failed. The extension isn't retried until the next VM operation that triggers it, such as **Start** or **Redeploy**.
3323

34-
When a VM has one or more extensions in a failed state, it can cause
35-
delays in other VM operations, such as **Start** or **Redeploy** because the Azure
36-
platform will try to provision the failed extensions again before
37-
completing the operation. This can result in the VMs showing a **Starting**
38-
status for an extended period.
24+
If a VM has one or more extensions in a **Failed** state, delays can occur in other VM operations, such as **Start** or **Redeploy**. This issue occurs because the Azure platform tries to provision the failed extensions again before it completes the operation. Therefore, the VMs show a **Starting** status for an extended period.
3925

40-
## Resolution
26+
## Workaround
4127

42-
To mitigate this issue, you may follow these steps:
28+
To mitigate this issue, follow these steps:
4329

44-
1. Review the extension status and logs for the VM to determine the
45-
root cause of the failure.
30+
1. To determine the root cause of the failure, review the extension status and logs for the VM.
4631

47-
- To check the status of the extensions installed on the VM, go to the
48-
VM Blade and select the **extensions + applications** option under
49-
**Settings** in the left-hand pane. If the status is not **Provisioning Succeeded**, the extension may need to be removed or further investigation may be required.
32+
To check the status of the extensions that are installed on the VM, go to the VM blade, and then select the **extensions + applications** option under
33+
**Settings** in the left pane. If the status is not **Provisioning Succeeded**, the extension might have to be removed or investigated further.
5034

51-
:::image type="content" source="media/slow-vm-start-extensions-troubleshooting/extensions-applications-status.png" alt-text="Screenshot of the portal with the extenstions and applications statuses. Status is highlighted.":::
35+
:::image type="content" source="media/slow-vm-start-extensions-troubleshooting/extensions-applications-status.png" alt-text="Screenshot of the portal showing the extensions and applications statuses. Status is highlighted.":::
5236

53-
- Logs for the extensions can be found within the Guest OS of the VM.
54-
See the [Further Troubleshooting section](#further-troubleshooting) for more information.
37+
- Logs for the extensions can be found within the Guest OS of the VM. For more information, see the [Further Troubleshooting section](#further-troubleshooting).
5538

56-
1. Check the status of the VM "Guest Agent", as it is responsible for
57-
handling the provisioning of extensions. If the "Guest Agent" is not
58-
in a ready state, it may need to be reviewed. For further guidance,
59-
refer to the documents mentioned in the [Further Troubleshooting section](#further-troubleshooting).
39+
1. Check the status of the VM "Guest Agent" that's responsible for provisioning the extensions. If the "Guest Agent" is not in a ready state, a review might be required. For further guidance, refer to the documents that are mentioned in the [Further Troubleshooting section](#further-troubleshooting).
6040

61-
:::image type="content" source="media/slow-vm-start-extensions-troubleshooting/agent-status-version.png" alt-text="Screenshot of the portal with the VM overview. Agent status and Agent version are highlighted.":::
41+
:::image type="content" source="media/slow-vm-start-extensions-troubleshooting/agent-status-version.png" alt-text="Screenshot of the portal showing the VM overview. Agent status and Agent version are highlighted.":::
6242

63-
1. Resolve the extension failure by either fixing the configuration or
64-
uninstalling the extension. You can use the Azure portal, PowerShell, CLI, or REST API to update or remove the extension. You may need to contact the extension publisher for support if the issue is related to the extension functionality or compatibility.
43+
1. Resolve the extension failure by either fixing the configuration or uninstalling the extension. You can use the Azure portal, PowerShell, CLI, or REST API to update or remove the extension. If the issue is related to the extension functionality or compatibility, you might have to contact the extension publisher for support.
6544

66-
1. Stop then Start the VM to verify that the extension provisioning
67-
succeeds and the VM Start operation completes faster. You can use
68-
the Azure portal, PowerShell, CLI, or REST API to "Stop/Start" the
69-
VM.
45+
1. Stop and then restart the VM to verify that the extension provisioning succeeds and the VM Start operation finishes faster. You can use the Azure portal, PowerShell, CLI, or REST API to do these operations.
7046

71-
## Further Troubleshooting
47+
## More information
7248

73-
For more guidance on how to troubleshoot Azure VM guest agent and
74-
extension issues, see:
49+
For additional guidance to troubleshoot the Azure VM Guest Agent and extension issues, see:
7550

76-
- [Troubleshooting Windows VM extension failures](/azure/virtual-machines/extensions/troubleshoot)
51+
- [Troubleshooting Azure Windows VM extension failures](/azure/virtual-machines/extensions/troubleshoot)
7752
- [Troubleshoot Azure Windows VM Agent issues](windows-azure-guest-agent.md)
7853
- [Troubleshoot the Azure Linux Agent](../linux/linux-azure-guest-agent.md)

0 commit comments

Comments
 (0)