# Parameters and configuration

**Parameters**

<table border="1" id="bkmrk---generate_password-"><tbody><tr><td>--generate\_password</td><td>To generate an encrypted password (if this password is to be used later for connection, it must be entered in the configuration option "password" and the option "use\_encrypted\_password" must also be activated in the configuration file with 1.</td></tr><tr><td>--as\_discovery\_plugin</td><td>Option to use it in discovery mode.</td></tr></tbody></table>

**Configuration blocks**

The configuration file is divided into the following blocks

- Configuration
- Datacenter
- Datastore
- ESX
- VM
- Rename
- Reject
- Header

Each of the blocks is specified in the configuration file by entering its parameters below these blocks, for example :

```
Configuration
server 192.168.100.105
user pandorafms
pass P@$5w0rd!
datacenter ha-datacenter
```

Each block and its options are detailed below:

**Configuration**

Under the configuration block you can specify the following parameters

<span style="text-decoration: underline;">Global configuration</span>

<table border="1" id="bkmrk-server-name-or-ip-of" style="border-collapse: collapse; width: 100%; height: 907.282px;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">server</td><td style="height: 29.7969px;">Name or IP of the server to monitor</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">user</td><td style="height: 29.7969px;">Account user</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">pass</td><td style="height: 29.7969px;">Account password</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">datacenter</td><td style="height: 29.7969px;"> Datacenter where the plugin will point to</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">temporal</td><td style="height: 29.7969px;">Path where temporary files will be stored</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">logfile</td><td style="height: 29.7969px;">Path where the log file will be stored</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">entities\_list</td><td style="height: 46.5938px;">Path where the entities\_list file will be created (more information about this file below)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">transfer\_mode</td><td style="height: 29.7969px;">Execution mode, the two possible options are local or tentacle</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">local\_folder</td><td style="height: 46.5938px;">Path of the folder where the XML of the agents will be created for the local transfer mode (transfer\_mode = local)</td></tr><tr style="height: 57.7812px;"><td style="height: 57.7812px;">pandora\_url</td><td style="height: 57.7812px;">pandora URL (only if required to use the event mode of the plugin)

</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">api\_pass</td><td style="height: 46.5938px;">pandora api password (only if required to use the plugin event mode)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">api\_user</td><td style="height: 29.7969px;">pandora api user (only if required to use plugin events mode)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">api\_user\_pass</td><td style="height: 46.5938px;">Pandora api user password (only if required to use plugin event mode)</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">event\_mode</td><td style="height: 80.1875px;">To activate the vCenter event monitoring, it is activated with 1. The events are copied to the Pandora FMS event list and become part of its normal flow (requires connectivity with the Pandora FMS console API).</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">event\_pointer\_file</td><td style="height: 29.7969px;">Path where the event\_pointer\_file file will be saved.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">tentacle\_ip</td><td style="height: 46.5938px;">tentacle IP, required if the plugin is executed in transfer\_mode tentacle</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">tentacle\_port</td><td style="height: 29.7969px;">Tentacle port, default is 41121</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">tentacle\_opts</td><td style="height: 29.7969px;">Additional options for file transfer to the specified Tentacle server</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">virtual\_network\_monitoring</td><td style="height: 29.7969px;">Enables monitoring of virtual switches with value 1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">use\_encrypted\_password</td><td style="height: 29.7969px;">Enables use of an encrypted password with value 1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">threads</td><td style="height: 29.7969px;">Number of threads to be used by the plugin in agent creation</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">interval</td><td style="height: 29.7969px;">Interval in seconds in which the plugin agents are created</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">recon\_interval</td><td style="height: 29.7969px;">Interval in seconds after which the temporary entity cache file will be automatically deleted to rescan the VMware® infrastructure.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">group</td><td style="height: 29.7969px;">Group where the agents will be created</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">use\_ds\_alias\_as\_name</td><td style="height: 29.7969px;">Triggers the use of datastore agent alias as agent name with value 1</td></tr><tr><td>statsinterval</td><td>Interval in seconds for statistics taken using the "custom\_performance" option  
</td></tr><tr><td>flat\_datastore\_agents</td><td>Triggers creation of a single agent for datastores with name "VMWareDatastores" with value 1</td></tr><tr><td>use\_ds\_entity\_name</td><td>Enables use of Datastore name as agent name with value 1</td></tr></tbody></table>

<span style="text-decoration: underline;">Control parameters of monitorable elements</span>

<table border="1" id="bkmrk-monitor_exclusive_ag" style="border-collapse: collapse; width: 100%; height: 238.375px;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">monitor\_exclusive\_agents</td><td style="height: 29.7969px;">Enable the monitoring of specific agents (these are specified in the parameters below) with value 1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">exclusive\_esx</td><td style="height: 29.7969px;">If monitor\_exclusive\_agent is enabled, it is used to specify the esxi to monitor. Its value will be an array JSON with the agents to monitor</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">exclusive\_datastores</td><td style="height: 29.7969px;"> If monitor\_exclusive\_agent is enabled, it is used to specify the datastores to monitor. Its value will be an array type JSON with the agents to monitor</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">exclusive\_vm</td><td style="height: 29.7969px;">If monitor\_exclusive\_agent is enabled, it is used to specify the vm to monitor. Its value will be an array type JSON with the agents to monitor</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">scan\_datastore</td><td style="height: 29.7969px;">Activates datastore scanning with value 1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">scan\_datacenter</td><td style="height: 29.7969px;">Triggers datacenter scan with value 1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">scan\_esx</td><td style="height: 29.7969px;">Triggers esx scan with value 1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">scan\_vm</td><td style="height: 29.7969px;">Triggers virtual machine scan with value 1</td></tr></tbody></table>

**Datacenter**

<span style="text-decoration: underline;">Module activation or deactivation parameters</span>

The following modules can be enabled or disabled in the configuration file using "enabled" or "disabled".

<table border="1" id="bkmrk-ping-checking-ping-t" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><tbody><tr><td>ping</td><td>Checking ping to the machine that supports vCenter</td></tr><tr><td>check443</td><td>Checking port 443 on the machine that supports vCenter</td></tr></tbody></table>

**Datastore**

<span style="text-decoration: underline;">Module activation or deactivation parameters</span>

The following modules can be enabled or disabled in the configuration file using "enabled" or "disabled".

<table border="1" id="bkmrk-capacity-maximum-cap" style="border-collapse: collapse; width: 100%; height: 148.984px;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">capacity</td><td style="height: 29.7969px;">Maximum capacity of the datastore in bytes</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">freeSpace</td><td style="height: 29.7969px;">Percentage of free space on the datastore</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">overallocation</td><td style="height: 29.7969px;">Percentage of disk overallocation</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">freeSpaceBytes</td><td style="height: 29.7969px;">Amount of free disk space in bytes</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">dsPathStatus</td><td style="height: 29.7969px;">Datastore path status</td></tr></tbody></table>

  
 **ESX**

Module activation or deactivation parameters

The following modules can be enabled or disabled in the configuration file using "enabled" or "disabled".

<table border="1" id="bkmrk-diskread-kb%2Fs-disk-r" style="border-collapse: collapse; width: 100%; height: 625.735px;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">diskRead</td><td style="height: 29.7969px;">Kb/s disk read rate</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">diskWrite</td><td style="height: 29.7969px;">Rate of Kb/s written from disk</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">kernelReadLatency</td><td style="height: 29.7969px;">Disk read latency in milliseconds</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">kernelWriteLatency</td><td style="height: 29.7969px;">Disk write latency in milliseconds</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">deviceReadLatency</td><td style="height: 29.7969px;">Time it takes for a storage device to respond to a data read request</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">deviceWriteLatency</td><td style="height: 29.7969px;">Time it takes for a storage device to respond to a data write request</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">cpuInfo</td><td style="height: 29.7969px;">General CPU information (creates a module for each ESXi CPU)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">pciDevice</td><td style="height: 29.7969px;">Number of assigned PCI devices</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">hbaDevice</td><td style="height: 29.7969px;">Number of HBA (Host Bus Adapter) devices assigned to a virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">pnicInfo</td><td style="height: 29.7969px;">Information related to the physical network adapters (PNICs) that are configured on the ESXi host</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">vnicInfo</td><td style="height: 29.7969px;">Information about the virtual network interfaces of the host</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">cpuUsagePercent</td><td style="height: 29.7969px;">Percentage of current CPU usage on the host</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">memoryUsagePercent</td><td style="height: 29.7969px;">Percentage of current RAM usage on the host</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">diskRate</td><td style="height: 29.7969px;">Read and write data transfer rate on the host virtual disk</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">maxDiskLatency</td><td style="height: 29.7969px;">Maximum I/O latency time on the virtual disk of the host</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netUsage</td><td style="height: 29.7969px;">Network data transfer rate on host virtual disk</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">systemHealthInfo</td><td style="height: 29.7969px;">Information about the general health status of the system</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netReceived</td><td style="height: 29.7969px;">Amount of data received through the host network interface. netTransmitted Amount of transmitted data</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netTransmitted</td><td style="height: 29.7969px;">Amount of data transmitted over the host network interface</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netPkgRx</td><td style="height: 29.7969px;">Number of network packets received over the host network interface. netPkgTx Number of network packets received over the host network interface</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netPkgTx</td><td style="height: 29.7969px;">Number of network packets transmitted over the host network interface</td></tr></tbody></table>

**VM**

<span style="text-decoration: underline;">Module activation or deactivation parameters</span>

The following modules can be enabled or disabled in the configuration file using "enabled" or "disabled".

<table border="1" id="bkmrk-virtualimagepath-pat" style="border-collapse: collapse; width: 100%; height: 1576.02px;"><colgroup><col style="width: 50.0618%;"></col><col style="width: 50.0618%;"></col></colgroup><tbody><tr style="height: 46.5938px;"><td style="height: 46.5938px;">virtualImagePath</td><td style="height: 46.5938px;">Path of the virtual disk image associated with a particular virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">toolsRunningStatus</td><td style="height: 29.7969px;">Running status of VMware Tools on a virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">host</td><td style="height: 29.7969px;">hosting the virtual machines in a virtualization environment</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">connectionState</td><td style="height: 46.5938px;">Connection status between a virtual machine and its ESXi host in a virtualization environment</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">guestState</td><td style="height: 46.5938px;">State of the virtual machine in terms of its operating system and running applications</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">guestOS</td><td style="height: 29.7969px;">Operating system running on the virtual machine</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">hostName</td><td style="height: 46.5938px;">Name of the physical host on which the virtual machine is running</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">powerState</td><td style="height: 29.7969px;">Displays whether the virtual machine is powered on or off</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">triggeredAlarmState</td><td style="height: 46.5938px;">Displays the status of the alarms triggered in the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">bootTime</td><td style="height: 29.7969px;">Displays the date and time the virtual machine started</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">vcpuAllocation</td><td style="height: 29.7969px;">Number of virtual CPUs allocated to the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">cpuAllocation</td><td style="height: 29.7969px;">Number of CPU resources assigned to the virtual machine</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">consumedOverheadMemory</td><td style="height: 46.5938px;">Amount of memory used by the host to perform tasks related to the virtual machine</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">hostMemoryUsage</td><td style="height: 46.5938px;">Amount of memory used by the host to perform tasks related to the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">maxCpuUsage</td><td style="height: 29.7969px;">Maximum CPU usage in the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">maxMemoryUsage</td><td style="height: 29.7969px;">Maximum memory usage in the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">memoryMBAllocation</td><td style="height: 29.7969px;">Amount of RAM memory allocated to the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">memoryAllocation</td><td style="height: 29.7969px;">Amount of memory allocated to the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">uptimeSeconds</td><td style="height: 29.7969px;">Total time that the virtual machine has been running</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">memoryOverhead</td><td style="height: 46.5938px;">Amount of memory used by the host for monitoring and management tasks of the virtual machine</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">overallCpuDemand</td><td style="height: 46.5938px;">Total number of CPU resources requested by the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">overallCpuUsage</td><td style="height: 29.7969px;">Total amount of CPU resources used by the virtual machine</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">privateMemory</td><td style="height: 46.5938px;">Amount of memory used by the virtual machine for its private processes</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">sharedMemory</td><td style="height: 46.5938px;">Amount of memory shared between the virtual machine and the host</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">diskUsed</td><td style="height: 46.5938px;">Amount of space used on the virtual disk of the virtual machine</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">provisioningUsed</td><td style="height: 46.5938px;">Amount of space used in the virtual machine's provisioning storage</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">macAddress</td><td style="height: 46.5938px;">MAC address assigned to the virtual machine's network interface</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">ipAddress</td><td style="height: 29.7969px;">IP address assigned to the virtual machine's network interface</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">heartbeat</td><td style="height: 29.7969px;">State of the virtual machine's heartbeat</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">cpuReady</td><td style="height: 29.7969px;">Amount of time the virtual machine is waiting for the CPU</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">snapshotCounter</td><td style="height: 29.7969px;">Number of snapshots created for the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">totalReadLatency</td><td style="height: 29.7969px;">Total latency time for reading the virtual disk of the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">totalWriteLatency</td><td style="height: 29.7969px;">Total write latency time of the virtual disk of the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">cpuUsagePercent</td><td style="height: 29.7969px;">Percentage of current CPU usage in the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">memoryUsagePercent</td><td style="height: 29.7969px;">Percentage of current RAM memory usage in the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">diskRate</td><td style="height: 29.7969px;">Data transfer rate of reading and writing data on the virtual disk of the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">maxDiskLatency</td><td style="height: 29.7969px;">Maximum I/O latency time on the virtual disk of the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netUsage</td><td style="height: 29.7969px;">Network data transfer rate in the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">systemHealthInfo</td><td style="height: 29.7969px;">Information about the overall system health status</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netReceived</td><td style="height: 29.7969px;">Amount of data received through the virtual machine's network interface</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netTransmitted</td><td style="height: 29.7969px;">Amount of data transmitted through the virtual machine's network interface</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netPkgRx</td><td style="height: 29.7969px;">Number of network packets received through the virtual machine's network interface</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">netPkgTx</td><td style="height: 29.7969px;">Number of network packets transmitted over the virtual machine's network interface</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">snapshotCounter</td><td style="height: 29.7969px;">Number of snapshots of the virtual machine</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">snapshotDate</td><td style="height: 29.7969px;">Date of each snapshot</td></tr></tbody></table>

**Rename**

The renaming of entities is done through the RENAME token and allows to rename the entities discovered by the plugin. When using this functionality, the agents created in Pandora FMS will appear with the new assigned name. The structure of this section is as follows:

```
<current name> TO <new name>
```

An example of a configuration in this section could be the following:

```
 #Rename entities
 Rename
 Debian 11 TO Virtual Machine 1
 RedHat 12 TO Web server
 ESX Workstation TO Host Work Sales
```

**Header**

In header you can add a prefix to each agent name, which can be useful for a faster identification of these in pandora. The syntax of each block is :

```
dc <prefix>
ds <prefix>
esx <prefix>
vm <prefix>
```

An example may be the following :

```
dc DC_
ds DS_
esx ESXi_
vm VM_
```

In this example, all virtual machine agents would have a name with the following structure:

```
VM_<agent_name>
```

**Reject**

It is used to discard the monitoring of specific virtual machines or ESX, each entity to disable monitoring must be specified in the configuration file, below this block, in a different line for each entity.

An example can be the following:

```
Reject
gridNode
Vm_apx
Vm_acr
```

It is also used to disable the IP scanning of the agents, it is used with this parameter.

<table border="1" id="bkmrk-all_ipaddresses-disa" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>all\_ipaddresses</td><td>Disables scanning of IP addresses with value 1</td></tr></tbody></table>

**Example configuration file**

```
Configuration
server 192.168.80.36
datacenter ha-datacenter
user pandora
group Applications
use_encrypted_password 0
interval 300
pass HhVGFJk!H
threads 5
event_mode 0
retry_send 0
virtual_network_monitoring 0
recon_interval 300

monitor_exclusive_agents 0
exclusive_esx []
exclusive_datastores []
exclusive_vm []

scan_datastore 1
scan_datacenter 1
scan_esx 1
scan_vm 1

logfile /tmp/tmp_discovery.taskMD5.log
entities_list /tmp/tmp_discovery.taskMD5.entities
event_pointer_file /tmp/tmp_discovery.taskMD5.events
temporal /tmp
transfer_mode tentacle
tentacle_ip 127.0.0.1
tentacle_port 41121
tentacle_opts 
local_folder /var/spool/pandora/data_in
pandora_url http://127.0.0.1/pandora_console/
api_pass pandora
api_user admin
apipandorapass 1234

Rename
venger TO esx_venger
SSD100GB TO disk_store_1

Reject
gridNode
Vm_apx
Vm_acr
```

**About monitoring:**

<span style="text-decoration: underline;">Entity scan</span>

Due to the size of the VMware® infrastructures of the enterprise client, a general scan of all available entities in each run could trigger performance issues.

To avoid this situation, the VMware monitoring plug-in has the entity file ( entities\_list)where it stores the list of entities scanned in the first run).

