Skip to content

vsphere

This module will collect hosts and vms performance statistics from one or more vCenter servers depending on configuration.

For virtual machines it produces the following charts:

  1. Cpu Usage Total in %

  2. Memory Usage Percentage in %

  3. Memory Usage in KiB

  4. VMKernel Memory Swap Rate in KiB/s

  5. VMKernel Memory Swap in KiB

  6. Network Bandwidth Total in KiB/s

  7. Network Packets Total in packets

  8. Network Drops Total in packets

  9. Disk Usage Total in KiB/s

  10. Disk Max Latency in ms

  11. Overall Alarm Status in status

  12. System Uptime in seconds

For hosts:

  1. Cpu Usage Total in %

  2. Memory Usage Percentage in %

  3. Memory Usage in KiB

  4. VMKernel Memory Swap Rate in KiB/s

  5. VMKernel Memory Swap in KiB

  6. Network Bandwidth Total in KiB/s

  7. Network Packets Total in packets

  8. Network Drops Total in packets

  9. Network Errors Total in errors

  10. Disk Usage Total in KiB/s

  11. Disk Max Latency in ms

  12. Overall Alarm Status in status

  13. System Uptime in seconds

configuration

Needs only url, username and password.

Here is an example for 2 servers:

jobs:
  - name         : vcenter1
    url          : https://203.0.113.0
    username     : admin@vsphere.local
    password     : somepassword
    host_include : ['/*']
    vm_include   : ['/*'] 

  - name         : vcenter2
    url          : https://203.0.113.10
    username     : admin@vsphere.local
    password     : somepassword
    host_include : ['/*']
    vm_include   : ['/*']

hosts/vms filtering

Module supports filtering hosts and vms, filtering options are host_include and vm_include.

host_include is a list of match patterns: /Dc pattern[/Cluster pattern/Host pattern].

vm_include is a list of match patterns: /Dc pattern[/Cluster pattern/Host pattern/VM name].

Pattern should start with /. It matches name, syntax: simple patterns.

Examples:

    host_include : ['/!*']  # filter all hosts
    vm_include   : ['/*']   # allow all vms
    host_include : ['/DC1/*', '/DC2/*/!HOST2 *']  # allow all DC1 datacenter hosts and DC2 datacenter hosts except HOST2
    vm_include   : ['/DC1*/*/!HOST1 !HOST2 */*'] # allow all vms from datacenters whose names starts with DC1 and from all hosts except HOST1 and HOST2

update every

Default update_every is 20 seconds and it doesnt make sense to decrease the value. VMware real-time statistics are generated at the 20-seconds specificity.

It is likely that 20 seconds is not enough for big installations and the value should be tuned.

To get better view we recommend to run the collector in debug mode and see how much time it will take to collect metrics.

Example (all not related debug lines were removed):

[ilyam@pc]$ ./godplugin -d -m vsphere
[ DEBUG ] vsphere[vsphere] discover.go:94 discovering : starting resource discovering process
[ DEBUG ] vsphere[vsphere] discover.go:102 discovering : found 3 dcs, process took 49.329656ms
[ DEBUG ] vsphere[vsphere] discover.go:109 discovering : found 12 folders, process took 49.538688ms
[ DEBUG ] vsphere[vsphere] discover.go:116 discovering : found 3 clusters, process took 47.722692ms
[ DEBUG ] vsphere[vsphere] discover.go:123 discovering : found 2 hosts, process took 52.966995ms
[ DEBUG ] vsphere[vsphere] discover.go:130 discovering : found 2 vms, process took 49.832979ms
[ INFO  ] vsphere[vsphere] discover.go:140 discovering : found 3 dcs, 12 folders, 3 clusters (2 dummy), 2 hosts, 3 vms, process took 249.655993ms
[ DEBUG ] vsphere[vsphere] build.go:12 discovering : building : starting building resources process
[ INFO  ] vsphere[vsphere] build.go:23 discovering : building : built 3/3 dcs, 12/12 folders, 3/3 clusters, 2/2 hosts, 3/3 vms, process took 63.3µs
[ DEBUG ] vsphere[vsphere] hierarchy.go:10 discovering : hierarchy : start setting resources hierarchy process
[ INFO  ] vsphere[vsphere] hierarchy.go:18 discovering : hierarchy : set 3/3 clusters, 2/2 hosts, 3/3 vms, process took 6.522µs
[ DEBUG ] vsphere[vsphere] filter.go:24 discovering : filtering : starting filtering resources process
[ DEBUG ] vsphere[vsphere] filter.go:45 discovering : filtering : removed 0 unmatched hosts
[ DEBUG ] vsphere[vsphere] filter.go:56 discovering : filtering : removed 0 unmatched vms
[ INFO  ] vsphere[vsphere] filter.go:29 discovering : filtering : filtered 0/2 hosts, 0/3 vms, process took 42.973µs
[ DEBUG ] vsphere[vsphere] metric_lists.go:14 discovering : metric lists : starting resources metric lists collection process
[ INFO  ] vsphere[vsphere] metric_lists.go:30 discovering : metric lists : collected metric lists for 2/2 hosts, 3/3 vms, process took 275.60764ms
[ INFO  ] vsphere[vsphere] discover.go:74 discovering : discovered 2/2 hosts, 3/3 vms, the whole process took 525.614041ms
[ INFO  ] vsphere[vsphere] discover.go:11 starting discovery process, will do discovery every 5m0s
[ DEBUG ] vsphere[vsphere] collect.go:11 starting collection process
[ DEBUG ] vsphere[vsphere] scrape.go:48 scraping : scraped metrics for 2/2 hosts, process took 96.257374ms
[ DEBUG ] vsphere[vsphere] scrape.go:60 scraping : scraped metrics for 3/3 vms, process took 57.879697ms
[ DEBUG ] vsphere[vsphere] collect.go:23 metrics collected, process took 154.77997ms

There you can see that discovering took 525.614041ms, collecting metrics took 154.77997ms. Discovering is a separate thread, it doesnt affect collecting.

update_every and timeout parameters should be adjusted based on these numbers.

For all available options please see module configuration file.