Skip to content

Commit c446d52

Browse files
authored
Merge pull request #212659 from dknappettmsft/avd-troubleshooting-windows-client-logs
AVD added how to collect logs for Windows client
2 parents be9e060 + a90d4b7 commit c446d52

File tree

1 file changed

+46
-1
lines changed

1 file changed

+46
-1
lines changed

articles/virtual-desktop/troubleshoot-client.md

Lines changed: 46 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,51 @@ If that doesn't work, make sure your app group is associated with a workspace.
2727

2828
In this section you'll find troubleshooting guidance for the Remote Desktop client for Windows.
2929

30+
### Access client logs
31+
32+
You might need the client logs when investigating an issue.
33+
34+
To retrieve the client logs:
35+
36+
1. Ensure no sessions are active and the client process isn't running in the background by right-clicking on the **Remote Desktop** icon in the system tray and selecting **Disconnect all sessions**.
37+
1. Open **File Explorer**.
38+
1. Navigate to the **%temp%\DiagOutputDir\RdClientAutoTrace** folder.
39+
40+
Below you will find different methods used to read the client logs.
41+
42+
#### Event Viewer
43+
44+
1. Navigate to the Start menu, Control Panel, System and Security, and select **view event logs** under "Windows Tools".
45+
1. Once the **Event Viewer** is open, click the Action tab at the top and select **Open Saved Log...**.
46+
1. Navigate to the **%temp%\DiagOutputDir\RdClientAutoTrace** folder and select the log file you want to view.
47+
1. The **Event Viewer** dialog box will open requesting a response to which it will convert etl format to evtx format. Select **Yes**.
48+
1. In the **Open Saved Log** dialog box, you have the options to rename the log file and add a description. Select **Ok**.
49+
1. The **Event Viewer** dialog box will open asking to overwrite the log file. Select **Yes**. This will not overwrite your original etl log file but create a copy in evtx format.
50+
51+
#### Command-line
52+
53+
This method will enable you to convert the log file from etl format to either _csv_ or _xml_ format using the `tracerpt` command. Open the Command Prompt or PowerShell and run the following:
54+
55+
```
56+
tracerpt "<FilePath>.etl" -o "<OutputFilePath>.extension"
57+
```
58+
59+
**CSV example:**
60+
61+
```
62+
tracerpt "C:\Users\admin\AppData\Local\Temp\DiagOutputDir\RdClientAutoTrace\msrdcw_09-07-2022-15-48-44.etl" -o "C:\Users\admin\Desktop\LogFile.csv" -of csv
63+
```
64+
65+
If the `-of csv` parameter is omitted from the command above, it won't properly convert the file.
66+
67+
**XML example:**
68+
69+
```
70+
tracerpt "C:\Users\admin\AppData\Local\Temp\DiagOutputDir\RdClientAutoTrace\msrdcw_09-07-2022-15-48-44.etl" -o "C:\Users\admin\Desktop\LogFile.xml"
71+
```
72+
73+
The `-of xml` parameter is not necessary in this instance as the default output for the conversion is in _xml_ format.
74+
3075
### Remote Desktop client for Windows stops responding or cannot be opened
3176

3277
If the Remote Desktop client for Windows stops responding or cannot be opened, you may need to reset your client. Starting with version 1.2.790, you can reset the user data from the About page or using a command.
@@ -136,7 +181,7 @@ To resolve this issue, you'll need to either reduce the size of the browser wind
136181
## Next steps
137182

138183
- For an overview on troubleshooting Azure Virtual Desktop and the escalation tracks, see [Troubleshooting overview, feedback, and support](troubleshoot-set-up-overview.md).
139-
- To troubleshoot issues while creating a Azure Virtual Desktop environment and host pool in a Azure Virtual Desktop environment, see [Environment and host pool creation](troubleshoot-set-up-issues.md).
184+
- To troubleshoot issues while creating an Azure Virtual Desktop environment and host pool in an Azure Virtual Desktop environment, see [Environment and host pool creation](troubleshoot-set-up-issues.md).
140185
- To troubleshoot issues while configuring a virtual machine (VM) in Azure Virtual Desktop, see [Session host virtual machine configuration](troubleshoot-vm-configuration.md).
141186
- To troubleshoot issues related to the Azure Virtual Desktop agent or session connectivity, see [Troubleshoot common Azure Virtual Desktop Agent issues](troubleshoot-agent.md).
142187
- To troubleshoot issues when using PowerShell with Azure Virtual Desktop, see [Azure Virtual Desktop PowerShell](troubleshoot-powershell.md).

0 commit comments

Comments
 (0)