aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAaron Smith <aasmith@redhat.com>2018-07-10 13:28:31 +0000
committerGerrit Code Review <gerrit@opnfv.org>2018-07-10 13:28:31 +0000
commit7fd9d03a8fbd3f4d51f353a985e56938316de4b1 (patch)
tree7a192ff0fbbc3fba0603fffb51b22ea34a4097af
parent713172689288535176369335fad0b008c43e590c (diff)
parent69fba6677df52a6f357935060732f404200a80c2 (diff)
Merge "docs: update userguide with new option for intel_pmu plugin"
-rw-r--r--docs/release/userguide/feature.userguide.rst10
-rw-r--r--src/collectd/collectd_sample_configs/intel_pmu.conf1
2 files changed, 11 insertions, 0 deletions
diff --git a/docs/release/userguide/feature.userguide.rst b/docs/release/userguide/feature.userguide.rst
index 55a248b9..eeec7a2e 100644
--- a/docs/release/userguide/feature.userguide.rst
+++ b/docs/release/userguide/feature.userguide.rst
@@ -413,6 +413,7 @@ include:
ReportHardwareCacheEvents true
ReportKernelPMUEvents true
ReportSoftwareEvents true
+ Cores ""
</Plugin>
If you want to monitor Intel CPU specific CPU events, make sure to enable the
@@ -426,12 +427,21 @@ additional two options shown below:
ReportSoftwareEvents true
EventList "$HOME/.cache/pmu-events/GenuineIntel-6-2D-core.json"
HardwareEvents "L2_RQSTS.CODE_RD_HIT,L2_RQSTS.CODE_RD_MISS" "L2_RQSTS.ALL_CODE_RD"
+ Cores ""
</Plugin>
.. note::
If you set XDG_CACHE_HOME to anything other than the variable above - you will need to modify
the path for the EventList configuration.
+Use "Cores" option to monitor metrics only for configured cores. If an empty string is provided
+as value for this field default cores configuration is applied - that is all available cores
+are monitored separately. To limit monitoring to cores 0-7 set the option as shown below:
+
+.. code:: bash
+
+ Cores "[0-7]"
+
For more information on the plugin parameters, please see:
https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod
diff --git a/src/collectd/collectd_sample_configs/intel_pmu.conf b/src/collectd/collectd_sample_configs/intel_pmu.conf
index db83e4bb..959fb8a1 100644
--- a/src/collectd/collectd_sample_configs/intel_pmu.conf
+++ b/src/collectd/collectd_sample_configs/intel_pmu.conf
@@ -19,4 +19,5 @@ LoadPlugin intel_pmu
ReportSoftwareEvents true
# EventList "/var/cache/pmu/GenuineIntel-6-2D-core.json"
# HardwareEvents "L2_RQSTS.CODE_RD_HIT,L2_RQSTS.CODE_RD_MISS" "L2_RQSTS.ALL_CODE_RD"
+ Cores "[0-4]"
</Plugin>