- Veeam Support Knowledge Base
- How to Use VSSTrace to Collect VSS Diagnostic Logging
How to Use VSSTrace to Collect VSS Diagnostic Logging
| KB ID: | 3164 |
| Product: |
Veeam Backup & Replication Veeam Agent for Microsoft Windows Veeam Cloud Connect |
| Version: | Any |
| Published: | 2020-04-30 |
| Last Modified: | 2024-11-14 |
Get weekly article updates
Cheers for trusting us with the spot in your mailbox!
Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest
Oops! Something went wrong.
Please, try again later.
Challenge
This article explains how to collect additional VSS diagnostic data with the VSSTrace tool, a Microsoft Windows Software Development Kit (SDK) component.
Cause
Veeam products use Microsoft Volume Shadow Copy Service (VSS) for various tasks. Sometimes it is necessary to go through the underlying VSS processes to check what method experiences issues.
VSSTrace can trace VSS applications and get a detailed output containing possible VSS error codes and events on Windows 7 and later. For details, see this Microsoft article.
VSSTrace can trace VSS applications and get a detailed output containing possible VSS error codes and events on Windows 7 and later. For details, see this Microsoft article.
Solution
Here are the steps on how to collect VSSTrace diagnostic data:
- Download the VSSTrace tool.
- Save the file on the machine where the VSS task failed.
For example, C:\temp\vsstrace\ - Run Command Prompt as Administrator.
- Navigate to the folder where the VSSTrace tool was saved in Step 2.
- Launch VSSTrace with the following command parameters:
vsstrace +f 0xffff -l 255 -o vsstrace.log
The Logging Level must be 255. For details about additional log levels, see this Microsoft Enterprise Platforms Support article.
- Start the backup job.
- Once the backup job fails, press [Ctrl + C] to stop log collection. The output file can be found in the folder where VSSTrace was saved in Step 2.
If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.