#1 Global Leader in Data Resilience
#1 Global Leader in Data Resilience
BACK TO KB LIST

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
mailbox
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, 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.

Solution

Here are the steps on how to collect VSSTrace diagnostic data:

  1. Download the VSSTrace tool.
  2. Save the file on the machine where the VSS task failed.
    For example, C:\temp\vsstrace\
  3. Run Command Prompt as Administrator.
  4. Navigate to the folder where the VSSTrace tool was saved in Step 2.
  5. 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.
 

  1. Start the backup job.
  2. 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.
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.

Spelling error in text

Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case
Veeam Backup & Replication
Veeam Data Cloud for Microsoft 365
Veeam Data Cloud for Microsoft Entra ID
Veeam Data Cloud for Salesforce
Veeam Data Cloud for Microsoft Azure
Veeam Data Cloud Vault
Veeam Backup for Microsoft 365
Veeam Backup for Microsoft Entra ID
Veeam Backup for Salesforce
Veeam ONE
Veeam Service Provider Console
Veeam Agent for Microsoft Windows
Veeam Agent for Linux
Veeam Backup for Nutanix AHV
Veeam Backup for AWS
Veeam Backup for Microsoft Azure
Veeam Backup for Google Cloud
Veeam Backup for Oracle Linux Virtualization Manager and Red Hat Virtualization
Veeam Management Pack for Microsoft System Center
Veeam Recovery Orchestrator
Veeam Agent for Mac
Veeam Agent for IBM AIX
Veeam Agent for Oracle Solaris
Veeam Cloud Connect
Veeam Kasten for Kubernetes
By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
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
Start using Veeam:
Download the product
&
Activate the license key
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.