The VMware vSphere StackPack is used to create a near real-time synchronization with VMware vSphere.
This StackPack provides functionality that allows for monitoring of the following resources:
cluster compute resources
VMware StackPack collects all topology data for the components and relations between them as well as telemetry and events.
StackState Agent V2 must be installed on a single machine that can connect to VSphere VCenter and StackState.
A VSphere VCenter instance must be running.
The StackState Agent V2 connects to the vSphere instance on TCP port 443.
The StackState Agent V2 connects to StackState API on TCP port 7077
If the Agent is installed on the StackState host then port 7077 is localhost communication.
If the Agent is installed on a different host, you need a network path between the Agent and StackState on port 7077/tcp, and to vSphere on 443/tcp port.
To enable the vSphere check and begin collecting data from your VSphere VCenter instance:
Edit the Agent integration configuration file
/etc/stackstate-agent/conf.d/vsphere.d/conf.yaml to include details of your VSphere VCenter instance:
host - the same as the
vSphere Host Name used in the StackPack provisioning process.
password - use secrets management to store passwords outside of the configuration file.
# Section used for global vsphere check configinit_config:instances:# name must be a unique key representing your vCenter instance# mandatory- name: <name> # main-vcenter# the host used to resolve the vCenter IP# mandatoryhost: <host_name> # vcenter.domain.com# Read-only credentials to connect to vCenter# mandatoryusername: <username> # firstname.lastname@example.org: <password> # mypassword# Set to false to disable SSL verification, when connecting to vCenter# optionalssl_verify: false
Restart the StackState Agent(s) to publish the configuration changes.
Once the Agent is restarted, wait for the Agent to collect the data and send it to StackState.
The following configuration options can be added to the vSphere configuration file. Find details in the
Set to false to disable SSL verification, when connecting to vCenter.
Set to the absolute file path of a directory that contains CA certificates in PEM format, e.g.
Use a regex like this - conf.yaml, if you want the check to only fetch metrics for these ESXi hosts and the VMs running on it.
Use a regex to include only the VMs that are matching this pattern. More details in conf.yaml
Set to true, if you would like to only collect metrics on vSphere VMs that are marked by a custom field with the value
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.
The vSphere StackPack understands the following special tags:
Adds the specified value as an identifier to the StackState component
Fairness of distributed CPU resource allocation
Total available CPU resources of all hosts within a cluster. Shown as megahertz
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
vSphere HA number of failures that can be tolerated
Fairness of distributed memory resource allocation
CPU utilization of the corresponding core (if hyper-threading is enabled) as a percentage
Time the virtual machine is ready to run but is unable to run due to co-scheduling constraints. Shown as millisecond
Amount of CPU allocated to a virtual machine or a resource pool. Shown as megahertz
The amount of CPU virtual machine would use if there was no CPU contention or CPU limits. Shown as megahertz
Troubleshooting steps for any known issues can be found in the StackState support Knowledge base.