vSphere

Supported Version

Currently supported version is v6.7 with all updates.

Configuration

To enable vSphere metric monitoring, add the credentials of vCenter to the agent config file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.vsphere:
  host: https://<INSERT_HOST_HERE>/sdk
  username: <INSERT_USERNAME_HERE>
  password: <INSERT_PASSWORD_HERE>
  enabled: true
  poll_rate: 20 # metrics poll rate in seconds

Minimal required role for defined user is read-only.

Remote monitoring is supported, which means the Agent can be installed on the vCenter machine or anywhere else.

Metrics for vSphere are polled every 20 seconds, this can be changed via agent configuration in <agent_install_dir>/etc/instana/configuration.yaml.

Metrics collection

Cluster

Configuration data

  • Name
  • Status
  • Number of ESXi Hosts
  • Number of Virtual Machines

Performance metrics

Data point Description Granularity
Uptime Total time elapsed, in seconds, since last operating system start 20 seconds
CPU usage This metric indicates the percentage of CPU that was used out of all the CPU that was allocated to the cluster 20 seconds
CPU wait Amount of time spent on system processes on each virtual CPU in the virtual machine 20 seconds
CPU system Total CPU time spent in wait state wait on each virtual CPU in the virtual machine 20 seconds
Memory usage Average percentage of each host physical memory that has been consumed usage 20 seconds
VM ballon memory usage Average amount of guest physical memory reclaimed from the virtual machine by the balloon driver in the guest 20 seconds
Net usage Average network utilization (combined transmit-rates and receive-rates) during the interval 20 seconds

Host

Configuration data

  • Name
  • Number of CPU cores
  • Total memory
  • List of Virtual Machines
  • List of mounted datastores

Performance metrics

Data point Description Granularity
CPU usage CPU usage as a percentage during the interval usage 20 seconds
Memory usage Percentage of host physical memory that has been consumed 20 seconds
Memory shared Amount of guest physical memory that is shared within a single virtual machine or across virtual machines 20 seconds
Memory active Amount of guest physical memory that is being actively read or written by guest 20 seconds
Memory vmmemctl Amount of guest physical memory reclaimed from the virtual machine by the balloon driver in the guest 20 seconds
Network transmitted Average amount of data transmitted per second 20 seconds
Network received Average amount of data received per second 20 seconds
Network total Average amount of data transmitted + received per second 20 seconds
Network packets received Number of broadcast packets received during the sampling interval 20 seconds
Network packets transmitted Number of broadcast packets transmitted during the sampling interval 20 seconds
Network packets total Number of broadcast packets received + transmitted during the sampling interval 20 seconds

Datastore

Configuration data

  • Name
  • Mounted url
  • Type
  • Max file size
  • Capacity

Performance metrics

Data point Description Granularity
Free space Total free space for given datastore 20 seconds
IOPS read Storage DRS datastore read I/O rate 20 seconds
IOPS write Storage DRS datastore write I/O rate 20 seconds
IOPS total Storage DRS datastore read + write I/O rate 20 seconds
Number of reads Average number of read commands issued per second to the datastore during the collection interval 20 seconds
Number of writes Average number of write commands issued per second to the datastore during the collection interval 20 seconds
Read latency Storage DRS datastore normalized read latency 20 seconds
Write latency Storage DRS datastore normalized write latency 20 seconds
Total latency Storage DRS datastore normalized read + write latency 20 seconds

Virtual Machine

Configuration data

  • Name
  • Number of CPU cores
  • Total memory
  • Link to Infrastructure Host where Instana agent is running

Performance metrics

Data point Description Granularity
CPU usage CPU usage as a percentage during the interval usage 20 seconds
CPU system Total CPU time spent in wait state wait on each virtual CPU in the virtual machine 20 seconds
CPU ready Time that the virtual machine was ready, but could not get scheduled to run on the physical CPU during last measurement interval 20 seconds
CPU wait Total CPU time spent in wait state wait 20 seconds
CPU readiness Percentage of time that the virtual machine was ready, but could not get scheduled to run on the physical CPU 20 seconds
CPU latency Percent of time the virtual machine is unable to run because it is contending for access to the physical CPU(s) 20 seconds
Memory usage Percentage of host physical memory that has been consumed 20 seconds
Memory active Amount of guest physical memory that is being actively read or written by guest. Activeness is estimated by ESXi 20 seconds
Memory swapped Amount of guest physical memory that is swapped out to the swap space swapped 20 seconds
Memory granted Amount of host physical memory or physical memory that is mapped for a virtual machine or a host 20 seconds
Memory vmmemctl Amount of guest physical memory reclaimed from the virtual machine by the balloon driver in the guest 20 seconds
Network transmitted Average amount of data transmitted per second 20 seconds
Network received Average amount of data received per second 20 seconds
Network total Average amount of data transmitted + received per second 20 seconds
Network packets received Number of broadcast packets received during the sampling interval 20 seconds
Network packets transmitted Number of broadcast packets transmitted during the sampling interval 20 seconds
Network packets total Number of broadcast packets received + transmitted during the sampling interval 20 seconds