Silencing a vSAN health check
search cancel

Silencing a vSAN health check

book

Article ID: 326925

calendar_today

Updated On:

Products

VMware vSAN

Issue/Introduction

This article explains how to silence a vSAN health check.

Q: When do I need to silence a vSAN health check?
In certain cases, you might want to ignore the results of certain health checks to avoid false alarms or known issues with your environment.

Q: What happens when a vSAN health check is silenced?
After you silence the health check, vSAN ignores that health check result and marks the health status as 'skipped'. It does not trigger any alarms. If a health check category contains only green and skipped health checks, the overall status of the category is green.

Environment

VMware vSAN 8.0.x
VMware vSAN 7.0.x
VMware vSAN 6.x
VMware vSAN 6.6.x

Resolution

To silence a vSAN health check, use one of the following methods:

From the UI
  • Go to the alert that you want to silence, on the right side under the tab "Result" you should see a Silence Alert option:
image.png
  • Click on Silence Alert and then click YES on the prompt message. 
  • When you do a retest it will show as skipped (grey symbol)
image.png
  • If you want to restore it, click on the alert and press the "Restore Alert" option:
image.png

RVC commands
  1. Open a SSH session to the vCenter Appliance and log in as root
  2. Log into RVC with "rvc localhost" if still using [email protected] otherwise log in as rvc administrator@<domain>.local@localhost
  3. To get the current silent health check list for the cluster, use the following command:
vsan.health.silent_health_check_status <clusterPath>

image.png
  • With this command you can see the current status of the alerts and gather the Health Check ID that is needed to silent the alert. 
  • To silent a health check use the following command:
vsan.health.silent_health_check_configure -a <clusterPath> <healthCheckId>

image.png
  • To restore a health check use the following command: 
vsan.health.silent_health_check_configure -r <clusterPath> <healthCheckId>

image.png


vSAN Management APIs
Use the following APIs to silence vSAN alarms and see the list of silent alerts.
  • To check the alerts that are already silent you can use the GetVsanClusterSilentChecks(cluster)API

image.png
  • To silence an alert you can use the following API: SetVsanClusterSilentChecks(cluster, addSilentChecks, removeSilentChecks)

image.png

Additional Information