The Service Map for APM is here!

vSphere

Agent Check Agent Check

Supported OS: Linux Mac OS Windows

Vsphere Graph

Overview

This check collects resource usage metrics from your vSphere cluster-CPU, disk, memory, and network usage. It also watches your vCenter server for events and emits them to Datadog.

Setup

Installation

The vSphere check is included in the Datadog Agent package, so you don’t need to install anything else on your vCenter server.

Configuration

In the Administration section of vCenter, add a read-only user called datadog-readonly.

Then, edit the vsphere.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample vsphere.d/conf.yaml for all available configuration options:

init_config:

instances:
  - name: main-vcenter # how metrics are tagged, i.e. 'vcenter_server:main-vcenter'
    host: <VCENTER_HOSTNAME>          # e.g. myvcenter.example.com
    username: <USER_YOU_JUST_CREATED> # e.g. datadog-readonly@vsphere.local
    password: <PASSWORD>

Restart the Agent to start sending vSphere metrics and events to Datadog.

Note: The Datadog Agent doesn’t need to be on the same server as the vSphere appliance software. An Agent with the vSphere check enabled can be set up -no matter what OS it’s running on- to point to a vSphere appliance server. Update your <VCENTER_HOSTNAME> accordingly.

Compatibility

Starting with version 3.3.0 of the check, shipped in Agent version 6.5.0/5.27.0, a new optional parameter collection_level is available to select which metrics to collect from vCenter, and the optional parameter all_metrics was deprecated. Along with this change, the names of the metrics sent to Datadog by the integration have changed, with the addition of a suffix specifying the rollup type of the metric exposed by vCenter (.avg, .sum, etc.).

By default, starting with version 3.3.0, the collection_level is set to 1 and the new metric names with the additional suffix are sent by the integration.

The following scenarios are possible when using the vSphere integration:
1. You never used the integration before, and you just installed an Agent with version 6.5.0+ / 5.27.0+. There is nothing specific in this case. Use the integration, configure the collection_level, and view your metrics in Datadog.

  1. You used the integration with an Agent older than 6.5.0/5.27.0, and upgraded to a newer version.
    • If your configuration specifically set the all_metrics parameter to either true or false, nothing changes (the same metrics are sent to Datadog). You should then update your dashboards and monitors to use the new metric names before switching to the new collection_level parameter, since all_metrics is deprecated and will eventually be removed.
    • If your configuration did not specify the all_metrics parameter, upon upgrade the integration defaults to the collection_level parameter set to 1 and sends the metrics with the new name to Datadog.
      Warning: this breaks your dashboard graphs and monitors scoped on the deprecated metrics, which stop being sent. To prevent this, you should explicitly set all_metrics: false in your configuration to continue reporting the same metrics, then update your dashboards and monitors to use the new metrics before switching back to using collection_level.

Configuration Options

Options Required Description
ssl_verify No Set to false to disable SSL verification, when connecting to vCenter.
ssl_capath No Set to the absolute file path of a directory containing CA certificates in PEM format.
host_include_only_regex No Use a regex like this if you want the check to only fetch metrics for these ESXi hosts and the VMs running on it.
vm_include_only_regex No Use a regex to include only the VMs that are matching this pattern.
include_only_marked No Set to true if you’d like to only collect metrics on vSphere VMs which are marked by a custom field with the value ‘DatadogMonitored’. To set this custom field with PowerCLI, use the command: Get-VM | Set-CustomField -Name “DatadogMonitored” -Value “DatadogMonitored”.
collection_level No A number between 1 and 4 to specify how many metrics are sent, 1 meaning only important monitoring metrics and 4 meaning every metric available.
all_metrics No (Deprecated) When set to true, this collects EVERY metric from vCenter, which means a LOT of metrics. When set to false, this collects a subset of metrics we selected that are interesting to monitor
event_config No Event config is a dictionary. For now the only switch you can flip is collect_vcenter_alarms which sends the alarms set in vCenter as events.

Validation

Run the Agent’s status subcommand and look for vsphere under the Checks section.

Data Collected

Metrics

