VMware Asset Discovery Plugin Inspectors

The Fixlet named 5629 - VMware Plugin manage Hosts discovery can be used to retrieve information related to the Host VMware Inspectors and display them in the BigFix Console. These information apply to the inspector sections described in this page which contain (Host) in their titles.

Bios

vm bios: bios

The vm bios inspector returns contains the uuid of the bios property.

uuid of <bios>: string

The 128-bit SMBIOS UUID of a virtual machine represented as a hexadecimal string in the 12345678-abcd-1234-cdef-123456789abc format.

Bios (Guest)

version of <vm bios>: string

The current BIOS version of the physical chassis.

release date of <vm bios>: time

The release date for the BIOS.

Bios (Host)

host bios : <host bios> 

The Host BIOS inspector returns information about the system BIOS of the host.

model of <host bios>: string

The Host BIOS model identification.

platform of <host bios>: platform

Returns the platform object of the Host BIOS.

serial number of <platform>: string

The serial number of the Host BIOS, taken from the platform object.

Computer Name

computer name: string

The display name of the device. The name of the virtual machine for Guest devices and the host name for Host devices.

Credentials Label

credentials label: string

The credentials label is a custom string defined by the user when installing the plugin. It uniquely identifies a user’s set of credentials.

Custom Attributes

custom attributes: plural custom attribute

This inspector returns the custom attributes. An array of base types for storing values.

attribute of <custom attribute>: string

The attribute name of the custom attribute.

value of <custom attribute>: string

The string value of the custom attribute.

Data Source

data source: string

The data source is the name of the system where data is coming from. For the VMware Plugin, it is set to “Proxy – VMware” by default.

Device

device: device

The overall alarm status on this node. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property.

Device (Guest)

status of <device>: string

The current power state of the virtual machine.

state of <device>: string

The current state of the virtual machine.

vm uuid of <device>: string

The VC-specific identifier of the virtual machine.

bios uuid of <device>: string

The virtual machine BIOS identification.

description of <device>: string

The description for the virtual machine.

vm path name of <device>: string

The path name to the configuration file for the virtual machine

clean power off of <device>: string

For a powered off virtual machine, it indicates whether the virtual machine's last shutdown was an orderly power off or not. Unset if the virtual machine is running or suspended.

virtual disk count of <device>: integer

The number of virtual disks attached to the virtual machine.

ethernet card count of <device>: integer

The number of virtual network adapters.

modification time of <device>: time

The last executed task.

template of <device>: boolean

This data object type describes a template virtual machine configuration file.

Device (Host)

bios release date of <device>: time

The release date for the bios.

bios version of <device>: string

The current bios version of the physical chassis.

bios uuid of <device>: string

The hardware BIOS identification.

file system type of <device>: string

Represents the list of supported file system volume types.

maintenance mode of <device>: boolean

The flag to indicate whether or not the host is in maintenance mode. This flag is set when the host has entered the maintenance mode. It is not set during the entering phase of maintenance mode.

model of <device>: string

The system model identification.

network adapters of <device>: string

The number of network adapters.

pending restart of <device>: boolean

Indicates whether or not the host requires a reboot due to a configuration change.

port number of <device>: string

The port number.

status of <device>: string

The overall alarm status of the host.

vendor of <device>: string

The vendor type.

vmotion of <device>: boolean

The flag to indicate whether or not VMotion is enabled on this host.

vswitches of <device>: plural vswitches

The virtual switches.

portgroups of <vswitches>: plural string

The port groups of the virtual switches.

name of <vswitches>: string

The name of the virtual switches.

hostd log enabled of <device>: boolean

The flag to indicate if hostd log file exists.

messages log enabled of <device>: boolean

The flag to indicate if messages log file exists.

vmkernel log enabled of <device>: boolean

The flag to indicate if vmkernel log file exists.

Device ID

device id: string

The device ID is a unique identifier for each device. For VMware Guest devices, it corresponds to the instance UUID, which is the VC-specific identifier of the virtual machine. For VMware Hosts, it corresponds to the Host name with the “Host - “ prefix prepended.

Disk

disk: disk

The disk inspectors return data concerning the storage used by a machine.

provisioned storage of <disk> : string

The total storage space, in bytes, both committed and uncommitted to this virtual machine on all datastores.

used storage of <disk> : string

The total storage space, in bytes, committed to this virtual machine across all datastores.

unshared storage of <disk> : string

The total storage space, in bytes, occupied by the virtual machine across all datastores, that is not shared with any other virtual machine.

Drive (Guest)

drive: drive
drives: plural drive

The drive inspectors return data about the file system.

name of <drive>: string

The name of the virtual disk in the guest operating system. For example: C:\

free space of <drive>: integer

The free space on the disk, in bytes. This is retrieved by the VMware Tools.

total space of <drive>: integer

