|
1 | 1 | ---
|
2 |
| -title: Troubleshoot artifacts on lab virtual machines |
| 2 | +title: Troubleshoot Artifacts on Lab Virtual Machines |
3 | 3 | titleSuffix: Azure DevTest Labs
|
4 | 4 | description: Troubleshoot issues with applying artifacts on lab virtual machines in Azure DevTest Labs, including script problems, failure errors, and analyzing log data.
|
5 | 5 | ms.topic: troubleshooting-general
|
6 | 6 | ms.author: rosemalcolm
|
7 | 7 | author: RoseHJM
|
8 |
| -ms.date: 06/11/2024 |
| 8 | +ms.date: 07/18/2025 |
9 | 9 | ms.custom: UpdateFrequency2
|
10 | 10 |
|
11 |
| -#customer intent: As a developer, I want to analyze errors and log data about my lab artifacts in Azure DevTest Labs so I can troubleshoot and resolve issues. |
| 11 | +#customer intent: As a developer, I want to analyze errors and log data about my lab artifacts in Azure DevTest Labs so that I can troubleshoot and resolve issues. |
12 | 12 | ---
|
13 | 13 |
|
14 | 14 | # Troubleshoot artifacts on lab virtual machines in Azure DevTest Labs
|
15 | 15 |
|
16 | 16 | This article guides you through possible causes and troubleshooting steps for artifact failures on your Azure DevTest Labs virtual machine (VM) resources.
|
17 | 17 |
|
18 |
| -Artifacts are tools, actions, or software you can install on lab VMs during or after VM creation. Lab owners can [preselect mandatory artifacts](devtest-lab-mandatory-artifacts.md) to apply to all lab VMs at creation, and lab users can [apply artifacts to VMs](add-artifact-vm.md) that they own. Several possible issues can cause artifacts to fail to install and apply to a lab or run correctly on a lab VM. |
| 18 | +Artifacts are tools, actions, or software that you can install on lab VMs during or after VM creation. Lab owners can [preselect mandatory artifacts](devtest-lab-mandatory-artifacts.md) to apply to all lab VMs at creation, and lab users can [apply artifacts to VMs](add-artifact-vm.md) that they own. Several possible issues can cause artifacts to fail to install and apply to a lab or run correctly on a lab VM. |
19 | 19 |
|
20 | 20 | When an artifact appears to stop responding, the first step is to try to determine why the process is stuck. Artifact installation can be blocked during the initial request or fail during request execution. You can troubleshoot artifact failures from the Azure portal or from the VM where the artifact failure occurs.
|
21 | 21 |
|
22 | 22 | ## Troubleshoot in the Azure portal
|
23 | 23 |
|
24 |
| -If an artifact isn't successfully applying to your lab VM, you can start by investigating the status of your VM in the Azure portal. You can find information about the state of the VM, confirm it's running, and verify artifacts can be applied. The Activity log data for the lab VM shows entries about installation processes. You can check the entries to find information about artifact failures. |
| 24 | +If an artifact isn't successfully applying to your lab VM, you can start by investigating the status of your VM in the Azure portal. You can find information about the state of the VM, confirm it's running, and verify that artifacts can be applied. The Activity log data for the lab VM shows entries about installation processes. You can check the entries to find information about artifact failures. |
25 | 25 |
|
26 | 26 | ### Check VM status
|
27 | 27 |
|
28 |
| -Check the VM state in the Azure portal by following these steps: |
| 28 | +Check the VM status in the Azure portal by completing these steps: |
29 | 29 |
|
30 |
| -1. Browse to the **Overview** page for the DevTest Labs lab VM and confirm the machine is _Running_: |
| 30 | +1. Go to the **Overview** page for the DevTest Labs lab VM and confirm the machine status is _Running_: |
31 | 31 |
|
32 |
| - :::image type="content" source="media/devtest-lab-troubleshoot-apply-artifacts/check-lab-machine.png" border="false" alt-text="Screenshot that shows how to confirm the DevTest Labs virtual machine is running." lightbox="media/devtest-lab-troubleshoot-apply-artifacts/check-lab-machine-large.png"::: |
| 32 | + :::image type="content" source="media/devtest-lab-troubleshoot-apply-artifacts/check-lab-machine.png" border="false" alt-text="Screenshot that shows how to confirm that the DevTest Labs virtual machine is running." lightbox="media/devtest-lab-troubleshoot-apply-artifacts/check-lab-machine-large.png"::: |
33 | 33 |
|
34 | 34 | 1. Select **Artifacts** and open the artifacts list for the lab VM:
|
35 | 35 |
|
36 | 36 | :::image type="content" source="media/devtest-lab-troubleshoot-apply-artifacts/open-artifacts-list.png" alt-text="Screenshot that shows how to open the Artifacts list for the lab virtual machine.":::
|
37 | 37 |
|
38 |
| -1. Check the **Apply artifacts** option and confirm the lab VM is ready to accept applied artifacts: |
| 38 | +1. Check the **Apply artifacts** option and confirm that the lab VM is ready to accept applied artifacts: |
39 | 39 |
|
40 | 40 | :::image type="content" source="media/devtest-lab-troubleshoot-apply-artifacts/check-apply-artifacts.png" alt-text="Screenshot that shows how to confirm artifacts can be applied to the DevTest Labs virtual machine.":::
|
41 | 41 |
|
|
0 commit comments