How to collect VSS trace

KB ID:
3164
Product:
Veeam Backup & Replication;Veeam Cloud Connect;Veeam Agent for Microsoft Windows
Version:
Any
Published:
Last Modified:
2020-06-30

Challenge

This article explains how to collect additional VSS diagnostic data with the VSSTrace tool that is a component of the Microsoft Windows Software Development Kit (SDK).

Cause

Veeam products use Microsoft Volume Shadow Copy Service (VSS) for a variety of tasks. Sometimes it is necessary to go through the underlying VSS processes to check what method experiences issues.

VSSTrace can be used to trace VSS applications and get a detailed output that contains possible VSS error codes and events on Windows 7 and later. For details, see this Microsoft article.

Solution

Here are the steps on tow to collect diagnostic data:

  1. Download the VSSTrace tool.
  2. Save the file on the Veeam Agent machine. For example, C:\Users\Username\Downloads.
  3. Run Command Prompt as Administrator.
  4. Change directory to the folder with the VSSTrace tool. For example, cd C:\Users\Username\Downloads
  5. Launch the VSSTrace tool with the following command:
    vsstrace +f 0xffff -l 255 -o vsstrace.log
    Mind that Log Level must be 255. For details about additional log levels, see this Microsoft Enterprise Platforms Support article.
  6. Start the backup job
  7. Once the backup job fails, press [Ctrl + C] to stop logs collection. The output file can be found in the folder where VSSTrace is saved (Step 2).

Rate the quality of this KB article: 
4.8 out of 5 based on 3 ratings

Couldn't find what you were looking for?

Below you can submit an idea for a new knowledge base article.

Report a typo on this page:

Please select a spelling error or a typo on this page with your mouse and press CTRL + Enter to report this mistake to us. Thank you!

Spelling error in text:

Submit