#1 Global Leader in Data Protection & Ransomware Recovery

Veeam Cloud Connect - Compiling Provider/Tenant Logs for Support Cases 

KB ID: 2096
Product: Veeam Backup & Replication
Veeam Cloud Connect
Published: 2016-02-09
Last Modified: 2024-02-13
Languages: IT
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.

Veeam Service Provider Console 8 New Feature
Starting in Veeam Service Provider Console 8, it is now possible for Service Providers to create a support case from within the Veeam Service Provider Console console. This new feature also includes automatic log collection during case creation.

Purpose

Given the additional complexity of Cloud Connect compared with standalone installations of Backup & Replication, additional logging and information is needed to expedite cases with our Cloud Connect teams whenever feasible. All information should be obtained whether you are submitting an issue as a Tenant or a Service Provider .

Solution

Infrastructure Information

Include the following information:

  • Provider Name:
  • Tenant Name:
  • Job Type that is having issues:
  • Job Name that is having problems:
  • Tenant Public IP:

*Please document the public IP of the Tenant Veeam Server connected to the cloud gateway. Having this information will help identify the connection in the Cloud Gateway logs. You can identify this by using a utility such as http://www.whatsmyip.org/

Logs From Tenant's Environment

To ensure that the most relevant logs are present in the latest logs. Reproduce the error (if applicable), and then collect the tenant's Veeam Backup & Replication logs.

Collecting Logs from Tenant Environment

  • For failing jobs:
    Export logs for the job (backup, backup copy, or replication) that is having an issue.
tenant logs
  • For restores and replica failovers:
    Export a log bundle for the backup or replication job (as above) and manually collect logs from the following directories on the tenant's Veeam Backup server. (%ProgramData%\Veeam\Backup\)
    • Entire "CloudConnect" directory (if it exists)
    • Entire directory with the name of the VM that was restored or replicated

Logs from Service Provider's Environment

After reproducing the error (if applicable), collect and submit provider-side logs for the job using the instructions below.

Log Collection Scopes

Tenant-Specific Log Collection

New feature starting in Veeam Cloud Connect 12.1.
For issues involving a single tenant, the Export-VBRLogs PowerShell cmdlet can be used to export logs for a specific tenant.

Consider the following example script:

#Adjustable Parameters
$TenantName = "Tenant"
$DaysPast = 7
$ExportFolder = "C:\Temp\"

#Collect Logs Using the Provided Parameters
Export-VBRLogs -Tenant (Get-VBRCloudTenant -Name $TenantName) -FolderPath $ExportFolder -LastDays $DaysPast -Compress

System-Wide Log Collection

Option 1: Use Built-In Wizard Driven Log Generator

For providers with newly configured infrastructure or a few tenants, use the built-in log generator tool to gather logs from all managed servers related to the issue. Collecting logs from cloud gateways, repositories, and other relevant infrastructure in addition to the backup server is crucial.

Service Provider Logs
Specify the component logs for all servers and specify only the last 2-3 days. 
Log Date Range
Option 2: Manual Log Collection

Providers with many tenants can use the built-in log collection tool but may find it produces a large (multi-GB) log bundle. As an alternate option, Providers may choose to manually collect logs using the following information:

Tip: It's best to save the collected information in a .zip file with an identifiable name, such as "<tenant_name>-ProviderLogs.zip"

Some listed files may not be present if they do not apply to your issue, but ensure you look at the correct server for each directory or filename. Some files will have several rotations, and the oldest files will be archived as .zip or .gz.

On Veeam Cloud Connect Server:

  • Collect these files in the root of %ProgramData%\Veeam\Backup\
    • Svc.VeeamBackup* (filenames beginning with "Svc.VeeamBackup")
    • Zip files named "<date stamp>_Svc.VeeamBackup"
    • CloudAppliance*
    • RTS.ResourcesUsage.log
    • In rare cases, other files in this directory may be relevant, so including anything with a recent modification date is prudent.
  • Collect the contents of these folders :
    • %ProgramData%\Veeam\Backup\Console\
      (if using a remote console, collect from that machine as well)
    • %ProgramData%\Veeam\Backup\CloudConnect\
    • %ProgramData%\Veeam\Backup\CloudConnectService\<tenant_name>\
    • %ProgramData%\Veeam\Backup\CloudConnectService\
      (excluding subfolders for other tenants)
    • %programdata%\veeam\backup\Utils
    • %programdata%\veeam\backup\ResourceScan
    • %programdata%\veeam\backup\RegistryOptions

On Cloud Gateway Servers :

  • Collect files matching this nomenclature:
    • %ProgramData%\Veeam\Backup\Svc.VeeamGateSvc*

WAN Accelerator (if applicable):

  • Collect files matching this nomenclature:
    • %ProgramData%\Veeam\Backup\Svc.VeeamWANSvc*.log

Repository Servers (for backup and backup copy jobs) :

Check which server is listed as the Host for the Repository in the console (Backup Infrastructure > Backup Repositories).

  • Windows Repository
    Collect the entire content of these folders:
    • %ProgramData%\Veeam\Backup\CloudConnectService\<tenant_name>\
    • %ProgramData%\Veeam\Backup\CloudConnectService\ (excluding subfolders for other tenants)
  • Linux Repository
    Collect the entire content of these folders:
    • /var/log/VeeamBackup/CloudConnectService_<tenant_name>_* (may be multiple directories)

Note: Logs from Network Extension Appliances are automatically copied to their controlling Veeam Backup & Replication server, so in most cases, it is not necessary to gather logging from these appliances manually.

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

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.

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