As long as this file exists, monitoring will be limited to the entities indicated in the file.

<span style="text-decoration: underline;">Monitoring configuration</span>

The following sections of the file configure the modules created for each type of entity. These sections use the Datacenter, Datastore, ESX and VM sections. In these sections you can enable and disable the modules to be monitored. The following example contains a configuration according to the modules that would be created for ESX and virtual machines.

```
 ...
 #ESX Modules
 ESX
 cpuUsagePercent disabled
 diskRead enabled
 diskWrite enabled

 #VM Modules
 VM
 diskReadLatency disabled
 diskWriteLatency disabled
 diskRate enabled
 ...
```

Each configuration line is a module. Although in the example above, all modules are created with default values. You can configure the following values: 'Name', 'description' and 'limits' for the 'warning' and 'critical' states. An example of this type of configuration would look like the following:

```
 ...
 #VM Modules
 VM
 diskReadLatency disabled
 diskWriteLatency disabled
 diskRate name = Disk Rate; desc = Lec Rate/Esc disk; limits_warn = 5 10; limits_crit = 0 4
 ...
```

The available options for the module configuration are these:

&lt;module&gt; disabled: The module will NOT be created.  
&lt;module&gt; enabled: The module WILL be created (with default values)  
&lt;module&gt; name = &lt;name&gt;; desc = &lt;description&gt;; limits\_warn &lt;lim\_warn&gt;; limits\_crit &lt;lim\_crit&gt;"