The total capacity of the disk, in bytes. This is part of the virtual machine configuration.

Guest VM

 guest vms: plural guest vm

These inspectors retrieve properties for the guest virtual machine.

name of <guest vm>: string

The guest name configured on the virtual machine.

network of <guest vm>: network

The network configured on the virtual machine.

operating system of <guest vm>: operating system

The operating system on the virtual machine.

host of <guest vm>: host

The host name.

 tool of <guest vm>: tool

The tool on the virtual machine.

processor of <guest vm>: processor

The processor on the virtual machine.

ram of <guest vm>: ram

The RAM on the virtual machine.

usage statistic of <guest vm>: usage statistic

The usage statistic of the virtual machine.

drives of <guest vm>: drive

The drives of the virtual machine.

device of <guest vm>: device

The devices configured on the virtual machine.

snapshots of <guest vm>: snapshot

The snaphots of the virtual machine.

Hardware

hardware: hardware

This inspector holds properties about the hardware type of the VMware representation of an instance. By default, the virtual and proxied properties return true on cloud plugins representations.

virtual of <hardware>: boolean

Returns true if the client is running on a virtual machine.

proxied of <hardware>: boolean

Returns true if the device reports to the BES Plugin Portal. Otherwise, it returns false.

Host (Guest)

host: host

The Host inspectors report the name of the host of the current guest.

name of <host>: string

The name of the host.

Services (Host)

[host service, host services]: plural host service

The Host Service inspectors return information about each configured service that runs on a host.

key name of <host service> : string

The brief identifier for the service.

label of <host service> : string

Displays the label for the service.

policy of <host service> : string

The service activation policy.

required of <host service> : string

The flag indicating whether the service is required and cannot be disabled.

running status of <host service> : string

The flag indicating whether the service is currently running.

Network

The network inspector is defined in the common section. The following properties are available for the VMware cloud plugin.

ip interfaces of <network>: plural ip interface

Returns all the IP interfaces of the network.

address of <ip interface>: string

The primary IP address assigned to the guest operating system, if known. Otherwise, the preferred one.

loopback of <ip interface>: boolean

The routing of electronic signals or digital data streams back to their source without intentional processing or modification.

mac address of <ip interface>: string

The MAC address of the adapter.

Network (Guest)

The VNIC inspectors provide Guest information about network adapters, if known.

vnics of <network>: plural vnic

Returns the VNICs of the network.

vnic counter of <network>: integer

Represents the virtual network identity cards counter.

name of <vnic>: string

The label for the device.

up of <vnic>: boolean

The flag indicating whether or not the virtual device is connected.

mac address of <vnic>: string

The MAC address of the adapter.

[address, addresses] of <vnic>: plural string

Zero, one or more manual (static) assigned IP addresses to be configured on a given interface.

dhcp enabled of <vnic>: boolean

Indicates whether or not dynamic host control protocol (DHCP) is used to configure DNS configuration.

connected of <vnic>: boolean

The flag indicating whether or not the virtual device is connected.

device config id of <vnic>: integer

The link to the corresponding virtual device.

label of <vnic>: string

The display label of the VNIC.

address counter of <vnic>: string

The number of addresses found.

vnic counter of <network>: string

The number of VNICs found.

OS

The operating system inspector is defined in the common section.

name of <operating system>: string

The complete product name, including the version information, if known. Otherwise, the short form of the product name.

version of <operating system>: string

The dot-separated version string.

OS (Guest)

[family, families] of <operating system>: string

The guest operating system family, if known.

id of <operating system>: string

The guest operating system identifier short name, if known.

OS (Host)

api version of <operating system>: version

The version of the API as a dot-separated string.

api type of <operating system>: string

Indicates whether or not the service instance represents a standalone host. If the service instance represents a standalone host, then the physical inventory for that service instance is fixed to that single host. VirtualCenter server provides additional features over single hosts.

boot time of <operating system>: time

Represents the time when the host was booted.

build number of <operating system>: integer

The OS host build number.

license product name of <operating system>: string

The name of the license product.

license product version of <operating system>: string

The version of the license product.

locale build of <operating system>: string

The build number for the current session's locale. Typically, this is a small number reflecting a localization change from the normal product build.

locale version of <operating system>: string

The version of the message catalog for the current session's locale.

major version of <operating system>: version

The first number of the OS Version property as a dot-separated string.

minor version of <operating system>: version

The second number of the OS Version property as a dot-separated string.

os type of <operating system>: string

The operating system type and architecture.

product line id of <operating system>: string

The product ID which is a unique identifier for a product line.

vendor of <operating system>: string

The name of the vendor of this product.

Patch Status (Host)

[patch status, patch statuses]: plural patch status

This inspector collects the information about the patch enforcement of the ESXi.

package name of <patch status>: string

