Back to Beats

Docs

metricbeat/module/vsphere/_meta/docs.md

9.4.02.4 KB
Original Source

The vSphere module uses the Govmomi library to collect metrics from any VMware SDK URL (ESXi/VCenter).

This module has been tested against ESXi and vCenter versions 5.5, 6.0, 6.5, and 7.0.3.

By default, the vSphere module enables the following metricsets:

  1. cluster
  2. datastore
  3. datastorecluster
  4. host
  5. network
  6. resourcepool
  7. virtualmachine

Supported Periods: [_supported_periods]

The Datastore and Host metricsets support performance data collection using the vSphere performance API. Given that the performance API imposes usage restrictions based on data collection intervals, users should configure the period optimally to ensure the receipt of real-time data. This configuration can be determined based on the Data Collection Intervals and Data Collection Levels.

::::{important} Only host and datastore metricsets have limitation of system configured period from vSphere instance. Users can still collect summary metrics if performance metrics are not supported for the configured instance. ::::

Real-time data collection default interval: [_real_time_data_collection_default_interval]

  • 20s

Historical data collection default intervals: [_historical_data_collection_default_intervals]

  • 300s
  • 1800s
  • 7200s
  • 86400s

Example: [_example_5]

If you need to configure multiple metricsets with different periods, you can achieve this by setting up multiple vSphere modules with different metricsets as demonstrated below:

yaml
- module: vsphere
  metricsets:
   - cluster
   - datastorecluster
   - network
   - resourcepool
   - virtualmachine
  period: 10s
  hosts: ["https://localhost/sdk"]
  username: "user"
  password: "password"
  insecure: false

- module: vsphere
  metricsets:
   - datastore
   - host
  period: 300s
  hosts: ["https://localhost/sdk"]
  username: "user"
  password: "password"
  insecure: false

Dashboard [_dashboard_46]

The vSphere module includes a predefined dashboard. For example: