From 6facb2d37042ea8f189300e07dd97ba0ad6492ad Mon Sep 17 00:00:00 2001 From: "Mytnyk, VolodymyrX" Date: Wed, 8 Feb 2017 16:01:05 +0000 Subject: VES plugin: update to latest VES event schema - Updated the plugin to lates VES schema - Migrated VES plugin to python3 (with backward compatibility) - Fixed issue with CPU total calculation - Fixed VES documentation Change-Id: Ic8b0419146a9c75a48907f39adda1351f3b3bc73 Signed-off-by: Mytnyk, VolodymyrX --- docs/release/userguide/collectd.ves.userguide.rst | 41 ++++++++++++++--------- 1 file changed, 26 insertions(+), 15 deletions(-) (limited to 'docs/release') diff --git a/docs/release/userguide/collectd.ves.userguide.rst b/docs/release/userguide/collectd.ves.userguide.rst index 3cf26004..7ed6be9e 100644 --- a/docs/release/userguide/collectd.ves.userguide.rst +++ b/docs/release/userguide/collectd.ves.userguide.rst @@ -61,36 +61,42 @@ REST resources are of the form: {ServerRoot}/eventListener/v{apiVersion}/{topicName}` {ServerRoot}/eventListener/v{apiVersion}/eventBatch` - **Domain** *"host"* -* VES domain name. It can be IP address or hostname of VES collector -(default: `127.0.0.1`) + VES domain name. It can be IP address or hostname of VES collector + (default: `127.0.0.1`) **Port** *port* -* VES port (default: `30000`) + VES port (default: `30000`) **Path** *"path"* -* Used as the "optionalRoutingPath" element in the REST path (default: `empty`) + Used as the "optionalRoutingPath" element in the REST path (default: `empty`) **Topic** *"path"* -* Used as the "topicName" element in the REST path (default: `empty`) + Used as the "topicName" element in the REST path (default: `empty`) **UseHttps** *true|false* -* Allow plugin to use HTTPS instead of HTTP (default: `false`) + Allow plugin to use HTTPS instead of HTTP (default: `false`) **Username** *"username"* -* VES collector user name (default: `empty`) + VES collector user name (default: `empty`) **Password** *"passwd"* -* VES collector password (default: `empty`) + VES collector password (default: `empty`) **FunctionalRole** *"role"* -* Used as the 'functionalRole' field of 'commonEventHeader' event (default: -`Collectd VES Agent`) + Used as the 'functionalRole' field of 'commonEventHeader' event (default: + `Collectd VES Agent`) **GuestRunning** *true|false* -* This option is used if the collectd is running on a guest machine, e.g this -option should be set to `true` in this case. Defaults to `false`. + This option is used if the collectd is running on a guest machine, e.g this + option should be set to `true` in this case. Defaults to `false`. + +**SendEventInterval** *interval* + This configuration option controls how often (sec) collectd data is sent to + Vendor Event Listener (default: `20`) + +**ApiVersion** *version* + Used as the "apiVersion" element in the REST path (default: `1`) Other collectd.conf configurations ---------------------------------- @@ -100,7 +106,6 @@ Please ensure that FQDNLookup is set to false FQDNLookup false - Please ensure that the virt plugin is enabled and configured as follows. This configuration is is required only on a host side ('GuestRunning' = false). @@ -125,7 +130,11 @@ Please ensure that the cpu plugin is enabled and configured as follows ValuesPercentage true +**Note**: The `ReportByCpu` option should be set to `true` (default) if VES pugin +is running on guest machine ('GuestRunning' = true). + Please ensure that the aggregation plugin is enabled and configured as follows +(required if 'GuestRunning' = true) .. code:: bash @@ -146,7 +155,9 @@ If plugin is running on a guest side, it is important to enable uuid plugin too. In this case the hostname in event message will be represented as UUID instead of system host name. -LoadPlugin uuid +.. code:: bash + + LoadPlugin uuid If custom UUID needs to be provided, the following configuration is required in collectd.conf file: -- cgit 1.2.3-korg