How to collect VSS trace

KB ID: 3164
Product: Veeam Agent for Microsoft Windows
Veeam Backup & Replication
Veeam Cloud Connect
Version: Any
Published: 2020-04-30
Last Modified: 2021-03-29
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

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

error icon

Oops! Something went wrong.

Please try again later.

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).
Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please try again later.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please try again later.