intel_powerstat

package
v1.27.4 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 21, 2023 License: MIT Imports: 19 Imported by: 0

README

Intel PowerStat Input Plugin

This input plugin monitors power statistics on Intel-based platforms and assumes presence of Linux based OS.

Main use cases are power saving and workload migration. Telemetry frameworks allow users to monitor critical platform level metrics. Key source of platform telemetry is power domain that is beneficial for MANO Monitoring&Analytics systems to take preventive/corrective actions based on platform busyness, CPU temperature, actual CPU utilization and power statistics.

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# Intel PowerStat plugin enables monitoring of platform metrics (power, TDP)
# and per-CPU metrics like temperature, power and utilization.
# This plugin ONLY supports Linux
[[inputs.intel_powerstat]]
  ## The user can choose which package metrics are monitored by the plugin with
  ## the package_metrics setting:
  ## - The default, will collect "current_power_consumption",
  ##   "current_dram_power_consumption" and "thermal_design_power"
  ## - Leaving this setting empty means no package metrics will be collected
  ## - Finally, a user can specify individual metrics to capture from the
  ##   supported options list
  ## Supported options:
  ##   "current_power_consumption", "current_dram_power_consumption",
  ##   "thermal_design_power", "max_turbo_frequency", "uncore_frequency",
  ##   "cpu_base_frequency"
  # package_metrics = ["current_power_consumption", "current_dram_power_consumption", "thermal_design_power"]

  ## The user can choose which per-CPU metrics are monitored by the plugin in
  ## cpu_metrics array.
  ## Empty or missing array means no per-CPU specific metrics will be collected
  ## by the plugin.
  ## Supported options:
  ##   "cpu_frequency", "cpu_c0_state_residency", "cpu_c1_state_residency",
  ##   "cpu_c6_state_residency", "cpu_busy_cycles", "cpu_temperature",
  ##   "cpu_busy_frequency"
  ## ATTENTION: cpu_busy_cycles is DEPRECATED - use cpu_c0_state_residency
  # cpu_metrics = []

Example: Configuration with no per-CPU telemetry

This configuration allows getting default processor package specific metrics, no per-CPU metrics are collected:

[[inputs.intel_powerstat]]
  cpu_metrics = []

Example: Configuration with no per-CPU telemetry - equivalent case

This configuration allows getting default processor package specific metrics, no per-CPU metrics are collected:

[[inputs.intel_powerstat]]

Example: Configuration for CPU Temperature and CPU Frequency

This configuration allows getting default processor package specific metrics, plus subset of per-CPU metrics (CPU Temperature and CPU Frequency):

[[inputs.intel_powerstat]]
  cpu_metrics = ["cpu_frequency", "cpu_temperature"]

Example: Configuration for CPU Temperature and CPU Frequency without default package metrics

This configuration allows getting only a subset of per-CPU metrics (CPU Temperature and CPU Frequency):

[[inputs.intel_powerstat]]
  package_metrics = []
  cpu_metrics = ["cpu_frequency", "cpu_temperature"]

Example: Configuration with all available metrics

This configuration allows getting all processor package specific metrics and all per-CPU metrics:

[[inputs.intel_powerstat]]
  package_metrics = ["current_power_consumption", "current_dram_power_consumption", "thermal_design_power", "max_turbo_frequency", "uncore_frequency"]
  cpu_metrics = ["cpu_frequency", "cpu_busy_frequency", "cpu_temperature", "cpu_c0_state_residency", "cpu_c1_state_residency", "cpu_c6_state_residency"]

SW Dependencies

Plugin is based on Linux Kernel modules that expose specific metrics over sysfs or devfs interfaces. The following dependencies are expected by plugin:

  • intel-rapl module which exposes Intel Runtime Power Limiting metrics over sysfs (/sys/devices/virtual/powercap/intel-rapl),
  • msr kernel module that provides access to processor model specific registers over devfs (/dev/cpu/cpu%d/msr),
  • cpufreq kernel module - which exposes per-CPU Frequency over sysfs (/sys/devices/system/cpu/cpu%d/cpufreq/scaling_cur_freq).
  • intel-uncore-frequency module exposes Intel uncore frequency metrics over sysfs (/sys/devices/system/cpu/intel_uncore_frequency),