Some modules when enabled in the plugin can generate multiple modules within their agents. For those cases when specifying a custom name for the module you can use the string "%s" to be replaced by an identifier of the element in each case. These modules and their identifiers are:

- ESX: 
    - cpuInfo: Index.
    - pciDevice:Device name
    - hbaDevice: Device name
    - pnicInfo: Device name
    - vnicInfo: Index.
    - systemHealthInfo: Sensor type and name
    - disksState: Device name
- VM: 
    - diskUsed: Disk name (if any) or index
    - macAddress: Index.
    - ipAddress: Index.
    - snapshotDate: Snapshot name.

**Use example**

```
#VM Modules
VM
diskUsed name = Disk %s Used Percentage ; desc = Disk Used %; limits_warn = 80 90; limits_crit = 90 100
```

The module will be created with the given name and description. The module will define thresholds for 'maximum' and 'minimum' for critical and warning states.

It is also possible to configure text strings for the limits of the Warning and Critical states of the Modules. The configuration would look like the following:

```
powerState name = Operating Status; desc = Operating Status VM; limits_warn = .*suspended.*; limits_crit = .*poweredOff.*
```

<span style="text-decoration: underline;">Custom Performance Metrics</span>

It is possible to configure new modules related to Performance Counters for virtual machines and ESX. To configure a new performance module you will need to use the following structure within the ESC or VM blocks of the configuration file:

