Troubleshoot Azure Monitor for Windows Virtual Desktop (preview)

Important

Azure Monitor for Windows Virtual Desktop is currently in public preview. This preview version is provided without a service level agreement, and we don't recommend using it for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see Supplemental Terms of Use for Microsoft Azure Previews.

This article presents known issues and solutions for common problems in Azure Monitor for Windows Virtual Desktop (preview).

Issues with configuration and setup

If the configuration workbook isn't working properly to automate setup, you can use these resources to set up your environment manually:

My data isn't displaying properly

If your data isn't displaying properly, check your configuration, permissions, and check that required IP addresses are unblocked.

  • First, make sure you've filled out all fields in the configuration workbook as described in Use Azure Monitor for Windows Virtual Desktop to monitor your deployment. If you're missing any counters or events, the data associated with them won't appear in the Azure portal.

  • Check your access permissions & contact the resource owners to request missing permissions; anyone monitoring Windows Virtual Desktop requires the following permissions:

    • Read-access to the Azure subscriptions that hold your Windows Virtual Desktop resources
    • Read-access to the subscription's resource groups that hold your Windows Virtual Desktop session hosts
    • Read-access to the Log Analytics workspace
  • You may need to open outgoing ports in your server's firewall to allow Azure Monitor to send data to the portal, see Outgoing ports.

  • Not seeing data from recent activity? You may want to wait for 15 minutes and refresh the feed. Azure Monitor has a 15-minute latency period for populating log data. To learn more, see Log data ingestion time in Azure Monitor.

If you're not missing any information but your data still isn't displaying properly, there may be an issue in the query or the data sources. Review our known issues and limitations.

I want to customize Azure Monitor for Windows Virtual Desktop

Azure Monitor for Windows Virtual Desktop uses Azure Monitor Workbooks. Workbooks lets you save a copy of the Windows Virtual Desktop workbook template and make your own customizations.

By design, custom Workbook templates will not automatically adopt updates from the products group. For more information, see Troubleshooting workbook-based insights and the Workbooks overview.

I can't interpret the data

Learn more about data terms at the Azure Monitor for Window Virtual Desktop glossary.

The data I need isn't available

If you want to monitor more Performance Counters or Events, you can enable them to send to your Log Analytics workspace and monitor them in Host Diagnostics: Host browser.

Can't find a data point to help diagnose an issue? Send us feedback!

Known issues and limitations

These are issues and limitations we are currently aware of and working to fix:

  • You can only monitor one host pool at a time.

  • To save favorite settings, you have to save a custom template of the workbook. Custom templates won't automatically adopt updates from the product group.

  • Some error messages are not phrased in a user-friendly way, and not all error messages are described in the documentation.

  • The total sessions performance counter can over-count sessions by a small number and your total sessions may appear to go above your Max Sessions limit.

  • Available sessions count doesn't reflect scaling policies on the host pool.

  • While rare, a connection's completion event can go missing and this can impact some visuals like connections over time and the user's connection status.

  • The configuration workbook only supports configuring hosts within the same region as their resource group.

  • Time to connect includes the time it takes users to enter their credentials; this correlates to the experience but in some cases can show false peaks.

Next steps

If you're unsure how to interpret the data or want to learn more about common terms, check out the Azure Monitor for Windows Virtual Desktop glossary. If you want to learn how to set up and use Azure Monitor for Windows Virtual Desktop, see Use Azure Monitor for Windows Virtual Desktop to monitor your deployment.