Minimum kernel version required is 3.13 to satisfy most of requirements, for uncore_frequency metrics intel-uncore-frequency module is required (available since kernel 5.6).

Please make sure that kernel modules are loaded and running (cpufreq is integrated in kernel). Modules might have to be manually enabled by using modprobe. Depending on the kernel version, run commands:

# kernel 5.x.x:
sudo modprobe rapl
sudo modprobe msr
sudo modprobe intel_rapl_common
sudo modprobe intel_rapl_msr

# also for kernel >= 5.6.0
sudo modprobe intel-uncore-frequency

# kernel 4.x.x:
sudo modprobe msr
sudo modprobe intel_rapl

Telegraf with Intel PowerStat plugin enabled may require root access to read model specific registers (MSRs) to retrieve data for calculation of most critical per-CPU specific metrics:

  • cpu_busy_frequency_mhz
  • cpu_temperature_celsius
  • cpu_c0_state_residency_percent
  • cpu_c1_state_residency_percent
  • cpu_c6_state_residency_percent

and to retrieve data for calculation per-package specific metric:

  • max_turbo_frequency_mhz
  • uncore_frequency_mhz_cur
  • cpu_base_frequency_mhz

To expose other Intel PowerStat metrics root access may or may not be required (depending on OS type or configuration).

HW Dependencies

Specific metrics require certain processor features to be present, otherwise Intel PowerStat plugin won't be able to read them. When using Linux Kernel based OS, user can detect supported processor features reading /proc/cpuinfo file. Plugin assumes crucial properties are the same for all CPU cores in the system. The following processor properties are examined in more detail in this section: processor cpu family, model and flags. The following processor properties are required by the plugin:

  • Processor cpu family must be Intel (0x6) - since data used by the plugin assumes Intel specific model specific registers for all features
  • The following processor flags shall be present:
    • "msr" shall be present for plugin to read platform data from processor model specific registers and collect the following metrics: powerstat_core.cpu_temperature, powerstat_core.cpu_busy_frequency, powerstat_core.cpu_c0_state_residency, powerstat_core.cpu_c1_state_residency, powerstat_core.cpu_c6_state_residency
    • "aperfmperf" shall be present to collect the following metrics: powerstat_core.cpu_busy_frequency, powerstat_core.cpu_c0_state_residency, powerstat_core.cpu_c1_state_residency
    • "dts" shall be present to collect powerstat_core.cpu_temperature
  • Processor Model number must be one of the following values for plugin to read powerstat_core.cpu_c1_state_residency / powerstat_core.cpu_c6_state_residency and powerstat_package.cpu_base_frequency metrics:
