Skip to main content

Xen XCP-ng

Plugin: xenstat.plugin Module: xenstat.plugin

Overview

This collector monitors XenServer and XCP-ng host and domains statistics.

This collector is supported on all platforms.

This collector supports collecting metrics from multiple instances of this integration, including remote instances.

The plugin needs setuid.

Default Behavior

Auto-Detection

This plugin requires the xen-dom0-libs-devel and yajl-devel libraries to be installed.

Limits

The default configuration for this integration does not impose any limits on data collection.

Performance Impact

The default configuration for this integration is not expected to impose a significant performance impact on the system.

Metrics

Metrics grouped by scope.

The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.

Per Xen XCP-ng instance

These metrics refer to the entire monitored application.

This scope has no labels.

Metrics:

MetricDimensionsUnit
xenstat.memfree, usedMiB
xenstat.domainsdomainsdomains
xenstat.cpuscpuscpus
xenstat.cpu_freqfrequencyMHz

Per xendomain

Metrics related to Xen domains. Each domain provides its own set of the following metrics.

This scope has no labels.

Metrics:

MetricDimensionsUnit
xendomain.statesrunning, blocked, paused, shutdown, crashed, dyingboolean
xendomain.cpuusedpercentage
xendomain.memmaximum, currentMiB
xendomain.vcpua dimension per vcpupercentage

Per xendomain vbd

Metrics related to Xen domain Virtual Block Device. Each VBD provides its own set of the following metrics.

This scope has no labels.

Metrics:

MetricDimensionsUnit
xendomain.oo_req_vbdrequestsrequests/s
xendomain.requests_vbdread, writerequests/s
xendomain.sectors_vbdread, writesectors/s

Per xendomain network

Metrics related to Xen domain network interfaces. Each network interface provides its own set of the following metrics.

This scope has no labels.

Metrics:

MetricDimensionsUnit
xendomain.bytes_networkreceived, sentkilobits/s
xendomain.packets_networkreceived, sentpackets/s
xendomain.errors_networkreceived, senterrors/s
xendomain.drops_networkreceived, sentdrops/s

Alerts

There are no alerts configured by default for this integration.

Setup

Prerequisites

Libraries

  1. Install xen-dom0-libs-devel and yajl-devel using the package manager of your system.

    Note: On Cent-OS systems you will need centos-release-xen repository and the required package for xen is xen-devel

  2. Re-install Netdata from source. The installer will detect that the required libraries are now available and will also build xenstat.plugin.

Configuration

File

The configuration file name for this integration is netdata.conf. Configuration for this specific integration is located in the [plugin:xenstat] section within that file.

The file format is a modified INI syntax. The general structure is:

[section1]
option1 = some value
option2 = some other value

[section2]
option3 = some third value

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config netdata.conf

Options

Config options
NameDescriptionDefaultRequired
update everyData collection frequency.1no

Examples

There are no configuration examples.


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.