Citrix XenServer

This template contains performance and statistics counters to monitor PVS Accelerator metrics implemented in XenServer as a result of the integration of PVS Accelerator and XenServer.

Portions of this topic were originally created by and are excerpted from Citrix XenServer documentation (© 2019 Citrix Systems, Inc., available at https://docs.citrix.com, obtained on May 8, 2019):

Prerequisites

XenServer 7.5 or 7.6

Credentials

SSH Access to the Linux machine hosting XenServer 7.5 or 7.6.

Notes

Note the following details about this template:

  • Citrix Server is Linux based so this template runs against the Linux agent.
  • Some counters may require manual configuration, such as setting up installation-specific instances, correcting thresholds for the client’s environment, and so forth.

Each metric you want to monitor must be available in rrd2csv command output, executed directly on XenServer. If you don't find the required metric in that command output, then either that metric is not enabled or metric settings are not configured.

To find the list of metrics you can monitor, run the following command directly on the XenServer:

  • For host: xe host-data-source-list hostname=<XenServerHostname>
  • For VM: xe vm-data-source-list vm=<VirtualMachineName>

If the metric is returned in xe-host-data-source output, but not in rrd2csv command output, that indicates you need to enable the metric with the following command:

xe host-data-source-record data-source=metric name host=hostname

After running that command, the metric should appear in rrd2csv command output. If you still don't see the required metric in rrd2csv command output, the metric is not configured. Check with your XenServer/PVS administrator to configure the settings required for that metric.

Monitored Components

To learn more about default component monitors included in SAM, see SAM online help.

Host - Free Memory

This monitor provides the total amount of free memory on XenServer host.

Unit: MB

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Average CPU

This monitor provides the mean utilization of physical CPUs.

Unit: Percent

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Control Domain Load

This monitor provides the Domain0 load average.

Unit: Percent

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Reclaimed Memory

This monitor provides the host memory reclaimed by squeeze.

Unit: MB

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Potential Reclaimed Memory

This monitor provides the host memory available to reclaim with squeeze.

Unit: MB

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Total Memory

This monitor provides the total amount of memory in the host.

Unit: MB

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Total NIC Receive

This monitor provides the Bytes per second received on all physical interfaces.

Unit: Bytes per second

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Total NIC Send

This monitor provides the Bytes per second sent on all physical interfaces.

Unit: Bytes Per Second

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Agent Memory Allocation

This monitor provides the Memory allocation done by the XAPI daemon.

Unit: MB

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Agent Memory Usage

This monitor provides the total memory allocated used by XAPI daemon.

Unit: MB

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Agent Memory Free

This monitor provides the Free memory available to the XAPI daemon.

Unit: MB

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Agent Memory Live

This monitor provides the Live memory used by XAPI daemon.

Unit: MB

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Physical Interface Receive

This monitor provides the Bytes per second received on physical interface (PIF).

Unit: Bytes per Second

Inputs: XenServer host name, Physical Interface Name

Condition: PIF exists

Host - Physical Interface Sent

This monitor provides the Bytes per second sent by physical interface (PIF).

Unit: Bytes per Second

Inputs: XenServer host name, Physical Interface Name

Condition: PIF exists

Host - Physical Interface Receive Error

This monitor provides the errors on physical Interface (PIF).

Unit: Count

Inputs: XenServer host name, Physical Interface Name

Condition: PIF exists

Host - Physical Interface Send Error

This monitor provides the errors by physical Interface (PIF).

Unit: Count

Inputs: XenServer host name, Physical Interface Name

Condition: PIF exists

Host - Storage Repository Cache Size

This monitor provides the cache size of the IntelliCache Storage Repository.

Unit: MB

Inputs: XenServer host name, Storage Repository Name

Condition: IntelliCache Enabled

Host - Storage Repository Cache Hits

This monitor provides the cache hits per second for that given Storage Repository.

Unit: Count

Inputs: XenServer host name, Storage Repository Name

Condition: IntelliCache Enabled

Host - Storage Repository Cache Misses

This monitor provides cache misses per second for the given Storage Repository.

Unit: Count

Inputs: XenServer host name, Storage Repository Name

Condition: IntelliCache Enabled

Host - Storage Repository Inflight Requests

This monitor provides the number of I/O requests currently in flight.

Unit: Count

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository Read Throughput

This monitor provides the data read from the given storage repository.

Unit: MiB/Second

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository Write Throughput

This monitor provides the data written to the given storage repository.

Unit: MiB/Second

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host Storage Repository Total Throughput

This monitor provides the all data(read/write) for the given storage repository.

Unit: MiB/Second

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host Storage Repository Write IOPS

This monitor provides the Write requests per second.

Unit: Count

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository Read IOPS

This monitor provides the Read requests per second.

Unit: Count

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository Total IOPS

This monitor provides the total (Read/Write) I/O requests per second.

Unit: Count

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository I/O Wait

This monitor provides the percentage of the time waiting for I/O.

Unit: Percent

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository Read Latency

This monitor provides the read latency for the given Storage Repository.

Unit: Milliseconds

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository Write Latency

This monitor provides the write latency for the given Storage Repository.

Unit: Milliseconds

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository Total Latency

This monitor provides the total (Read/Write) latency for the given Storage Repository.

Unit: Milliseconds

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - CPU C State

This monitor provides the time during which the given CPU spent in the given C-state.

Unit: Milliseconds

Input: XenServer host name, CPU name, CPU C state

Condition: C-state exists on CPU

Host - CPU P State

This monitor provides the time during which the given CPU spent in the given P-state.

Unit: Milliseconds

Input: XenServer host name, CPU name, CPU C state

Condition: P-state exists on CPU

Host - CPU Utilization

This monitor provides the utilization for the given CPU.

Unit: Percent

Input: XenServer host name, CPU name

Condition: CPU <CPU Name > exists

Host - HA Statefile Latency

This monitor provides the Turn-around time in seconds of the latest State-File access from the local host.

Unit: Seconds

Input: XenServer host name, Statefile UUID

Condition: HA Enabled

To find the Statefile UUID, run the following command on the XenServer: xe host-param-list uuid=<uuid of the XenServer host resting statefile>

Host - Tapdisks_in_low_memory_mode

This monitor provides the tap disks count in low memory mode.

Unit: Count

Input: XenServer host name for which data has to be fetched

Condition: None

Host - Storage Repository Write

This monitor provides the data Writes from the given storage repository.

Unit: MB/second

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Storage Repository Read

This monitor provides the data Read from the given storage repository.

Unit: MB/second

Inputs: XenServer host name, Storage Repository Name

Condition: At least one plugged Virtual Block Disk (VBD) in given Storage Repository on the given host

Host - Xapi Open FDS

This monitor provides the number of open file descriptors held by xapi.

Unit: Count

Inputs: XenServer host name for which data has to be fetched

Condition: None

Host - Pool Task Count

This monitor provides the number of tasks for the given host.

Unit: Count

Inputs: XenServer host name for which data has to be fetched

Condition: None

Host - Pool Session Count

This monitor provides the number of sessions for the given host.

Unit: Count

Inputs: XenServer host name for which data has to be fetched

Condition: None

VM - CPU Utilization

This monitor provides the CPU utilization of the given vCPU for the given VM.

Unit: Percent

Inputs: Virtual Machine Name, CPU Name

Condition: vCPU <CPU Name> exists

VM - Total Memory

This monitor provides the Memory currently allocated to the given VM.

Unit: MB

Inputs: Virtual Machine Name

Condition: None

VM - Memory Target

This monitor provides the Target of VM balloon driver.

Unit: MB

Inputs: Virtual Machine Name

Condition: None

VM - Free Memory

This monitor provides the Memory used as reported by the guest agent.

Unit: MB

Inputs: Virtual Machine Name

Condition: None

VM - vCPUs Full Run

This monitor provides the fraction of time that all vCPUs are running.

Unit: Fraction

Inputs: Virtual Machine Name

Condition: None

VM - vCPUs Full Contention

This monitor provides the fraction of time that all vCPUs are runnable (that is, waiting for CPU).

Unit: Fraction

Inputs: Virtual Machine Name

Condition: None

VM - vCPUs Concurrency Hazard

This monitor provides the fraction of time that some vCPUs are running and some are runnable.

Unit: Fraction

Inputs: Virtual Machine Name

Condition: None

VM - vCPUs Idle

This monitor provides the fraction of time that all vCPUs are blocked or offline.

Unit: Fraction

Inputs: Virtual Machine Name

Condition: None

VM - vCPUs Partial Run

This monitor provides the fraction of time that some vCPUs are running, and some are blocked.

Unit: Fraction

Inputs: Virtual Machine Name

Condition: None

VM - vCPUs Partial Contention

This monitor provides the fraction of time that some vCPUs are runnable and some are blocked.

Unit: Fraction

Inputs: Virtual Machine Name

Condition: None

VM - Disk Write

This monitor provides the speed with which data is written to the given disk.

Unit: Bytes Per Second

Inputs: Virtual Machine Name, Disk Name

Condition: Virtual Block Disk exists

VM - Disk Read

This monitor provides the speed with which data is read from the given disk.

Unit: Bytes Per Second

Inputs: Virtual Machine Name, Disk Name

Condition: Virtual Block Disk exists

VM - Disk Write Latency

This monitor provides the Write time to the given disk.

Unit: Milliseconds

Inputs: Virtual Machine Name, Disk Name

Condition: Virtual Block Disk exists

VM - Disk Read Latency

This monitor provides the Read time from the given disk.

Unit: Milliseconds

Inputs: Virtual Machine Name, Disk Name

Condition: Virtual Block Disk exists

VM - Disk Read IOPs

This monitor provides the Read requests per second for the given disk.

Unit: Count Per Second

Inputs: Virtual Machine Name, Disk Name

Condition: At least one plugged Virtual Block Disk for non-ISO VDI on the host

VM - Disk Write IOPs

This monitor provides the Write requests per second for the given disk.

Unit: Count Per Second

Inputs: Virtual Machine Name, Disk Name

Condition: At least one plugged Virtual Block Disk for non-ISO VDI on the host

VM - Disk Total IOPs

This monitor provides the Total (Read/Write) requests per second for the given disk.

Unit: Count Per Second

Inputs: Virtual Machine Name, Disk Name

Condition: At least one plugged Virtual Block Disk for non-ISO VDI on the host

VM - Disk IO Wait

This monitor provides the Percentage of time waiting for I/0 for the given disk.

Unit: Percent

Inputs: Virtual Machine Name, Disk Name

Condition: At least one plugged Virtual Block Disk for non-ISO VDI on the host

VM - Disk Inflight Requests

This monitor provides the number of I/O requests currently in flight for the given disk.

Unit: Count

Inputs: Virtual Machine Name, Disk Name

Condition: At least one plugged Virtual Block Disk for non-ISO VDI on the host

VM - Disk IO Throughput Total

This monitor provides the All I/O for the given Virtual Disk Image (VDI).

Unit: MiB/s

Inputs: Virtual Machine Name, Disk Name

Condition: At least one plugged Virtual Block Disk for non-ISO VDI on the host

VM - Disk IO Throughput Write

This monitor provides the Data written to the given Virtual Disk Image (VDI).

Unit: MiB/s

Inputs: Virtual Machine Name, Disk Name

Condition: At least one plugged Virtual Block Disk for non-ISO VDI on the host

VM - Disk IO Throughput Read

This monitor provides the Data read from the given Virtual Disk Image (VDI).

Unit: MiB/s

Inputs: Virtual Machine Name, Disk Name

Condition: At least one plugged Virtual Block Disk for non-ISO VDI on the host

VM – VIF Receive

This monitor provides the Bytes per second received on the given virtual interface number.

Unit: Bytes Per Second

Inputs: Virtual Machine Name, Interface ID

Condition: VIF ID exists

VM – VIF Send

This monitor provides the Bytes per second transmitted on given virtual interface.

Unit: Bytes Per Second

Inputs: Virtual Machine Name, Interface ID

Condition: VIF ID exists

VM – VIF Receive Errors

This monitor provides the Receive errors per second on the given virtual interface.

Unit: Count Per Second

Inputs: Virtual Machine Name, Interface ID

Condition: VIF ID exists

VM – VIF Send Errors

This monitor provides the Transmitted errors per second on the given virtual interface.

Unit: Count Per Second

Inputs: Virtual Machine Name, Interface ID

Condition: VIF ID exists