Model number Processor name
0x37 Intel Atom® Bay Trail
0x4D Intel Atom® Avaton
0x5C Intel Atom® Apollo Lake
0x5F Intel Atom® Denverton
0x7A Intel Atom® Goldmont
0x4C Intel Atom® Airmont
0x86 Intel Atom® Jacobsville
0x96 Intel Atom® Elkhart Lake
0x9C Intel Atom® Jasper Lake
0x1A Intel Nehalem-EP
0x1E Intel Nehalem
0x1F Intel Nehalem-G
0x2E Intel Nehalem-EX
0x25 Intel Westmere
0x2C Intel Westmere-EP
0x2F Intel Westmere-EX
0x2A Intel Sandybridge
0x2D Intel Sandybridge-X
0x3A Intel Ivybridge
0x3E Intel Ivybridge-X
0x4E Intel Atom® Silvermont-MID
0x5E Intel Skylake
0x55 Intel Skylake-X
0x8E Intel KabyLake-L
0x9E Intel KabyLake
0x6A Intel IceLake-X
0x6C Intel IceLake-D
0x7D Intel IceLake
0x7E Intel IceLake-L
0x9D Intel IceLake-NNPI
0x3C Intel Haswell
0x3F Intel Haswell-X
0x45 Intel Haswell-L
0x46 Intel Haswell-G
0x3D Intel Broadwell
0x47 Intel Broadwell-G
0x4F Intel Broadwell-X
0x56 Intel Broadwell-D
0x66 Intel CannonLake-L
0x57 Intel Xeon® PHI Knights Landing
0x85 Intel Xeon® PHI Knights Mill
0xA5 Intel CometLake
0xA6 Intel CometLake-L
0x8A Intel Lakefield
0x8F Intel Sapphire Rapids X
0x8C Intel TigerLake-L
0x8D Intel TigerLake
0xA7 Intel RocketLake
0x97 Intel AlderLake
0x9A Intel AlderLake-L
0xBE Intel AlderLake-N
0xB7 Intel RaptorLake
0xBA Intel RaptorLake-P
0xBF Intel RaptorLake-S
0xAC Intel MeteorLake
0xAA Intel MeteorLake-L

Metrics

All metrics collected by Intel PowerStat plugin are collected in fixed intervals. Metrics that reports processor C-state residency or power are calculated over elapsed intervals. When starting to measure metrics, plugin skips first iteration of metrics if they are based on deltas with previous value.

The following measurements are supported by Intel PowerStat plugin:

  • powerstat_core

    • The following Tags are returned by plugin with powerstat_core measurements:

      Tag Description
      package_id ID of platform package/socket
      core_id ID of physical processor core
      cpu_id ID of logical processor core

    Measurement powerstat_core metrics are collected per-CPU (cpu_id is the key) while core_id and package_id tags are additional topology information.

    • Available metrics for powerstat_core measurement

      Metric name (field) Description Units
      cpu_frequency_mhz Current operational frequency of CPU Core MHz
      cpu_busy_frequency_mhz CPU Core Busy Frequency measured as frequency adjusted to CPU Core busy cycles MHz
      cpu_temperature_celsius Current temperature of CPU Core Celsius degrees
      cpu_c0_state_residency_percent Percentage of time that CPU Core spent in C0 Core residency state %
      cpu_c1_state_residency_percent Percentage of time that CPU Core spent in C1 Core residency state %
      cpu_c6_state_residency_percent Percentage of time that CPU Core spent in C6 Core residency state %
      cpu_busy_cycles_percent (DEPRECATED - superseded by cpu_c0_state_residency_percent) CPU Core Busy cycles as a ratio of Cycles spent in C0 state residency to all cycles executed by CPU Core %

  • powerstat_package

    • The following Tags are returned by plugin with powerstat_package measurements:

      Tag Description
      package_id ID of platform package/socket
      active_cores Specific tag for max_turbo_frequency_mhz metric. The maximum number of activated cores for reachable turbo frequency
      die Specific tag for all uncore_frequency metrics. Id of die
      type Specific tag for all uncore_frequency metrics. Type of uncore frequency (current or initial)

    Measurement powerstat_package metrics are collected per processor package package_id tag indicates which package metric refers to.

    • Available metrics for powerstat_package measurement

      Metric name (field) Description Units
      thermal_design_power_watts Maximum Thermal Design Power (TDP) available for processor package Watts
      current_power_consumption_watts Current power consumption of processor package Watts
      current_dram_power_consumption_watts Current power consumption of processor package DRAM subsystem Watts
      max_turbo_frequency_mhz Maximum reachable turbo frequency for number of cores active MHz
      uncore_frequency_limit_mhz_min Minimum uncore frequency limit for die in processor package MHz
      uncore_frequency_limit_mhz_max Maximum uncore frequency limit for die in processor package MHz
      uncore_frequency_mhz_cur Current uncore frequency for die in processor package. Available only with tag current. Since this value is not yet available from intel-uncore-frequency module it needs to be accessed via MSR. In case of lack of loaded msr, only uncore_frequency_limit_mhz_min and uncore_frequency_limit_mhz_max metrics will be collected MHz
      cpu_base_frequency_mhz CPU Base Frequency (maximum non-turbo frequency) for the processor package MHz
