Troubleshoot Azure Virtual Desktop Insights

This article presents known issues and solutions for common problems in Azure Virtual Desktop Insights.

Important

The Log Analytics Agent is currently being deprecated. If you use the Log Analytics Agent for Azure Virtual Desktop support, you'll eventually need to migrate to the Azure Monitor Agent by August 31, 2024.

Issues with configuration and setup

If the configuration workbook isn't working properly to automate the 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 the following common solutions:

  • First, make sure you've set up correctly with the configuration workbook as described in Use Azure Virtual Desktop Insights 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 and contact the resource owners to request missing permissions. Anyone monitoring Azure Virtual Desktop requires the following permissions:

    • Read access to the Azure resource groups that hold your Azure Virtual Desktop resources.
    • Read access to the subscription's resource groups that hold your Azure Virtual Desktop session hosts.
    • Read access to whichever Log Analytics workspaces you're using.
  • You might need to open outgoing ports in your server's firewall to allow Azure Monitor to send data to the portal. For more information, see Firewall requirements.

  • If you're not seeing data from recent activity, you might need to wait 15 minutes and refresh the feed. Azure Monitor has a 15-minute latency period for populating log data. For more information, see Log data ingestion time in Azure Monitor.

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

I want to customize Azure Virtual Desktop Insights

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

By design, custom Workbook templates won't 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 in the Azure Virtual Desktop Insights glossary.

The data I need isn't available

If this article doesn't have the data point you need to resolve an issue, you can send us feedback at the following places:

Known issues and limitations

The following are issues and limitations we're aware of and working to fix:

  • To save favorite settings, you have to save a custom template of the workbook. Custom templates don't automatically adopt updates from the product group.
  • The configuration workbook sometimes show "query failed" errors when loading your selections. Refresh the query and reenter your selection if needed. The error should resolve itself.
  • Some error messages aren't phrased in a user-friendly way, and not all error messages are described in the documentation.
  • The total session performance counter can overcount sessions by a small number and your total sessions might appear to exceed your Max Sessions limit.
  • The available session count doesn't reflect scaling policies on the host pool.
  • Do you see contradicting or unexpected connection times? While rare, a connection's completion event can go missing and affect some visuals and metrics.
  • Time to connect includes the time it takes users to enter their credentials; this correlates to the experience but can show false peaks in some cases.

More information