TRY NOW
book meeting
BACK TO KB LIST

How to Collect Guest Processing Log Files

KB ID: 1789
Product: Veeam Backup & Replication
Veeam Backup for Nutanix AHV
Veeam Plug-In for Proxmox VE
Veeam Plug-in for Scale Computing HyperCore
Published: 2013-07-08
Last Modified: 2026-06-11
Languages: JP
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.

Purpose

This article documents how to locate and gather guest-level log files associated with Application-Aware Processing or VM Guest OS File Indexing that occurs with Veeam Backup & Replication VM backup jobs. While investigating issues related to Guest Processing, additional logs must be collected from the Guest OS of the VM that is failing either task.

Note: These logs are NOT automatically captured by the built-in Support Wizard.

Solution

If Application-Aware Processing was disabled during internal troubleshooting, please enable Application-Aware Processing and rerun the job to update the log files within the Guest OS.

Collecting Logs from Windows-based Guest

Guest Logs may be collected either by using the automated PowerShell script in this article or by manually collecting files from within the guest as documented in the Manual Guest Processing Log Collection section below.

Quick Start Automated Guest OS Log Collection

For VM Guests with an active internet connection, open an Administrative PowerShell Terminal in the Guest OS. Run the following script to download the collection script to %temp%, then execute it.

Invoke-WebRequest https://raw.githubusercontent.com/VeeamHub/powershell/master/BR-Collect-GuestLogs/Collect-GuestLogs.ps1 -OutFile $Env:Temp\Collect-GuestLogs.ps1
PowerShell.exe -ExecutionPolicy ByPass -File $env:temp\Collect-GuestLogs.ps1

Automated Guest Log Collection

A PowerShell script has been created by Veeam Support to simplify the Guest OS Log Collection process.

Details regarding this script can be found here: VeeamHUB > BR-Collect-GuestLogs

Manual Guest Processing Log Collection

The following actions are to be performed within the Guest OS of the VM that is being investigated. Please note that no Veeam Backup & Replication task should be running against the guest in question during this collection process, as that will interfere with the accuracy of the information.

  1. Navigate to the folder: 
    %programdata%\Veeam\Backup\
  2. Collect files with the following base name:
    • VeeamGuestHelper
    • VeeamGuestIndexer
    • VeeamVixProxy
    • VeeamVssSupport
  3. Open an elevated command prompt and run the following commands:
vssadmin list writers > C:\temp\vsswriters.txt
vssadmin list providers > C:\temp\vssproviders.txt
vssadmin list shadows > C:\temp\vssshadows.txt
vssadmin list shadowstorage > C:\temp\vssshadowstorage.txt
  1. For Hyper-V VMs: Export Windows Event Logs from the Guest OS as shown in KB1873.
  2. Bundle the logs collected in steps 2-4 into a compressed file (zip, 7z, or rar), and attach them to your case.
For information about attaching files to a support case, please review KB4162

Collecting Logs from Linux-based Guest

The following action is to be performed within the Guest OS of the VM that is being investigated. Please note that no Veeam Backup & Replication task should be running against the guest in question during this collection process, as that will interfere with the accuracy of the information.

  1. Collect logs from the following directories: 
    • /var/log/VeeamBackup/
    • /var/log/veeam/
    • /tmp/VeeamBackup/
  2. Bundle the collected logs into a compressed file (tar.gz, zip, 7z, or rar), and attach them to your case.
For information about attaching files to a support case, please review KB4162

More Information

Related Articles

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.

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