```
custom_performance type = mem; metric = swapinRate; module_type = generic_data; name = Swap In Rate; desc = Swap In Rate for host; limits_warn = 0 0; limits_crit = 0 0
```

The parameters to be configured are:

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-09/scaled-1680-/uyvimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-09/uyvimage.png)

To see the complete list of all metrics according to their type you should click on the Advanced button and then on the Char option button. You will see a list with all the metric types and the respective metrics of each type:

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-09/scaled-1680-/52dimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-09/52dimage.png)

For each type of metric, a series of counters will appear, which are the variables that can be monitored with Pandora FMS. To monitor a variable we need its Internal Name. You should also make sure that the statistics level, configured in the vCenter, allows to show the variable we are looking for, comparing it with the Collection Level field of the metric.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-09/scaled-1680-/KIUimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-09/KIUimage.png)

For example, if you need to see the CPU usage of an ESX host, we will look for the cpu type variables for an ESX and from the available ones we will choose utilization. The line you have to add to the configuration file (in this case inside the ESX section) will be the following:

```
custom_performance type = cpu; metric = utilization; module_type = generic_data; name = CPU Utilization; desc = CPU Utilization for ESX; limits_warn = 0 0; limits_crit = 0 0
```

**VMware® virtual architecture management and visualization**

Two extensions are distributed together with the VMware® plug-in: VMware Manager® and VMware View®. VMware View® allows you to visualize all components of the VMware® architecture in a convenient way. In addition, with VMware Manager® you will be able to manage virtual machines by stopping, starting, resetting or suspending their activity from the Pandora FMS Console.

