https://login.veeam.com/en/oauth?client_id=nXojRrypJ8&redirect_uri=https%3A%2F%2Fwww.veeam.com%2Fservices%2Fauthentication%2Fredirect_url&response_type=code&scope=profile&state=eyJmaW5hbFJlZGlyZWN0TG9jYXRpb24iOiJodHRwczovL3d3dy52ZWVhbS5jb20va2IzMTY0IiwiaGFzaCI6IjZjOTY1MzRkLWI1MmMtNDVmYi1iYzMwLTcwMWJjMWY4YTkzZCJ9
1-800-691-1991 | 9am - 8pm ET
EN

How to collect VSS trace

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).
KB ID:
3164
Product:
Veeam Agent for Microsoft Windows, Veeam Backup & Replication, Veeam Cloud Connect
Version:
Any
Published:
2020-04-30
Last Modified:
2020-08-13
Please rate how helpful this article was to you:
5 out of 5 based on 1 ratings
Thank you for helping us improve!
An error occurred during voting. Please try again later.

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

Knowledge base content request
By submitting, you agree that your personal data will be managed by Veeam in accordance with the Privacy Policy.
Your report was sent to the responsible team. Our representative will contact you by email you provided.
We're working on it please try again later