Debugging Azure Virtual Desktop errors/issues/network latency and bandwidth with an interactive Workbook

Correctly configured, Azure Virtual Desktop sends diagnostic data to a log analytics workspace (Azure Monitor). There are several logs containing data about the events in the backend:

Log Type Note
WVDAgentHealthStatus Details about the session hosts
WVDConnections All about connections from a user to a session host
WVDErrors Error message from different sources (client, RDGateway, Loadbalancer, …)
WVDFeeds Log about clients downloading information about the AVD resources
WVDHostRegistrations Logs if a host tries to register to a host pool
WVDManagement Log about administrative tasks
WVDCheckpoints Detailed information related to logins, errors, …
WVDConnectionNetworkData Network information (bandwidth and RTT)

To get the logs, configure at least the host pool to send log information to a log analytics workspace. You can do this on a host pool level -> Diagnostic settings -> Add diagnostic settings -> Select all Logs and target a log analytics workspace.

Alternatively, you can use WVDAdmin to do that (use version 1.7.25 or higher):

It will take a while before you can see the first data. The data can be queried with the KUSTO language or analyzed with custom workbooks. I prepared a workbook to dig into the data. Most visualizations are interactive. So you can drill down by selecting users, networks, agent versions, and more.

You can install the workbook directly as a template into your subscription: Install the workbook

After a while, the workbook is visible as a new template in: Log Analytics -> Workbooks -> Azure Virtual Desktop -> AVD - Deep-Insights

You can select the time frame and host pool from the drop-down list. The other drop-down lists are optional. Please ensure that you have included the essential errors from the error selector. Remember that not all errors are making issues (e.g., “ConnectionFailedClientDisconnected” occurs if a session goes in the disconnected mode while the users close its notebook).

Please let me know if you have ideas to extend the workbook.

Version Date Note
1.1 01/28/2022 Initial
1.2 02/17/2022 Include RTT and bandwidth (right now, host pool must be in the validation environment and diagnostic data must include NetworkData); see https://techcommunity.microsoft.com/t5/azure-virtual-desktop/collect-and-query-network-data-for-azure-virtual-desktop/m-p/3140397

Name changed to AVD - Deep-Insights
1.3 03/16/2022 Include Logon timing (GPO, FSLogix, Authentication, etc.)
1.4 04/14/2022 In Session Bandwidths & Latencies: The connection type is shown if RDP Short Path is used (Public, Private). See: https://docs.microsoft.com/en-us/azure/virtual-desktop/shortpath-public
1.5 05/03/2022 New visualization: Logon timing per day and category over the time
1.6 10/11/2022 New visualization: Connections over time, unhealthy session hosts, graphic performance
1.7 11/03/2022 Optimization for charts to show data over a large time frame
1.8 11/14/2022 A new tab “Resources”, to show orphan session hosts; Fix: Number of active and inactive sessions - timeselector was not correct
1.9 11/18/2022 A new tab “Resources”, to show orphan VMs (where the session host object is missing)
2.0 12/01/2022 Changed the description for the estimated available bandwidth

Deploy to Azure

Please click twice on create to accept the Microsoft Agreement of terms - Workbooks don’t generate costs