Quantcast
Channel: Veeam Support Knowledge Base
Viewing all articles
Browse latest Browse all 4362

Granular Log Collection Guide for SOBR Capacity/Archive Tier Issues

$
0
0

Granular Log Collection Guide for SOBR Capacity/Archive Tier Issues

KB ID: 4463
Product: Veeam Backup & Replication | 12
Published: 2023-07-25
Last Modified: 2023-07-25

Purpose

This article documents an advanced granular log collection method designed to minimize the log bundle size when submitting Veeam Support cases for issues related the capacity tier or archive tier of a Scale-Out Backup Repository.

The standard method of collecting logs for these cases is to select all related components in the built-in log collection tool and perform bulk log collection. While simpler, that method can lead to large and unwieldy log bundles, especially in larger environments where logs must be collected from many component servers. In contrast, this article's advanced granular log collection method, while more involved, ensures the smallest log collection bundle size possible while providing all the information needed for a thorough support investigation.

Solution

Step 1: Identify the Servers Involved

Logs related to capacity/archive tiers issues are located on specific infrastructure components relevant to the issue. Before manually collecting logs, you need to determine where to find them.

The Veeam infrastructure components involved are:

Step 2: Locate the Logs

The default locationWhile uncommon, it is possible the log directory was changed, as documented in KB1825. for most logs are:

  • Windows: C:\ProgramData\Veeam\Backup
  • Linux: /var/log/VeeamBackup

On the Veeam Backup Server, the user-specific Veeam Backup & Replication Console logs are stored in the %LocalAppData% folder of the user account used to log in and administer the Veeam Backup & Replication console.

  • Console Logs: C:\Users\<user>\AppData\Local\Veeam\Backup

Step 3: Determine the Required Logs

The logs required for a case depend on the situation, below are two common situations with an explanation which logs should be collected.

Logs Required When Reproducing an Issue

Modify Log Retention Settings

When reproducing an issue in larger infrastructures, certain logs (e.g., Gateway logs) may grow rapidly, making it essential to ensure that logs are not overwritten before or after reproducing the issue. With this in mind, we advise implementing the following registry setting changes to alter the automatic log cleanup procedures.

Before creating the registry values below, check if they exist already. Take note of which ones existed and what they were set to so that after log collection is complete, you can know which ones to remove or revert to their previous setting.

Server: Veeam Backup Server
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: LogsArchivesMaxCount
Value Type: DWORD (32-bit) Value
Value Data: 25 

Server: Veeam Backup Server
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: MaxLogCount
Value Type: DWORD (32-bit) Value
Value Data: 25

Server: Associated Repository and Gateway Servers
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AgentMaxLogCount
Value Type: DWORD (32-bit) Value
Value Data: 50

Logs to Collect

Collect the following logs. For the individual log files, please also gather their generational archivese.g, 2023-05-21_Svc.VeeamBackup.zip.

Veeam Backup & Replication Operational Logs

These will be found only on the Veeam Backup Server.

  • C:\ProgramData\Veeam\Backup\Svc.VeeamBackup.log
  • C:\ProgramData\Veeam\Backup\RTS.ResourcesUsage.log
  • C:\ProgramData\Veeam\Backup\ResourceScan\*
Veeam Backup & Replication Console Logs

These will be found only on the Veeam Backup Server.

  • C:\ProgramData\Veeam\Backup\Satellites\*
Scale-Out Backup Repository Operation Logs

These may be found on the Veeam Backup Server, the repository servers, or the gateway servers.

  • C:\ProgramData\Veeam\Backup\SOBR_Offload_RepoSobrBackupsSobrAzureImmutable\*
  • C:\ProgramData\Veeam\Backup\SOBR_Archival_RepoSobrBackupsSobrAzureImmutable\*
  • C:\ProgramData\Veeam\Backup\Utils\*
    Including the rescan logs in the DatabaseResynchronizer subfolder.
  • C:\ProgramData\Veeam\Backup\EvacuateBackupsJob\*
  • C:\ProgramData\Veeam\Backup\System\Retention\*
Logs Required for Root Cause Analysis

Logs to Collect

When performing an in-depth root cause analysis, additional logs are needed to help identify interactions made by those who were connected to and managing the Veeam Backup & Replication software via either the Veeam Backup & Replication Console installed on the Veeam Backup Server or deployments of the Console on other machines.

Collect the following logs. For the individual log files, please also gather their generational archivese.g, 2023-05-21_Svc.VeeamBackup.zip.

Veeam Backup & Replication Operational Logs

These will be found only on the Veeam Backup Server.

  • C:\ProgramData\Veeam\Backup\Svc.VeeamBackup.log
  • C:\ProgramData\Veeam\Backup\RTS.ResourcesUsage.log
  • C:\ProgramData\Veeam\Backup\ResourceScan\*
Veeam Backup & Replication Console Logs

These will be found only on the Veeam Backup Server.

  • C:\ProgramData\Veeam\Backup\Satellites\*
Scale-Out Backup Repository Operation Logs

These may be found on the Veeam Backup Server, the repository servers, or the gateway servers.

  • C:\ProgramData\Veeam\Backup\SOBR_Offload_RepoSobrBackupsSobrAzureImmutable\*
  • C:\ProgramData\Veeam\Backup\SOBR_Archival_RepoSobrBackupsSobrAzureImmutable\*
  • C:\ProgramData\Veeam\Backup\Utils\*
    Including the rescan logs in the DatabaseResynchronizer subfolder.
  • C:\ProgramData\Veeam\Backup\EvacuateBackupsJob\*
  • C:\ProgramData\Veeam\Backup\System\Retention\*
Individual User Console Logs

These logs will be found on each machine where the Veeam Backup & Replication Console has been installed and used to connect to the Veeam Backup Server. This may require checking workstations where a person with access may have connected to the Veeam Backup Server using an installed copy of the Veeam Backup & Replication Console.

  • C:\Users\<username>\AppData\Local\Veeam\Backup\

Step 4: Structure the Manually Collected Logs

After manually collecting the logs, please structure the log bundle like so:

VeeamBackupLogs/
├─ <server_name>/
│ ├─ <user_name_1>/
│ │ ├─ AppData/
│ │ │ ├─ Local/
│ │ │ │ ├─ Veeam/
│ │ │ │ │ ├─ Backup/
│ ├─ <user_name_2>/
│ ├─ Backup/
│ │ ├─ EvacuateBackupsJob/
│ │ ├─ ResourceScan/
│ │ ├─ Satellites/
│ │ ├─ SOBR_Archival_<repository_name>/
│ │ ├─ SOBR_Offload_<repository_name>/
│ │ ├─ System/
│ │ ├─ Utils/
│ │ │ ├─ DatabaseResynchronizer/
│ │ ├─ RTS.ResourcesUsage.log
│ │ ├─ Svc.VeeamBackup.log
├─ <server_name>/
│ ├─ var/
│ │ ├─ log/
│ │ │ ├─ VeeamBackup/

Step 5: Attach the Collected Log Archive(s) to The Case

Review: KB4162: How to Attach Files to 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.

Viewing all articles
Browse latest Browse all 4362

Trending Articles