## VMware vCenter Server collector.
##
## Full option reference:
## https://github.com/netdata/netdata/tree/master/src/go/plugin/go.d/collector/vsphere#readme
##
## One job connects to one vCenter endpoint and discovers the included ESXi
## hosts, VMs, datastores, clusters, and resource pools reachable through it.
## By default, inventory and optional resource include selectors are "/*",
## which means "include all" for their respective surfaces.
## Hosts and VMs are discovered regardless of power state when vSphere returns
## them. Non-powered-on hosts/VMs do not get real-time performance counters.
##
## Selector formats:
##   host_include      : /Datacenter/Cluster/Host
##   vm_include        : /Datacenter/Cluster/Host/VM
##   datastore_include : /Datacenter/Datastore
##   cluster_include   : /Datacenter/Cluster
##   datastore_cluster_include : /Datacenter/DatastoreCluster
##
## Selector values use Netdata simple patterns. Resource pools follow their
## owning cluster selector.
##
## Credentials can be plain YAML values, but using Netdata secret resolvers is
## safer:
##   "${env:VSPHERE_PASSWORD}"
##   "${file:/run/secrets/vsphere_password}"
##   "${cmd:/absolute/path/to/command args}"
##   "${store:<kind>:<name>:<operand>}"
##
## Set vnode only if you want all metrics from this job attached to a Netdata
## Virtual Node. Leaving vnode unset preserves the normal local-node behavior.
##
## tag_categories and custom_attributes are opt-in label enrichment.
## They are disabled by default because tags and custom attributes can expose
## internal naming, ownership, addressing, or business metadata.
##
## collect_datastore_clusters and collect_vsan are opt-in metric collection
## groups.
## Datastore clusters add aggregate capacity/status for
## StoragePod objects. Host and VM power/energy plus host power-capacity
## performance counters are collected when vSphere exposes them.
## collect_vsan adds vSAN cluster capacity, vSAN cluster health, and vSAN
## cluster/host/VM performance metrics through vSAN APIs. It queries concrete
## discovered vSAN clusters, hosts, and VMs. Use vsan_*_include selectors to
## choose both emitted series and vSAN performance query scope. It requires vSAN
## and the vSAN Performance Service/API to be available.
## collect_network_topology is also opt-in, but it is not a metric group. It
## discovers vSphere Network and Distributed Virtual Port Group objects for the
## cached vSphere Topology function. It defaults to no so existing users do not
## get extra vCenter discovery calls unless they ask for network topology.
##
## discovery_interval controls inventory refreshes. Keep it reasonably high on
## large vCenters to avoid unnecessary vCenter load.

#jobs:
#  - name: vcenter1
#    url: https://vcenter.local
#    username: admin@vsphere.local
#    password: "${file:/run/secrets/vsphere_password}"
#
#    # Optional. Defaults to 20 seconds.
#    #update_every: 20
#
#    # Optional. Defaults to 60 seconds. Set 0 to disable autodetection retry.
#    #autodetection_retry: 60
#
#    # Optional. Defaults to 5 minutes.
#    #discovery_interval: 300
#
#    # Optional. Associate this job with a Netdata Virtual Node.
#    #vnode: vcenter1
#
#    # Optional vSphere tag category allowlist. Defaults to empty. Each list
#    # item is one glob pattern matching category names, so names with spaces
#    # are supported. Use "*" only when all tag categories are intentional.
#    # Label keys become vsphere_tag_<sanitized_category>.
#    # Multiple tags in the same category are sorted and joined with "|".
#    #tag_categories:
#    #  - "Environment"
#    #  - "Business Unit"
#
#    # Optional vSphere custom attribute allowlist. Defaults to empty. Each list
#    # item is one glob pattern matching attribute names, so names with spaces
#    # are supported. Custom attribute values are sent verbatim as labels. Use
#    # "*" only when all custom attributes are intentional and none of the
#    # matched values contain secrets.
#    # Label keys become vsphere_custom_attribute_<sanitized_name>.
#    #custom_attributes:
#    #  - "Owner"
#    #  - "Cost Center"
#
#    # Optional. Defaults to false. Adds aggregate datastore-cluster
#    # (StoragePod) capacity and Storage DRS status.
#    #collect_datastore_clusters: no
#
#    # Optional datastore-cluster selector. Defaults to all datastore clusters
#    # when collect_datastore_clusters is enabled. Patterns match
#    # /Datacenter/DatastoreCluster, datastore-cluster name, or vSphere ID.
#    # Matching datastore clusters are included in metrics and topology data.
#    #datastore_cluster_include:
#    #  - "/*"
#
#    # Optional. Defaults to false. Adds vSAN cluster capacity, vSAN cluster
#    # health, and vSAN cluster/host/VM performance metrics. It queries only
#    # discovered resources that pass the vSAN selectors below.
#    # Requires vSAN and the vSAN Performance Service/API.
#    #collect_vsan: no
#
#    # Optional. Defaults to all discovered vSAN-enabled clusters. Applies only
#    # when collect_vsan is enabled. Patterns match /Datacenter/Cluster,
#    # cluster name, vSphere managed object ID, or vsan_uuid:<uuid>.
#    #vsan_cluster_include:
#    #  - "/*"
#
#    # Optional. Defaults to all discovered hosts in selected vSAN clusters.
#    # Applies only when collect_vsan is enabled. Patterns match
#    # /Datacenter/Cluster/Host, host name, vSphere managed object ID, or
#    # vsan_node_uuid:<uuid>.
#    #vsan_host_include:
#    #  - "/*"
#
#    # Optional. Defaults to all discovered VMs in selected vSAN clusters.
#    # Applies only when collect_vsan is enabled. Patterns match
#    # /Datacenter/Cluster/Host/VM, VM name, vSphere managed object ID, or
#    # instance_uuid:<uuid>.
#    #vsan_vm_include:
#    #  - "/*"
#
#    # Optional. Defaults to false. Discovers vSphere Network and Distributed
#    # Virtual Port Group objects for the cached vSphere Topology function. It
#    # does not create charts or metrics.
#    #collect_network_topology: no
#
#    # Optional selectors. Defaults include everything.
#    #host_include:
#    #  - "/*"
#    #vm_include:
#    #  - "/*"
#    #datastore_include:
#    #  - "/*"
#    #cluster_include:
#    #  - "/*"
#
#    # Optional HTTP/TLS settings.
#    #timeout: 20
#    #tls_skip_verify: false
#
#  - name: vcenter2
#    url: https://vcenter2.local
#    username: admin@vsphere.local
#    password: "${env:VSPHERE2_PASSWORD}"
