How to Collect Veeam ONE SMTP Logging
KB ID: | 3129 |
Product: | Veeam ONE |
Published: | 2020-03-20 |
Last Modified: | 2022-10-17 |
Purpose
SMTP logging is needed when investigating an issue with Veeam ONE Monitor emails, such as missed alarm notifications, unexpected email content, or other email-related problems. However, SMTP logging is not enabled by default and must be enabled temporarily to collect diagnostic information that can help identify potential SMTP communication issues.
Before performing the further steps, please ensure that SMTP server settings have been correctly configured within the Veeam ONE Monitor server settings.
Solution
Collect Veeam ONE SMTP Logging
- Create the following registry value on the machine where Veeam ONE Monitor Server is installed.
Key Location: HKLM\SOFTWARE\Veeam\Veeam ONE Monitor\Service\
Value Name: LogSmtpActivity
Value Type: DWORD (32-Bit) Value
Value Data: 1
PowerShell cmdlet to enable LogSmtpActivity:
New-ItemProperty -Path 'HKLM:\SOFTWARE\Veeam\Veeam ONE Monitor\Service\' -Name 'LogSmtpActivity' -Value '1' -PropertyType DWORD -Force
- Restart the Veeam ONE Monitoring Service
PowerShell cmdlet to restart the Veeam ONE Monitoring Service:
Restart-Service "Veeam ONE Monitoring Service"
- Trigger the email notification(s) to occur or wait for them to be sent (if scheduled).
- Collect Veeam ONE Monitor logs as documented in KB1862
- Disable SMTP Logging by changing the LogSmtpActivity value back to 0.
PowerShell cmdlet to disable LogSmtpActivity:
New-ItemProperty -Path 'HKLM:\SOFTWARE\Veeam\Veeam ONE Monitor\Service\' -Name 'LogSmtpActivity' -Value '0' -PropertyType DWORD -Force
- Restart the Veeam ONE Monitoring Service
PowerShell cmdlet to restart the Veeam ONE Monitoring Service:
Restart-Service "Veeam ONE Monitoring Service"
More information
When LogSmtpActivity is enabled, all SMTP activities will be recorded in log files named "VeeamDCS-MailActivity-<YYYY_MM_DD_HH_MM_SS>.log" and stored in the folder %ProgramData%\Veeam\Veeam ONE Monitor\Logs\. Each log file contains a full SMTP dialog with the SMTP server for each e-mail that is sent, including the status codes (220, 250, etc.) and HTML markup of the e-mail.
VeeamDCS-MailActivity Log example:
Connected to smtp://smtprelay.contonso.com:25/
S: 220 smtprelay.contonso.com ESMTP Postfix
C: EHLO [192.168.0.1]
S: 250-smtprelay.contonso.com
S: 250-PIPELINING
S: 250-SIZE 36700160
S: 250-ETRN
S: 250-STARTTLS
S: 250-ENHANCEDSTATUSCODES
S: 250-8BITMIME
S: 250 DSN
C: MAIL FROM:<VeeamOneServerMachine@contonso.com> SIZE=364
C: RCPT TO:<recepient@contonso.com>
S: 250 2.1.0 Ok
S: 250 2.1.5 Ok
C: DATA
S: 354 End data with <CR><LF>.<CR><LF>
C: From: VeeamOneServerMachine@contonso.com
C: Date: Tue, 11 Feb 2020 13:35:53 +0300
C: Subject: Veeam ONE Monitor
C: Message-Id: <WB128P30U9U4.IS9J8ZHC935G3@VeeamOneServerMachine>
C: To: recepient@contonso.com
C: MIME-Version: 1.0
C: Content-Type: text/html; charset=utf-8
C: Content-Id: <HNT78P30U9U4.094QYWZZHYV63@VeeamOneServerMachine>
C:
C: This is test e-mail message sent by Veeam ONE Monitor.
C: .
S: 250 2.0.0 Ok: queued as 804B240A1D
C: QUIT
S: 221 2.0.0 Bye
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.