**Using VMware View**

To start using the VMware® architecture viewer go to Monitoring → VMware view.

If you do not have any device to monitor or you have not configured the vCenter® and ESXi VMware® API you will get something similar to the following image:

If the plugin is in operational state you will get this message (click the Show button):

   
The VMware View® extension will show you a map similar to the one below with the entire VMware® architecture.

The map contains the elements of the VMware® architecture (virtual machines, ESX, DataStores and DataCenters) with different icons that identify them, as well as the status of the Pandora FMS Agents that represent each element. In addition, the relationship between virtual machines, ESX and DataCenter is shown. In this way, at a glance you can see the status of the VMware® architecture in a simple way.

This extension has some options that help to improve the visualization of the architecture by hiding elements, increasing the font size and allowing to zoom in to see the elements in more detail.

Using the above options you can show only the DataCenter and ESX.

**VMware View Dashboards**

VMware View® provides two additional views in addition to the topology map view of the virtual architecture. The new tabs allow you to switch between the different views of the VMware View®.

The first view is a general dashboard where you can see at a glance the overall status of the virtual architecture in numbers, i.e. how many virtual machines, ESXi hosts or DataStores have problems. You will also be able to see general performance parameters thanks to graphs showing the 5 virtual machines that consume the most memory, CPU, disk and network of the entire virtual architecture.

