|
1 | 1 | --- |
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. |
4 | 4 | ms.date: 08/28/2025 |
5 | 5 | ms.reviewer: v-liuamson; v-gsitser |
6 | 6 | ms.service: azure-virtual-machines |
7 | 7 | ms.collection: windows |
8 | 8 | ms.custom: sap:Cannot start or stop my VM |
9 | 9 | --- |
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" |
11 | 11 |
|
12 | 12 | ## Overview |
13 | 13 |
|
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. |
17 | 15 |
|
18 | | -## Symptom |
| 16 | +## Symptoms |
19 | 17 |
|
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. |
23 | 19 |
|
24 | 20 | ## Cause |
25 | 21 |
|
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**. |
33 | 23 |
|
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. |
39 | 25 |
|
40 | | -## Resolution |
| 26 | +## Workaround |
41 | 27 |
|
42 | | -To mitigate this issue, you may follow these steps: |
| 28 | +To mitigate this issue, follow these steps: |
43 | 29 |
|
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. |
46 | 31 |
|
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. |
50 | 34 |
|
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."::: |
52 | 36 |
|
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). |
55 | 38 |
|
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). |
60 | 40 |
|
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."::: |
62 | 42 |
|
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. |
65 | 44 |
|
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. |
70 | 46 |
|
71 | | -## Further Troubleshooting |
| 47 | +## More information |
72 | 48 |
|
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: |
75 | 50 |
|
76 | | -- [Troubleshooting Windows VM extension failures](/azure/virtual-machines/extensions/troubleshoot) |
| 51 | +- [Troubleshooting Azure Windows VM extension failures](/azure/virtual-machines/extensions/troubleshoot) |
77 | 52 | - [Troubleshoot Azure Windows VM Agent issues](windows-azure-guest-agent.md) |
78 | 53 | - [Troubleshoot the Azure Linux Agent](../linux/linux-azure-guest-agent.md) |
0 commit comments