The identifier that uniquely identifies the software package.

package install date of <patch status>: string

The time when the package was installed. On Autodeploy stateless installations, there is no value set.

package version of <patch status>: string

The version string that uniquely identifies the software package.

package vendor of <patch status>: string

The corporate entity that created the software package.

package acceptance of <patch status>: string

The acceptance level definitions. See here for details.

Processor

processor: processor

The processor inspector is defined in the common section. It returns processor objects defined on the machine.

speed of <processor>: hertz

Returns the speed of the processor in Hertz. Defaults to -1.

family name of <processor>: string

Returns the family name of the CPU. For the VMware cloud plugin it is left empty.

Processor (Guest)

count of <processor>: integer

The number of processors in the virtual machine.

resource settings of <processor>: resource setting

The resource settings specifies the reserved resource requirement as well as the limit (maximum allowed usage) for a given kind of resource. CPU allocation is specified in MHz.

Processor (Host)

logical processor count of <processor>: integer

The number of physical CPU threads on the host.

physical processor count of <processor>: integer

The number of physical CPU packages on the host.

power management currenty policy of <processor>: string

The information about the current CPU power management policy.

power management hardware support of <processor>: string

The information about the supported CPU power management.

total processor core count of <processor>: integer

The number of physical CPU cores on the host.

cpu packages of <processor>: plural cpu package

The CPU packages of the processor.

cpu pkg bus hz of <cpu package>: integer

The bus speed in HZ.

cpu pkg description of <cpu package>: string

The string summary description of the CPU.

cpu pkg hz of <cpu package>: integer

The CPU speed in HZ.

cpu pkg vendor of <cpu package>: string

The CPU vendor name. Possible names currently are "Intel", "AMD", "arm", "hygon", or "unknown".

RAM

The RAM inspector is defined in the common section.

size of <ram>: integer

Returns the number of bytes of random access memory on the current machine.

RAM (Guest)

The amount of memory resource (in bytes) that will be used by the virtual machine above its guest memory requirements. This value is set if and only if the virtual machine is registered on a host that supports memory resource allocation features. For powered off VMs, this is the minimum overhead required to power on the VM on the registered host. For powered on VMs, this is the current overhead reservation, a value which is almost always larger than the minimum overhead, and which grows with time.

overhead of <ram>: integer

The bytes of memory used by the virtual machine above its guest memory requirements.

resource settings of <ram>: resource setting

Resource settings specifies the reserved resource requirement as well as the limit (maximum allowed usage) for a given kind of resource. Memory allocation is specified in MB.

Resource Setting

The properties below are common to ram and processor.

reservation of <resource setting>: integer

The amount of resource that is guaranteed available to the virtual machine or resource pool. Reserved resources are not wasted if they are not used. If the utilization is less than the reservation, the resources can be utilized by other running virtual machines. Units are MB for memory, MHz for CPU.

limit of <resource setting>: string

The utilization of a virtual machine/resource pool will not exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of virtual machines / resource pools independent of available resources. If set to -1, then there is no fixed limit on resource usage (only bounded by available resources and shares). Units are MB for memory, MHz for CPU.

overhead limit of <resource setting>: string

The maximum allowed overhead memory. For a powered on virtual machine, the overhead memory reservation cannot be larger than its overheadLimit. This property is only applicable to powered on virtual machines and is not persisted across reboots. This property is not applicable for resource pools. If set to -1, then there is no limit on reservation. Units are MB.

shares of <resource setting>: string

The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for shares. If the shares value does not map to a predefined size, then the level is set as custom.

Snapshot (Guest)

snapshots: plural snapshot

The snapshot inspectors report all the read-only data produced by a snapshot.

creation time of <snapshot>: time

The date and time the snapshot was taken.

description of <snapshot>: string

The description of the snapshot.

name of <snapshot>: string

The name of the snapshot.

id of <snapshot>: integer

The unique identifier that distinguishes this snapshot from other snapshots of the virtual machine.

quiesced of <snapshot>: boolean

The flag to indicate whether or not the snapshot was created with the "quiesce" option, ensuring a consistent state of the file system.

replay supported of <snapshot>: boolean

The flag to indicate whether this snapshot is associated with a recording session on the virtual machine that can be replayed.

type of <snapshot>: string

The name of the managed object type of this snapshot.

value of <snapshot>: string

The specific instance of the managed object of this snapshot.

vm state of <snapshot>: string

The power state of the virtual machine when this snapshot was taken.

children of <snapshot>: snapshots

The snapshot data for all snapshots for which this snapshot is the parent.

Tool (Guest)

tool : <tool>

The tool inspectors report data about the VMware Tools.

status of <tool>: string

The current version status of VMware Tools, if known.

running status of <tool>: string

The current running status of VMware Tools in the guest operating system, if known.

version of <tool>: string

