Enable alert in vCenter for vSAN checksum errors detected in the host logs

Products

• VMware vSAN
• VMware vCenter Server

Issue/Introduction

This article assists users with creating custom alarms for the below vSAN checksum errors detected in the host logs as they can cause issues with VM vMotions, backups, & snapshots

• vSAN detected an unrecoverable medium or checksum error
• vSAN detected and fixed a medium or checksum error

VMware by Broadcom highly recommends configuring these alerts in vCenter to be notified when checksum errors are identified by vSAN in the host logs.

Environment

VMware vSAN (All Versions)
VMware vCenter (All Versions)

Resolution

Steps for creating these custom alarms:

In this example we're going to use "vSAN detected an unrecoverable medium or checksum error"

1. In vCenter, navigate to the "Alarm Definitions", by selecting your vCenter object > Configure > Alarm Definitions > Add.
   
   
   
2. Set Alarm Name to [Action Required] vSAN detected an unrecoverable medium or checksum error, Description vSAN detected an object with a component impacted by checksum errors and set Target Type to "Hosts" and then click Next
   
   
   
3. Type checksum in the IF field via Alarm Rule 1 to list all the checksum options 
   
   
   
4. Select "vSAN detected an unrecoverable medium or checksum error", set "Trigger the alarm and" to "Show as Critical", click the toggle switch for "Send email notifications" and fill in the email address of the administrators to be notified then click Next
   
   
   
5. Leave the reset rule set to default, which is off and click Next
   
   
   
6. Review the information, ensure "Enable this alarm" is toggled on and then click "Create"
   
   
   
7. Repeat steps 1-6 to create the alert for "vSAN detected and fixed a medium or checksum error"
   
   
8. If checksum alerts are triggered collect complete cluster logs, open a case with vSAN Support, and upload the logs to the case for further assistance.