The second view allows you to see the performance parameters of each ESX host. In this view you can choose an ESX host for which a dashboard will be loaded showing the status of the host and virtual machines, as well as performance metrics related to CPU, memory, disk and network usage of the ESXi host. In addition, this view also provides graphs showing the virtual machines that consume the most resources (CPU, memory, disk and network) on the selected host.

**VMware View Options Tab**

The VMWare extension is included together with Pandora FMS Console Enterprise. It has a configuration panel to set dashboard and map options:

You will be able to adjust the view thresholds (minimum - maximum) of the dashboard graphs.  
You can adjust the default map view settings.  
Contains a link to the configuration management system.  
Accessible from the VMWare View® options tab:

**Using the VMware Manager extension from Agents**

To use the VMware® Manager extension you must go to the operation view of an Agent that corresponds to a virtual machine in that architecture. Within this view you will see an icon with the VMware® symbol that corresponds to the extension.

The VMware® Manager extension allows to manage virtual machines from the Pandora FMS Console. The extension shows the current status of the virtual machine with a color code:

Green = On (virtual machine running).  
Orange = Suspended (virtual machine whose execution is paused).  
Gray = Stopped (virtual machine is not running).  
In addition, in a combo box it shows the available statuses and allows you to change the virtual machine status to the selected one by clicking on the Change Status button.

Selecting the Stop status and pressing Change status:

This will cause the virtual machine execution to stop and the VMware Manage extension view will change, thus showing that the virtual machine is now stopped:

  
   
If you have configured monitoring using RENAME this utility will not work against renamed targets.