The current version of VMware Tools, if known.

version status of <tool>: string

The current version status of VMware Tools in the guest operating system, if known.

Usage Statistic (Guest)

usage statistic: usage statistic

The Usage Statistic inspector returns a set of statistics for a Virtual Machine.

overall cpu of <usage statistic>: hertz

The basic CPU performance statistics, in MHz. Valid while the virtual machine is running.

memory of <usage statistic>: integer

The guest memory utilization statistics, in MB. This is also known as active guest memory. The number can be between 0 and the configured memory size of the virtual machine. Valid while the virtual machine is running.

maximum cpu of <usage statistic>: hertz

The current upper-bound on CPU usage.

[maximum memory, maximum memories] of <usage statistic>: integer

The current upper-bound on memory usage.

[host memory, host memories] of <usage statistic>: integer

The Host memory utilization in bytes, including the overhead memory of the MV. The value ranges between 0 and the configured resource limit and it is valid while the virtual machine is running. Also known as the consumed host memory.

USB Device (Host)

[usb device, usb devices] : plural usb device

The USB device inspector returns a set of properties.

name of <usb device>: string

The USB device name.

description of <usb device>: string

A user visible name of the USB device.

family of <usb device>: string

The device class families. For possible values, see VirtualMachineUsbInfoFamily.

physicalpath of <usb device>: string

An autoconnect pattern which describes the device physical path. This is the path to the specific port on the host where the USB device is attached.

product of <usb device>: integer

The product ID of the USB device.

speed of <usb device>: string

The possible device speeds detected by the server. For possible values, see VirtualMachineUsbInfoSpeed.

vendor of <usb device>: integer

The vendor ID of the USB device.

usage summary of <usb device>: usage summary

The summary information about the virtual machine that is currently using this device, if any.

vm name of <usage summary>: string

The name of the virtual machine

vm path of <usage summary>: string

The path name to the configuration file for the virtual machine.

Virtualization inspectors

datacenters: plural datacenter

The Virtualization inspectors return a set of datacenter properties.

Virtualization inspectors for datacenters

name of <datacenter>: string

The name of the datacenter.

datastores of <datacenter>: plural datastore

A collection of references to the datastore objects available in this datacenter.

name of <datastore>: string

The name of the datastore.

free space of <datastore>: string

The free space of this datastore, in bytes. The server periodically updates this value. It can be explicitly refreshed with the Refresh operation.

max file size of <datastore>: string

The maximum size of a file that can reside on this file system volume.

timestamp of <datastore>: string

The time when the free-space and capacity values in DatastoreInfo and DatastoreSummary were updated.

url of <datastore>: string

The unique locator for the datastore.

iso images of <datastore>: plural iso image

The ISO images of the datastore.

path of <iso image>: string

The path relative to the folder path in the search results.

Virtualization inspectors for hard drivers

disk of <guest vm>: disk

The disk.

hard driver counter of <guest vm>: string

The number of hard drivers.

hard drivers of <guest vm>: plural hard driver

The hard drivers.

hard drivers: plural hard driver

Array.

unitnumber of <hard driver>: string

The unit number of this device on its controller. This property is null if the controller property is null (for example, when the device is not attached to a specific controller object).

datastore name of <hard driver>: string

The name of the datastore.

controllerkey of <hard driver>: string

The object key for the controller object for this device. This property contains the key property value of the controller device object.

label of <hard driver>: string

The label of the disk.

capacity of <hard driver>: string

The total capacity of the disk, in bytes. This is part of the virtual machine configuration.

key of <hard driver>: string

A unique key that distinguishes this device from other devices in the same virtual machine. Keys are immutable but may be recycled; that is, a key does not change as long as the device is associated with a particular virtual machine. However, once a device is removed, its key may be used when another device is added. This property is not read-only, but the client cannot control its value. Persistent device keys are always assigned and managed by the server, which guarantees that all devices will have non-negative key values. When adding new devices, it may be necessary for a client to assign keys temporarily in order to associate controllers with devices in configuring a virtual machine. However, the server does not allow a client to reassign a device key, and the server may assign a different value from the one passed during configuration. Clients should ensure that existing device keys are not reused as temporary key values for the new device to be added (for example, by using unique negative integers as temporary keys). When editing or deleting a device, clients must use the server-provided key to refer to an existing device.

Virtualization inspectors for disk for last time refreshed

last time refreshed: string

Last time refreshed simply refers to the report production time for the disk discovery. The layout should be: <year> <month> <day> <hour>:<min>:<sec>.

last time refreshed of <guest vm>: string

Last time refreshed simply refers to the report production time for the disk discovery. The layout should be: <year> <month> <day> <hour>:<min>:<sec>.

Virtualization inspector for VM name

name: string

Name of the Guest or Host, unique relative to its parent. Could contain escaped characters.