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

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:
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
2.1 12/09/2022 Added orphan disks and orphan nics to the “Resources” tab (note: All orphand devices will also shown and could be removed in Hydra for Azure Virtual Desktop, version (comming soon))
2.2 02/02/2023 Added “Water Markings” to query session information by the feature WaterMarking
2.3 02/20/2023 Added “Unresponding AVD Agents” in the tab “Resources” to identify running VM with a non responding AVD agent
2.4 02/21/2023 Added new tab “FSLogix” to show the size, usage and free space of the FSLogix profiles
2.5 03/08/2023 Fix in the time selector; allow to selecte multiple host pools; show active sessions with user name and started desktop/remote app
2.6 03/31/2023 Add: Show office container size and usage (ODFC) in the FSLogix tab (additional to the profile container)
2.7 07/01/2023 Fix/Workaround: VHDFreeSpace is stored as text in MByte and not in GByte if the value is less then 1 GByte
2.8 10/13/2023 Add: Show the last heart beat time in the Orphan session hosts view and warns, if the heart beat is longer then 90 days ago

Deploy to Azure

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