#1 Global Leader in Data Resilience

How to Change the Settings Related to Veeam Backup & Replication Log Files

KB ID: 1825
Product: Veeam Backup & Replication | 11 | 12 | 12.1 | 12.2 | 12.3
Veeam Cloud Connect | 11 | 12 | 12.2 | 12.3
Published: 2013-10-09
Last Modified: 2024-07-25
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 change settings regarding where log files are stored, how large an individual log file may become, and how many generations of log files are retained.

Solution

Log Files Stored on the Veeam Backup Server

The following registry values must be created on the server where Veeam Backup & Replication is installed.
The Veeam Backup Server must be rebooted after changing any log-related settings in the registry.

Expand sections below to view more information:

Log Directory Location
This registry value is not present by default and may need to be manually created.

Determines where log files created by Veeam Backup & Replication will be stored.

*If Veeam Backup Enterprise Manager (VBEM) is installed on the same server, the LogDirectory value for VBEM must also be configured to ensure logs are written to the expected directory.

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: LogDirectory
Value Type: String Value
Value Data: <path_on_server>
Default: C:\ProgramData\Veeam\Backup

Path requirements
  • The path provided must be to a folder on a drive of the Backup Server, and without the trailing slash.
  • The path cannot be a remote location or mapped network drive.
Some components are hardcoded to use the default log directory, and the LogDirectory value is ignored.
The following PowerShell script can be used to set the LogDirectory values on a Veeam Backup Server using a convenient folder section UI. Simply paste the script into an Administrative PowerShell console.
Function Get-Folder {
Add-Type -AssemblyName System.Windows.Forms
$folderBrowser = New-Object System.Windows.Forms.FolderBrowserDialog
$folderBrowser.Description = "Select the new log directory"
$folderBrowser.RootFolder = [System.Environment+SpecialFolder]::MyComputer
if ($folderBrowser.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {
$selectedPath = $folderBrowser.SelectedPath
return $selectedPath
}
exit
}
$logPath = Get-Folder
New-ItemProperty -Path 'HKLM:\SOFTWARE\Veeam\Veeam Backup and Replication\' -Name 'LogDirectory' -Value "$logPath" -PropertyType String -Force
New-ItemProperty -Path 'HKLM:\SOFTWARE\Veeam\Veeam Backup Reporting\' -Name 'LogDirectory' -Value "$logPath" -PropertyType String -Force
New-ItemProperty -Path 'HKLM:\SOFTWARE\Veeam\Veeam VSS HW Snapshot Provider\' -Name 'LogDirectory' -Value "$logPath" -PropertyType String -Force
Write-Host "The new log path will be:" $logPath
Maximum Individual Log File Size

A new file is created when a log file becomes larger than the specified value.

Example:
Svc.VeeamBackup.log -> Svc.VeeamBackup_1.log

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: MaxLogSize
Value Type: DWORD (32-Bit) Value
Value Data: <value in KiB>
Default: 10240 (Decimal)

Maximum Individual Log File Generations to Retain

As an individual log file grows larger than the maximum size a new generation of log files is created. This registry setting controls the maximum number of generations of log files to be retained.

Example: Svc.VeeamBackup_1.log, Svc.VeeamBackup_2.log, Svc.VeeamBackup_3.log, etc.

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: MaxLogCount
Value Type: DWORD (32-Bit) Value
Value Data: <##>
Default: 10 (Decimal)

Maximum Total Size of Uncompressed Logs per Job Folder
This registry value is not present by default and may need to be manually created.

When the total size of all uncompressed log files within a folder is greater than this value, all logs in the folder are compressed into an archive.

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: UncompressedLogsMaxTotalSize
Value Type: DWORD (32-Bit) Value
Value Data: <value in KiB>
Default: 512000 (Decimal)

Maximum Log Archive Generations to Retain
This registry value is not present by default and may need to be manually created.

An archive is created when the total size of uncompressed log files within a folder becomes larger than the maximum size. This setting controls how many generations of those archives are to be retained.

Example: Svc.VeeamBackup.1.gz  Svc.VeeamBackup.2.gz

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: LogsArchivesMaxCount
Value Type: DWORD (32-Bit) Value
Value Data: <##>
Default: 10 (Decimal)

Log Files on the Veeam Backup Enterprise Manager Server

The following registry values must be created on the server where Veeam Backup Enterprise Manager is installed.
The Veeam Backup Enterprise Manager must be rebooted after changing any log-related settings in the registry.

Expand sections below to view more information:

Log Directory Location
Veeam Backup Enterprise Manager (VBEM) shares components with Veeam Backup & Replication (VBR), as such, even on a server where only VBEM is installed, the LogDirectory value for VBR must set to ensure all logs go to the new log directory.
This registry value is not present by default and may need to be manually created.

Determines where log files created by Veeam Backup Enterprise Manager will be stored.

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup Reporting
Value Name: LogDirectory
Value Type: String Value
Value Data: <path_on_server>
Default: C:\ProgramData\Veeam\Backup

Path requirements
  • The path provided must be to a folder on a drive of the Backup Server, and without the trailing slash.
  • The path cannot be a remote location or mapped network drive.
The following PowerShell script will set the LogDirectory values on a Veeam Backup Enterprise Manager Server using a convenient folder section UI. Paste the script into an Administrative PowerShell console.
Function Get-Folder {
Add-Type -AssemblyName System.Windows.Forms
$folderBrowser = New-Object System.Windows.Forms.FolderBrowserDialog
$folderBrowser.Description = "Select the new log directory"
$folderBrowser.RootFolder = [System.Environment+SpecialFolder]::MyComputer
if ($folderBrowser.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {
$selectedPath = $folderBrowser.SelectedPath
return $selectedPath
}
exit
}
$logPath = Get-Folder
New-ItemProperty -Path 'HKLM:\SOFTWARE\Veeam\Veeam Backup and Replication\' -Name 'LogDirectory' -Value "$logPath" -PropertyType String -Force
New-ItemProperty -Path 'HKLM:\SOFTWARE\Veeam\Veeam Backup Reporting\' -Name 'LogDirectory' -Value "$logPath" -PropertyType String -Force
Maximum Individual Log File Size

A new file is created when a log file becomes larger than the specified value.

Example:
Svc.VeeamBES.log -> Svc.VeeamBES.1.log

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup Reporting
Value Name: MaxLogSize
Value Type: DWORD (32-Bit) Value
Value Data: <value in KiB>
Default: 10240 (Decimal)

Maximum Individual Log File Generations to Retain

As an individual log file grows larger than the maximum size a new generation of log files is created. This registry setting controls the maximum number of generations of log files to be retained. Once the maximum number of generations is reached, the oldest ones will be moved into generational archives (yyyy-mm-dd_Svc.VeeamBES.zip).

Example: Svc.VeeamBES.1.log, Svc.VeeamBES.2.log, Svc.VeeamBES.3.log, etc.

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup Reporting
Value Name: MaxLogCount
Value Type: DWORD (32-Bit) Value
Value Data: <##>
Default: 10 (Decimal)

Log Files Stored on Windows Component Servers

For example Proxies, Mount Servers, Gateway Servers, Repositories, WAN Accelerators, Tape Servers, etc.

The following registry values must be created on the Windows component server.
After changing any of the following settings the Windows component server itself must be rebooted.

Expand to view more information:

Log Directory Location
This registry value is not present by default and may need to be manually created.

Determines where log files created by Veeam Backup & Replication will be stored.

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: LogDirectory
Value Type: String Value
Value Data: <path_on_server>
Default: C:\ProgramData\Veeam\Backup

Path requirements
  • The path provided must be to a folder on a drive of the server, without the trailing slash. 
  • The path cannot be a remote location or mapped drive.
Maximum Individual Agent Log File Size
This registry value is not present by default and may need to be manually created.

A new file is created when a log file becomes larger than the specified value.

Example:
 Agent.DC.Source.DC.log -> Agent.DC.Source.DC.1.log

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AgentMaxLogSize
Value Type: DWORD (32-Bit) Value
Value Data: <value in Bytes>
Default: 15728640 (Decimal)

Note: The max agent log size is not precise. Sometimes, a log file may not rotate until a process thread is complete. There will be slight deviations from the maximum value set.

Maximum Individual Log Generations to Retain
This registry value is not present by default and may need to be manually created.

As an individual log file grows larger than the maximum size a new generation of log files is created. This registry setting controls the maximum number of generations of agent log files to be retained.

Example: Agent.DC.Source.DC.1.log, Agent.DC.Source.DC.2.log,Agent.DC.Source.DC.3.log etc.

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AgentMaxLogCount
Value Type: DWORD (32-Bit) Value
Value Data: <##>
Default: 10 (Decimal)

Log Files Stored on Linux Component Servers

For example Proxies, Mount Servers, Gateway Servers, Repositories

Agent Log Controls

The settings in this section control log files with filenames containing the word "Agent" that are written by the veeamagent process.
(Example:  Agent.<jobname>.<vmname>.Target.log )

The following settings must be entered within the /etc/VeeamAgentConfig file on the Linux component server.

Expand to view more information:

Maximum Individual Agent Log File Size
This value is not present in the configuration file by default and may need to be manually created.
If the /etc/VeeamAgentConfig file is not present on the Linux machine, you must first create it.

A new file is created when a log file becomes larger than the specified value.

Example: Agent.DC.Source.DC.log -> Agent.DC.Source.DC.1.log

Config File Location: /etc/VeeamAgentConfig
Entry Name: AgentMaxLogSize
Data: in BYTES
Default: 15728640

Example: AgentMaxLogSize=67108864‬

Note: The max agent log size is not precise. Sometimes, a log file may not rotate until a process thread is complete. There will be slight deviations from the maximum value set.

Maximum Individual Agent Log Generations to Retain
This value is not present in the configuration file by default and may need to be manually created.
If the /etc/VeeamAgentConfig file is not present on the Linux machine, you must first create it.


As an individual log file grows larger than the maximum size, a new generation of log files is created. This setting controls the maximum number of generations of agent log files to be retained.

Example: Agent.DC.Source.DC.1.log, Agent.DC.Source.DC.2.log,Agent.DC.Source.DC.3.log, etc.

Config File Location: /etc/VeeamAgentConfig 
Entry Name: AgentMaxLogCount
Data: <numeric value>
Default: 10

Example: AgentMaxLogCount=32

Service Log Controls

The settings in this section control the log directory and the log files of the services deployed on the Linux server.
(Example:  VeeamTransportSvc.log)

The following settings are located within the /opt/veeam/transport/VeeamTransportConfig file on the Linux component server.

Note: If the /opt/veeam/transport/VeeamTransportConfig file is not present, the Persistent Veeam Data Movers were not deployed on the Linux Machine.

Expand to view more information:

Log Directory

This value controls the location where all log files will be written when the Linux machine is using persistent Veeam Data Movers.

Entry Name: BaseLogDirectory
Default: /var/log/VeeamBackup

Maximum Service Log File Size

A new file is created when a service log file becomes larger than the specified value.

Example:
 VeeamTransportSvc.log >> VeeamTransportSvc.1.log.gz

Entry Name: MaxLogSize
Default: 15728640

The value is defined in bytes and has a minimum value of 1048576.

Maximum Individual Service Log File Generations to Retain

As an individual service log file grows larger than the maximum size a new generation of log files is created. This registry setting controls the maximum number of those generations to be retained.

Example: VeeamTransportSvc.1.log.gz,VeeamTransportSvc.2.log.gz,VeeamTransportSvc.3.log.gz

Entry Name: MaxLogCount
Default: 10

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 hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
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 hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
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.