Known issues

From linux kernel version v5.4.77 with this kernel change resources like /sys/class/powercap/intel-rapl*/*/energy_uj are readable only by root for security reasons, so this plugin needs root privileges to work properly.

If such strict security restrictions are not relevant, reading permissions to files in /sys/devices/virtual/powercap/intel-rapl/ directory can be manually changed for example with chmod command with custom parameters. For example to give all users permission to all files in intel-rapl directory:

sudo chmod -R a+rx /sys/devices/virtual/powercap/intel-rapl/

Example Output

powerstat_package,host=ubuntu,package_id=0 thermal_design_power_watts=160 1606494744000000000
powerstat_package,host=ubuntu,package_id=0 current_power_consumption_watts=35 1606494744000000000
powerstat_package,host=ubuntu,package_id=0 cpu_base_frequency_mhz=2400i 1669118424000000000
powerstat_package,host=ubuntu,package_id=0 current_dram_power_consumption_watts=13.94 1606494744000000000
powerstat_package,host=ubuntu,package_id=0,active_cores=0 max_turbo_frequency_mhz=3000i 1606494744000000000
powerstat_package,host=ubuntu,package_id=0,active_cores=1 max_turbo_frequency_mhz=2800i 1606494744000000000
powerstat_package,die=0,host=ubuntu,package_id=0,type=initial uncore_frequency_limit_mhz_min=800,uncore_frequency_limit_mhz_max=2400 1606494744000000000
powerstat_package,die=0,host=ubuntu,package_id=0,type=current uncore_frequency_mhz_cur=800i,uncore_frequency_limit_mhz_min=800,uncore_frequency_limit_mhz_max=2400 1606494744000000000
powerstat_core,core_id=0,cpu_id=0,host=ubuntu,package_id=0 cpu_frequency_mhz=1200.29 1606494744000000000
powerstat_core,core_id=0,cpu_id=0,host=ubuntu,package_id=0 cpu_temperature_celsius=34i 1606494744000000000
powerstat_core,core_id=0,cpu_id=0,host=ubuntu,package_id=0 cpu_c6_state_residency_percent=92.52 1606494744000000000
powerstat_core,core_id=0,cpu_id=0,host=ubuntu,package_id=0 cpu_c1_state_residency_percent=6.68 1606494744000000000
powerstat_core,core_id=0,cpu_id=0,host=ubuntu,package_id=0 cpu_c0_state_residency_percent=0.8 1606494744000000000
powerstat_core,core_id=0,cpu_id=0,host=ubuntu,package_id=0 cpu_busy_frequency_mhz=1213.24 1606494744000000000

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type PowerStat 

type PowerStat struct {
	CPUMetrics     []string        `toml:"cpu_metrics"`
	PackageMetrics []string        `toml:"package_metrics"`
	Log            telegraf.Logger `toml:"-"`
	// contains filtered or unexported fields
}

PowerStat plugin enables monitoring of platform metrics (power, TDP) and Core metrics like temperature, power and utilization.

func (*PowerStat) Gather 

func (p *PowerStat) Gather(acc telegraf.Accumulator) error

Gather takes in an accumulator and adds the metrics that the Input gathers

func (*PowerStat) GetCPUIDFromSocketID added in v1.26.0 

func (p *PowerStat) GetCPUIDFromSocketID(socketID string) (string, error)

func (*PowerStat) Init 

func (p *PowerStat) Init() error

Init performs one time setup of the plugin

func (*PowerStat) SampleConfig 

func (*PowerStat) SampleConfig() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.