vsphere.cpu.extra
(gauge)
Milliseconds of extra CPU time
shown as millisecond
vsphere.cpu.ready
(gauge)
Milliseconds of CPU time spent in ready state
shown as millisecond
vsphere.cpu.usage
(gauge)
Percentage of CPU capacity being used
shown as percent
vsphere.cpu.usagemhz
(gauge)
Total megehertz of CPU being used
shown as megahertz
vsphere.disk.commandsAborted
(gauge)
Number of SCSI commands aborted
shown as occurrence
vsphere.disk.deviceLatency
(gauge)
Average amount of time it takes to complete an SCSI command from physical device
shown as millisecond
vsphere.disk.deviceReadLatency
(gauge)
Average amount of time it takes to complete read from physical device
shown as millisecond
vsphere.disk.deviceWriteLatency
(gauge)
Average amount of time it takes to complete write to the physical device (LUN)
shown as millisecond
vsphere.disk.queueLatency
(gauge)
Average amount of time spent in VMkernel queue (per SCSI command)
shown as millisecond
vsphere.disk.totalLatency
(gauge)
Sum of average amount of time (in kernel and device) to process an SCSI command issued by the Guest OS to the vm
shown as millisecond
vsphere.mem.active
(gauge)
Kilobytes of memory that the VMkernel estimates is being actively used based on recently touched memory pages
shown as kibibyte
vsphere.mem.compressed
(gauge)
Kilobytes of memory that have been compressed
shown as kibibyte
vsphere.mem.consumed
(gauge)
Kilobytes of used memory
shown as kibibyte
vsphere.mem.overhead
(gauge)
Kilobytes of memory allocated to a vm beyond its reserved amount
shown as kibibyte
vsphere.mem.vmmemctl
(gauge)
Kilobytes of memory allocated by the virtual machine memory control driver (vmmemctl)
shown as kibibyte
vsphere.network.received
(rate)
Number of kilobytes received by the host
shown as kibibyte
vsphere.network.transmitted
(rate)
Number of kilobytes transmitted by the host
shown as kibibyte
vpshere.clusterServices.cpufairness.latest
(gauge)
Fairness of distributed CPU resource allocation
vpshere.clusterServices.effectivecpu.avg
(gauge)
Total available CPU resources of all hosts within a cluster
shown as megahertz
vpshere.clusterServices.effectivemem.avg
(gauge)
Total amount of machine memory of all hosts in the cluster that is available for use for virtual machine memory (physical memory for use by the Guest OS) and virtual machine overhead memory
shown as mebibyte
vpshere.clusterServices.failover.latest
(gauge)
vSphere HA number of failures that can be tolerated
vpshere.clusterServices.memfairness.latest
(gauge)
Fairness of distributed memory resource allocation
vsphere.cpu.ready.sum
(gauge)
Milliseconds of CPU time spent in ready state
shown as millisecond
vsphere.cpu.usage.avg
(gauge)
Percentage of CPU capacity being used
shown as percent
vsphere.cpu.usagemhz.avg
(gauge)
CPU usage, as measured in megahertz
shown as megahertz
vsphere.cpu.totalmhz.avg
(gauge)
Total megahertz of CPU being used
shown as megahertz
vsphere.cpu.coreUtilization.avg
(gauge)
CPU utilization of the corresponding core (if hyper-threading is enabled) as a percentage
shown as percent
vsphere.cpu.costop.sum
(gauge)
Time the virtual machine is ready to run, but is unable to run due to co-scheduling constraints
shown as millisecond
vsphere.cpu.cpuentitlement.latest
(gauge)
Amount of CPU resources allocated to the virtual machine or resource pool
shown as megahertz
vsphere.cpu.demand.avg
(gauge)
The amount of CPU resources a virtual machine would use if there were no CPU contention or CPU limit
shown as megahertz
vsphere.cpu.entitlement.latest
(gauge)
CPU resources devoted by the ESXi scheduler
shown as megahertz
vsphere.cpu.idle.sum
(gauge)
Total time that the CPU spent in an idle state
shown as millisecond
vsphere.cpu.latency.avg
(gauge)
Percent of time the virtual machine is unable to run because it is contending for access to the physical CPU(s)
shown as percent
vsphere.cpu.maxlimited.sum
(gauge)
Time the virtual machine is ready to run, but is not running because it has reached its maximum CPU limit setting
shown as millisecond
vsphere.cpu.reservedCapacity.avg
(gauge)
Total CPU capacity reserved by virtual machines
shown as megahertz
vsphere.cpu.run.sum
(gauge)
Time the virtual machine is scheduled to run
shown as millisecond
vsphere.cpu.totalCapacity.avg
(gauge)
Total CPU capacity reserved by and available for virtual machines
shown as megahertz
vsphere.cpu.utilization.avg
(gauge)
CPU utilization as a percentage during the interval (CPU usage and CPU utilization might be different due to power management technologies or hyper-threading)
shown as percent
vsphere.mem.consumed.avg
(gauge)
Amount of host physical memory consumed by a virtual machine, host, or cluster
shown as kibibyte
vsphere.mem.overhead.avg
(gauge)
Host physical memory consumed by the virtualization infrastructure for running the virtual machine
shown as kibibyte
vsphere.mem.swapinRate.avg
(gauge)
Rate at which memory is swapped from disk into active memory
shown as kibibyte
vsphere.mem.swapoutRate.avg
(gauge)
Rate at which memory is being swapped from active memory to disk
shown as kibibyte
vsphere.mem.totalmb.avg
(gauge)
Total amount of host physical memory of all hosts in the cluster that is available for virtual machine memory (physical memory for use by the guest OS) and virtual machine overhead memory
shown as kibibyte
vsphere.mem.usage.avg
(gauge)
Memory usage as percent of total configured or available memory
shown as kibibyte
vsphere.mem.vmmemctl.avg
(gauge)
Amount of memory allocated by the virtual machine memory control driver (vmmemctl)
shown as kibibyte
vsphere.mem.active.avg
(gauge)
Amount of memory that is actively used, as estimated by VMkernel based on recently touched memory pages
shown as kibibyte
vsphere.mem.activewrite.avg
(gauge)
Estimate for the amount of memory actively being written to by the virtual machine
shown as kibibyte
vsphere.mem.compressed.avg
(gauge)
Amount of memory reserved by userworlds
shown as kibibyte
vsphere.mem.compressionRate.avg
(gauge)
Rate of memory compression for the virtual machine
shown as kibibyte
vsphere.mem.decompressionRate.avg
(gauge)
Rate of memory decompression for the virtual machine
shown as kibibyte
vsphere.mem.entitlement.avg
(gauge)
Amount of host physical memory the virtual machine is entitled to, as determined by the ESX scheduler
shown as kibibyte
vsphere.mem.granted.avg
(gauge)
Amount of host physical memory or physical memory that is mapped for a virtual machine or a host
shown as kibibyte
vsphere.mem.latency.avg
(gauge)
Percentage of time the virtual machine is waiting to access swapped or compressed memory
shown as percent
vsphere.mem.llSwapInRate.avg
(gauge)
Rate at which memory is being swapped from host cache into active memory
shown as kibibyte
vsphere.mem.llSwapOutRate.avg
(gauge)
Rate at which memory is being swapped from active memory to host cache
shown as kibibyte
vsphere.mem.lowfreethreshold.avg
(gauge)
Threshold of free host physical memory below which ESX/ESXi will begin reclaiming memory from virtual machines through ballooning and swapping
shown as kibibyte
vsphere.mem.mementitlement.latest
(gauge)
Memory allocation as calculated by the VMkernel scheduler based on current estimated demand and reservation, limit, and shares policies set for all virtual machines and resource pools in the host or cluster
shown as mebibyte
vsphere.mem.overheadMax.avg
(gauge)
Host physical memory reserved for use as the virtualization overhead for the virtual machine
shown as kibibyte
vsphere.mem.reservedCapacity.avg
(gauge)
Total amount of memory reservation used by powered-on virtual machines and vSphere services on the host
shown as mebibyte
vsphere.mem.shared.avg
(gauge)
Amount of guest physical memory that is shared with other virtual machines, relative to a single virtual machine or to all powered-on virtual machines on a host
shown as kibibyte
vsphere.mem.sharedcommon.avg
(gauge)
Amount of machine memory that is shared by all powered-on virtual machines and vSphere services on the host
shown as kibibyte
vsphere.mem.state.latest
(gauge)
One of four threshold levels representing the percentage of free memory on the host. The counter value determines swapping and ballooning behavior for memory reclamation
shown as kibibyte
vsphere.mem.swapin.avg
(gauge)
Amount of memory swapped-in from disk
shown as kibibyte
vsphere.mem.swapout.avg
(gauge)
Amount of memory swapped-out to disk
shown as kibibyte
vsphere.mem.swapped.avg
(gauge)
Current amount of guest physical memory swapped out to the virtual machine swap file by the VMkernel. Swapped memory stays on disk until the virtual machine needs it. This statistic refers to VMkernel swapping and not to guest OS swapping
shown as kibibyte
vsphere.mem.swaptarget.avg
(gauge)
Target size for the virtual machine swap file. The VMkernel manages swapping by comparing swaptarget against swapped
shown as kibibyte
vsphere.mem.swapused.avg
(gauge)
Amount of memory that is used by swap. Sum of memory swapped of all powered on VMs and vSphere services on the host
shown as kibibyte
vsphere.mem.sysUsage.avg
(gauge)
Amount of host physical memory used by VMkernel for core functionality, such as device drivers and other internal uses. Does not include memory used by virtual machines or vSphere services
shown as kibibyte
vsphere.mem.totalCapacity.avg
(gauge)
Total amount of memory reservation used by and available for powered-on virtual machines and vSphere services on the host
shown as mebibyte
vsphere.mem.unreserved.avg
(gauge)
Amount of memory that is unreserved. Memory reservation not used by the Service Console, VMkernel, vSphere services and other powered on VMs’ user-specified memory reservations and overhead memory
shown as kibibyte
vsphere.mem.vmmemctltarget.avg
(gauge)
Target value set by VMkernal for the virtual machine's memory balloon size. In conjunction with vmmemctl metric, this metric is used by VMkernel to inflate and deflate the balloon for a virtual machine
shown as kibibyte
vsphere.mem.zero.avg
(gauge)
Memory that contains 0s only. Included in shared amount. Through transparent page sharing, zero memory pages can be shared among virtual machines that run the same operating system
shown as kibibyte
vsphere.mem.zipSaved.latest
(gauge)
Memory saved due to memory zipping
shown as kibibyte
vsphere.mem.zipped.latest
(gauge)
Memory zipped
shown as kibibyte
vsphere.net.usage.avg
(gauge)
Network utilization (combined transmit- and receive-rates)
shown as kibibyte
vsphere.net.broadcastRx.sum
(gauge)
Number of broadcast packets received
shown as packet
vsphere.net.broadcastTx.sum
(gauge)
Number of broadcast packets transmitted
shown as packet
vsphere.net.BytesRx.avg
(gauge)
Average amount of data received per second
shown as kibibyte
vsphere.net.BytesTx.avg
(gauge)
Average amount of data transmitted per second
shown as kibibyte
vsphere.net.droppedRx.sum
(gauge)
Number of received packets dropped
shown as packet
vsphere.net.droppedTx.sum
(gauge)
Number of transmitted packets dropped
shown as packet
vsphere.net.errorRx.sum
(gauge)
Number of packets with errors received
shown as packet
vsphere.net.errorTx.sum
(gauge)
Number of packets with errors transmitted
shown as packet
vsphere.net.multicastRx.sum
(gauge)
Number of multicast packets received
shown as packet
vsphere.net.multicastTx.sum
(gauge)
Number of multicast packets transmitted
shown as packet
vsphere.net.packetsRx.sum
(gauge)
Number of packets received
shown as packet
vsphere.net.packetsTx.sum
(gauge)
Number of packets transmitted
shown as packet
vsphere.net.received.avg
(gauge)
Average rate at which data was received during the interval. This represents the bandwidth of the network
shown as kibibyte
vsphere.net.transmitted.avg
(gauge)
Average rate at which data was transmitted during the interval. This represents the bandwidth of the network
shown as kibibyte
vsphere.net.unknownProtos.sum
(gauge)
Number of frames with unknown protocol received
shown as kibibyte
vsphere.power.power.avg
(gauge)
Current power usage
shown as watt
vsphere.datastore.datastoreIops.avg
(gauge)
Storage I/O Control aggregated IOPS
shown as operation
vsphere.datastore.datastoreMaxQueueDepth.latest
(gauge)
Storage I/O Control datastore maximum queue depth
shown as command
vsphere.datastore.datastoreReadIops.latest
(gauge)
Storage DRS datastore read I/O rate
shown as operation
vsphere.datastore.datastoreReadOIO.latest
(gauge)
Storage DRS datastore outstanding read requests
shown as request
vsphere.datastore.datastoreVMObservedLatency.latest
(gauge)
The average datastore latency as seen by virtual machines
shown as microsecond
vsphere.datastore.datastoreWriteIops.latest
(gauge)
Storage DRS datastore write I/O rate
shown as operation
vsphere.datastore.datastoreWriteOIO.latest
(gauge)
Storage DRS datastore outstanding write requests
shown as request
vsphere.datastore.numberReadAveraged.avg
(gauge)
Average number of read commands issued per second to the datastore
shown as command
vsphere.datastore.siocActiveTimePercentage.avg
(gauge)
Percentage of time Storage I/O Control actively controlled datastore latency
shown as percent
vsphere.datastore.sizeNormalizedDatastoreLatency.avg
(gauge)
Storage I/O Control size-normalized I/O latency
shown as microsecond
vsphere.datastore.totalReadLatency.avg
(gauge)
Average amount of time for a read operation from the datastore
shown as millisecond
vsphere.datastore.totalWriteLatency.avg
(gauge)
Average amount of time for a write operation from the datastore
shown as millisecond
vsphere.datastore.busResets.sum
(gauge)
Number of SCSI-bus reset commands issued
shown as command
vsphere.datastore.commandsAborted.sum
(gauge)
Number of SCSI commands aborted
shown as command
vsphere.datastore.datastoreNormalReadLatency.latest
(gauge)
Storage DRS datastore normalized read latency
shown as millisecond
vsphere.datastore.datastoreNormalWriteLatency.latest
(gauge)
Storage DRS datastore normalized write latency
shown as millisecond
vsphere.datastore.datastoreReadBytes.latest
(gauge)
Storage DRS datastore bytes read
shown as millisecond
vsphere.datastore.datastoreWriteBytes.latest
(gauge)
Storage DRS datastore bytes written
shown as millisecond
vsphere.datastore.read.avg
(gauge)
Rate of reading data from the datastore
shown as kibibyte
vsphere.datastore.write.avg
(gauge)
Rate of writing data to the datastore
shown as kibibyte
vsphere.disk.capacity.latest
(gauge)
Configured size of the datastore
shown as kibibyte
vsphere.disk.provisioned.latest
(gauge)
Amount of storage set aside for use by a datastore or a virtual machine. Files on the datastore and the virtual machine can expand to this size but not beyond it
shown as kibibyte
vsphere.disk.unshared.latest
(gauge)
Amount of space associated exclusively with a virtual machine
shown as kibibyte
vsphere.disk.used.latest
(gauge)
Amount of space actually used by the virtual machine or the datastore. May be less than the amount provisioned at any given time, depending on whether the virtual machine is powered-off, whether snapshots have been created or not, and other such factors
shown as kibibyte
vsphere.disk.deviceLatency.avg
(gauge)
Average amount of time it takes to complete an SCSI command from physical device
shown as millisecond
vsphere.disk.maxQueueDepth.avg
(gauge)
Maximum queue depth
shown as command
vsphere.disk.maxTotalLatency.latest
(gauge)
Highest latency value across all disks used by the host
shown as millisecond
vsphere.disk.numberReadAveraged.avg
(gauge)
Average number of read commands issued per second to the datastore
shown as command
vsphere.disk.numberWriteAveraged.avg
(gauge)
Average number of write commands issued per second to the datastore
shown as command
vsphere.disk.usage.avg
(gauge)
Aggregated disk I/O rate
shown as kibibyte
vsphere.disk.busResets.sum
(gauge)
Number of SCSI-bus reset commands issued
shown as command
vsphere.disk.commands.sum
(gauge)
Number of SCSI commands issued
shown as command
vsphere.disk.commandsAborted.sum
(gauge)
Number of SCSI commands aborted
shown as command
vsphere.disk.commandsAveraged.avg
(gauge)
Average number of SCSI commands issued per second
shown as command
vsphere.disk.deltaused.latest
(gauge)
Storage overhead of a virtual machine or a datastore due to delta disk backings
shown as kibibyte
vsphere.disk.deviceReadLatency.avg
(gauge)
Average amount of time to read from the physical device
shown as millisecond
vsphere.disk.deviceWriteLatency.avg
(gauge)
Average amount of time to write from the physical device
shown as millisecond
vsphere.disk.kernelLatency.avg
(gauge)
Average amount of time spent by VMkernel to process each SCSI command
shown as millisecond
vsphere.disk.kernelReadLatency.avg
(gauge)
Average amount of time spent by VMkernel to process each SCSI read command
shown as millisecond
vsphere.disk.kernelWriteLatency.avg
(gauge)
Average amount of time spent by VMkernel to process each SCSI write command
shown as millisecond
vsphere.disk.queueLatency.avg
(gauge)
Average amount of time spent in the VMkernel queue per SCSI command
shown as millisecond
vsphere.disk.queueReadLatency.avg
(gauge)
Average amount of time spent in the VMkernel queue per SCSI read command
shown as millisecond
vsphere.disk.queueWriteLatency.avg
(gauge)
Average amount of time spent in the VMkernel queue per SCSI write command
shown as millisecond
vsphere.disk.read.avg
(gauge)
Average number of kilobytes read from the disk each second
shown as kibibyte
vsphere.disk.totalReadLatency.avg
(gauge)
Average amount of time taken to process a SCSI read command issued from the guest OS to the virtual machine
shown as millisecond
vsphere.disk.totalWriteLatency.avg
(gauge)
Average amount of time taken to process a SCSI write command issued by the guest OS to the virtual machine
shown as millisecond
vsphere.disk.write.avg
(gauge)
Average number of kilobytes written to the disk each second
shown as kibibyte
vsphere.virtualDisk.numberReadAveraged.avg
(gauge)
Average number of read commands issued per second to the virtual disk
shown as command
vsphere.virtualDisk.numberWriteAveraged.avg
(gauge)
Average number of write commands issued per second to the virtual disk
shown as command
vsphere.virtualDisk.totalReadLatency.avg
(gauge)
Average amount of time for a read operation from the virtual disk
shown as millisecond
vsphere.virtualDisk.totalWriteLatency.avg
(gauge)
Average amount of time for a write operation from the virtual disk
shown as millisecond
vsphere.virtualDisk.busResets.sum
(gauge)
Number of SCSI-bus reset commands issued
shown as command
vsphere.virtualDisk.commandsAborted.sum
(gauge)
Number of SCSI commands aborted
shown as command
vsphere.virtualDisk.read.avg
(gauge)
Average number of kilobytes read from the virtual disk each second
shown as kibibyte
vsphere.virtualDisk.readLoadMetric.latest
(gauge)
Storage DRS virtual disk metric for the read workload model
vsphere.virtualDisk.readOIO.latest
(gauge)
Average number of outstanding read requests to the virtual disk
shown as request
vsphere.virtualDisk.write.avg
(gauge)
Average number of kilobytes written to the virtual disk each second
shown as kibibyte
vsphere.virtualDisk.writeLoadMetric.latest
(gauge)
Storage DRS virtual disk metric for the write workload model
vsphere.virtualDisk.writeOIO.latest
(gauge)
Average number of outstanding write requests to the virtual disk
shown as request
vsphere.storageAdapter.commandsAveraged.avg
(gauge)
Average number of commands issued per second by the storage adapter
shown as command
vsphere.storageAdapter.numberReadAveraged.avg
(gauge)
Average number of read commands issued per second by the storage adapter
shown as command
vsphere.storageAdapter.numberWriteAveraged.avg
(gauge)
Average number of write commands issued per second by the storage adapter
shown as command
vsphere.storageAdapter.outstandingIOs.avg
(gauge)
The number of I/Os that have been issued but have not yet completed
shown as command
vsphere.storageAdapter.queueDepth.avg
(gauge)
The maximum number of I/Os that can be outstanding at a given time
shown as command
vsphere.storageAdapter.queueLatency.avg
(gauge)
Average amount of time spent in the VMkernel queue per SCSI command
shown as millisecond
vsphere.storageAdapter.queued.avg
(gauge)
The current number of I/Os that are waiting to be issued
shown as command
vsphere.storageAdapter.read.avg
(gauge)
Rate of reading data by the storage adapter
shown as kibibyte
vsphere.storageAdapter.totalReadLatency.avg
(gauge)
Average amount of time for a read operation by the storage adapter
shown as millisecond
vsphere.storageAdapter.totalWriteLatency.avg
(gauge)
Average amount of time for a write operation by the storage adapter
shown as millisecond
vsphere.storageAdapter.write.avg
(gauge)
Rate of writing data by the storage adapter
shown as kibibyte
vsphere.storagePath.busResets.sum
(gauge)
Number of SCSI-bus reset commands issued
shown as command
vsphere.storagePath.commandsAborted.sum
(gauge)
Number of SCSI commands aborted
shown as command
vsphere.sys.heartbeat.latest
(gauge)
Number of heartbeats issued per virtual machine
vsphere.sys.uptime.latest
(gauge)
Total time elapsed since last system startup
shown as second
vsphere.vmop.numChangeDS.latest
(gauge)
Number of datastore change operations for powered-off and suspended virtual machines
shown as operation
vsphere.vmop.numChangeHost.latest
(gauge)
Number of host change operations for powered-off and suspended virtual machines
shown as operation
vsphere.vmop.numChangeHostDS.latest
(gauge)
Number of host and datastore change operations for powered-off and suspended virtual machines
shown as operation
vsphere.vmop.numClone.latest
(gauge)
Number of virtual machine clone operations
shown as operation
vsphere.vmop.numCreate.latest
(gauge)
Number of virtual machine create operations
shown as operation
vsphere.vmop.numDeploy.latest
(gauge)
Number of virtual machine template deploy operations
shown as operation
vsphere.vmop.numDestroy.latest
(gauge)
Number of virtual machine delete operations
shown as operation
vsphere.vmop.numPoweroff.latest
(gauge)
Number of virtual machine power off operations
shown as operation
vsphere.vmop.numPoweron.latest
(gauge)
Number of virtual machine power on operations
shown as operation
vsphere.vmop.numRebootGuest.latest
(gauge)
Number of virtual machine guest reboot operations
shown as operation
vsphere.vmop.numReconfigure.latest
(gauge)
Number of virtual machine reconfigure operations
shown as operation
vsphere.vmop.numRegister.latest
(gauge)
Number of virtual machine register operations
shown as operation
vsphere.vmop.numReset.latest
(gauge)
Number of virtual machine reset operations
shown as operation
vsphere.vmop.numSVMotion.latest
(gauge)
Number of migrations with Storage vMotion (datastore change operations for powered-on VMs)
shown as operation
vsphere.vmop.numShutdownGuest.latest
(gauge)
Number of virtual machine guest shutdown operations
shown as operation
vsphere.vmop.numStandbyGuest.latest
(gauge)
Number of virtual machine standby guest operations
shown as operation
vsphere.vmop.numSuspend.latest
(gauge)
Number of virtual machine suspend operations
shown as operation
vsphere.vmop.numUnregister.latest
(gauge)
Number of virtual machine unregister operations
shown as operation
vsphere.vmop.numVMotion.latest
(gauge)
Number of migrations with vMotion (host change operations for powered-on VMs)
shown as operation
vsphere.vmop.numXVMotion.latest
(gauge)
Number of host and datastore change operations for powered-on and suspended virtual machines
shown as operation

Events

This check watches vCenter’s Event Manager for events and emits them to Datadog. It does NOT emit the following event types:

  • AlarmStatusChangedEvent:Gray
  • VmBeingHotMigratedEvent
  • VmResumedEvent
  • VmReconfiguredEvent
  • VmPoweredOnEvent
  • VmMigratedEvent
  • TaskEvent:Initialize powering On
  • TaskEvent:Power Off virtual machine
  • TaskEvent:Power On virtual machine
  • TaskEvent:Reconfigure virtual machine
  • TaskEvent:Relocate virtual machine
  • TaskEvent:Suspend virtual machine
  • TaskEvent:Migrate virtual machine
  • VmMessageEvent
  • VmSuspendedEvent
  • VmPoweredOffEvent

Service Checks

vcenter.can_connect:
Returns CRITICAL if the Agent cannot connect to vCenter to collect metrics, otherwise OK.

Troubleshooting

Further Reading

See our blog post on monitoring vSphere environments with Datadog.


Mistake in the docs? Feel free to contribute!