How to Change the settings related to Veeam Backup & Replication Log Files

KB ID:
1825
Product:
Veeam Backup & Replication
Version:
Any
Published:
Last Modified:
2020-05-20

Purpose

This article documents how to change the defaults for the following settings:

  1. The absolute log file directory from which all logs will be stored.
  2. Maximum size each log is allowed to reach before beginning a new log file.
  3. Number of archived logs to be kept before removal.
  4. The total size for a job’s logs to reach before Veeam will begin archiving (gzip) inactive logs to save space.
  5. Amount of logs that are archived per job.
  6. The size of an agent log file on sever with a proxy, repository or mount server role.
  7. Amount of the agent rollback files on sever with a proxy, repository or mount server role.
 Note: After making changes to these setting the Veeam server must be restarted to apply changes and ensure that previous log files are unlocked.

Solution

The following registry keys are used to manage log file location, file size and count:

* These values may need to be created if they are not present in the registry.  If the settings you currently have are default, then you will need to add these values as they will not inherently already exist.
 
*1. Default log directory location:

Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication on the server where the Veeam Backup & Replication console is installed
Type: String
Name: LogDirectory
Data: <Path>
Default: C:\ProgramData\Veeam\Backup

2. Maximum file size. New files are created when a file reaches the set max size. Example: Svc.VeeamBackup.log -> Svc.VeeamBackup_1.log
Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication on the server where the Veeam Backup & Replication console is installed
Type: DWORD
Name: MaxLogSize
Data: <value in KiB>
Default: 10240 (binary)

3. Maximum log count. Number of log generations to retain. Example: Svc.VeeamBackup_1.log, Svc.VeeamBackup_2.log, etc.
Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication on the server where the Veeam Backup & Replication console is installed
Type: DWORD
Name: MaxLogCount
Data: <numeric value>
Default: 10
 
*4. Total size of uncompressed logs (applies per job). 
Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication on the server where the Veeam Backup & Replication console is installed
Type: DWORD
Name: UncompressedLogsMaxTotalSize
Data: <value in KiB>
Default: 512000

*5. Total amount of archived generations of logs. Example: Svc.VeeamBackup.1.gz  Svc.VeeamBackup.2.gz 
Type: DWORD
Name: LogsArchivesMaxCount
Data: <numeric value>
Default: 10


For Windows:


*6. The size of an AGENT log file 
Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication  on the proxy in question.  
Type: DWORD
Name: AgentMaxLogSize
Data: in BYTES

*7. Amount of the AGENT rollback files.
Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication on the proxy in question.   
Type: DWORD
Name: AgentMaxLogCount
Data: <numeric value>


For Linux:


Note: Currently a hotfix is necessary to work with Linux hosts. Please download it by the link below.
  1. Download private fix.
  2. Go to "C:\Program Files\Veeam\Backup and Replication\Backup" folder on the Veeam Backup server.
  3. Rename existing veeamagent to veeamagent.old and veeamagent64 to veeamagent64.old
  4. From the archive copy veeamagent into "C:\Program Files\Veeam\Backup and Replication\Backup" folder on the Veeam Backup server.
  5. From the archive copy veeamagent64 into "C:\Program Files\Veeam\Backup and Replication\Backup" folder on the Veeam Backup server.
  6. Start all the Veeam services on the Veeam Backup server.
  7. Go to the Linux servers and update the settings related to Agent logs.

*6. The size of an agent log file.

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

*7. Amount of the agent rollback files

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

More Information

[[DOWNLOAD|DOWNLOAD PRIVATE FIX|https://www.veeam.com/download_add_packs/vmware-esx-backup/kb1825]]

MD5: e8f78a5ed051aad83e3ead2eeb2623d0
SHA-1: de6408d19deaf2a91ade96e2eec7e2b6fc622ab1

Please be aware that we’re making changes which will restrict access to product updates for users without an active contract.

OK

Rate the quality of this KB article: 
4 out of 5 based on 37 ratings

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:

Submit