Diagnose artifact failures in the lab

After you have created an artifact, you can check to see whether it succeeded or failed. Artifact logs in Azure DevTest Labs provide information that you can use to diagnose an artifact failure. You have a couple of options for viewing the artifact log information for a Windows VM:

  • In the Azure portal
  • In the VM


To ensure that failures are correctly identified and explained, it's important that the artifact has the proper structure. For information about how to correctly construct an artifact, see Create custom artifacts. To see an example of a properly structured artifact, check out the Test parameter types artifact.

Troubleshoot artifact failures by using the Azure portal

  1. In the Azure portal, in your list of resources, select your lab.

  2. Choose the Windows VM that includes the artifact that you want to investigate.

  3. In the left panel, under GENERAL, select Artifacts. A list of artifacts associated with that VM appears. The name of the artifact and the artifact status are indicated.

    Artifact status

  4. Select an artifact that shows a Failed status. The artifact opens. An extension message that includes details about the failure of the artifact is displayed.

    Artifact error message

Troubleshoot artifact failures from within the virtual machine

  1. Sign in to the VM that contains the artifact you want to diagnose.

  2. Go to C:\Packages\Plugins\Microsoft.Compute.CustomScriptExtension\1.9\Status, where 1.9 is the Azure Custom Script Extension version number.

    The Status file

  3. Open the status file.

For instructions on finding the log files on a Linux VM, see the following article: Use the Azure Custom Script Extension Version 2 with Linux virtual machines

Next steps