vSphere ESXi Datastore Monitoring

Monitor your ESXi Datastores with a variety of checks including Provisioning status, Disk usage, Read/Write command monitoring and drive type/state. This Host Template includes support for VMware vMotion, so you can keep monitoring Datastores even if they are moved between Datacenters with no change to your Opsview configuration.

See all of the Opsview's virtualization monitoring solutions at VMware Monitoring.

This Host Template includes the following Service Checks:

Service Check Name	Description	Default Thresholds (Warning, Critical)	UOM
vSphere - Datastore - Provisioning	The current provisioning status of the datastore - values over 100% indicate that the datastore is over-provisioned.	provisioned=100,120	%
vSphere - Datastore - Disk Usage	The current datastore disk usage.	disk_usage=70,90	%
vSphere - Datastore - Summary	The state of the datastore and the drive type.	N/A	N/A

Usage Instructions

vMotion Support

To allow for vMotion support (moving Datastores between Datacenters without having to update your Host details), you must use the vCenter Credentials Variable listed in Step 2. Additionally, all Hosts utilized in vMotion must share login credentials to allow Opsview to maintain monitoring. The ESXi Host Name is optional if using vCenter Credentials.

When using vMotion, the ESXi Host containing the requested resource can be found automatically without needing to specify the Host the resource is on. However, this automatic retrieval of the Host will extend the runtime of the service checks and if performance is a concern, the Opsview Host configuration should be updated with the correct ESXi Host details.

Providing the vCenter Credentials variable will also allow for enhanced error handling when carrying out Service Checks.

Step 1: Add this Host Template

Add the OS - VMware vSphere ESXi Datastore Host Template to your Opsview Monitor host. If the resource you're monitoring has no hostname or public IP, then open the Advanced settings pane and change Host Check Command to Always assumed to be UP.

For more information, refer to Opsview Knowledge Center - Adding Host Templates to Hosts.

Step 2: Add and configure variables required for this Host Template

The Service Checks in this Host Template use the following variables, and they will be added to your Opsview Monitor instance when you import the Opspack:

VSPHERE_ESXI_DATASTORE_NAME

Parameter	Position in Variable	Name	Description
Opsview UI Only	Value	ESXi Datastore Display Name	Display Name for Datastore Service Checks
--esxi-datastore-name	Arg1	ESXi Datastore Name	Name of the ESXi Datastore

VSPHERE_ESXI_CREDENTIALS

This variable is optional but either 'VSPHERE_ESXI_CREDENTIALS' or 'VSPHERE_VC_CREDENTIALS' needs to be set.

Parameter	Position in Variable	Name	Description
--esxi-username	Arg1	ESXi Username	Username for the ESXi Host
--esxi-password	Arg2	ESXi Password	Password for the ESXi Host

VSPHERE_ESXI_HOST_NAME

Parameter	Position in Variable	Name	Description
Opsview UI Only	Value	ESXi Host Display Name	Display Name for ESXi Host Service Checks
--esxi-hostname	Arg1	ESXi Host Name	Name of the ESXi Host

VSPHERE_VC_CREDENTIALS

This variable is optional but either 'VSPHERE_ESXI_CREDENTIALS' or 'VSPHERE_VC_CREDENTIALS' needs to be set. Setting this variable allows for enhanced error handling when carrying out ESXi Service Checks.

Parameter	Position in Variable	Name	Description
--vcenter-username	Arg1	vCenter Username	Username for vCenter instance
--vcenter-password	Arg2	vCenter Password	Password for vCenter instance
--vcenter-server	Arg3	vCenter Instance Name	Name of the vCenter instance

For more information, refer to Opsview Knowledge Center - Adding Variables to Hosts.

For mode-specific help, run the plugin with the -h -m <mode> flags. This will list the required and optional Variable Arguments for that mode. The appropriate mode for each Service Check is listed here:

Service Check Name	Mode
vSphere - Datastore - Provisioning	`ESXiDatastore.Provision`
vSphere - Datastore - Disk Usage	`ESXiDatastore.Usage`
vSphere - Datastore - Summary	`ESXiDatastore.Summary`

SSL Certificates

Additionally, you can use the following variable to pass in your SSL certificates for use when connecting to the service provider to gather metrics:

VSPHERE_CERTIFICATES

Parameter	Position in Variable	Name	Description
--ca-path	Arg1	CA Certificate Path	Path to the CA Certificate
--client-cert	Arg2	Client Certificate Path	Path to the Client Certificate
--client-key	Arg3	Client Key Path	Path to the Client Key