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:
- To manually enable diagnostics or access the Log Analytics workspace, see Send Windows Virtual Desktop diagnostics to Log Analytics.
- To install the Log Analytics extension on a host manually, see Log Analytics virtual machine extension for Windows.
- To set up a new Log Analytics workspace, see Create a Log Analytics workspace in the Azure portal.
- To add or remove performance counters, see Configuring performance counters.
- To configure events for a Log Analytics workspace, see Collect Windows event log data sources with Log Analytics agent.
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.
- To add Performance counters, see Configuring Performance counters
- To add Windows Events, see Configuring Windows Event logs
Can't find a data point to help diagnose an issue? Send us feedback!
- To learn how to leave feedback, see Troubleshooting overview, feedback, and support for Windows Virtual Desktop.
- You can also leave feedback for Windows Virtual Desktop at the Windows Virtual Desktop feedback hub or our UserVoice forum.
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.