pcm

Intel® Performance Counter Monitor (Intel® PCM)

What is pcm?

Intel® Performance Counter Monitor (Intel® PCM)

Overview of pcm

What it is

Intel® Performance Counter Monitor (Intel® PCM) is an application programming interface (API) and a set of tools based on the API to monitor performance and energy metrics of Intel® Core™, Xeon®, Atom™ and Xeon Phi™ processors. PCM works on Linux, Windows, FreeBSD, DragonFlyBSD and ChromeOS operating systems.

Key features

  • pcm: basic processor monitoring utility (instructions per cycle, core frequency including Intel® Turbo Boost Technology, memory and Intel® Quick Path Interconnect bandwidth, local and remote memory bandwidth, cache misses, core and CPU package sleep C-state residency, core and CPU package thermal headroom, cache utilization, CPU and memory energy consumption)
  • pcm-memory: monitor memory bandwidth per-channel and per-DRAM DIMM rank - pcm-accel: monitor Intel® In-Memory Analytics Accelerator (Intel® IAA), Intel® Data Streaming Accelerator (Intel® DSA) and Intel® QuickAssist Technology (Intel® QAT) accelerators - pcm-latency: monitor L1 cache miss and DDR/PMM memory latency - pcm-pcie and pcm-iio: monitor PCIe bandwidth per-socket and per PCIe bus/device - pcm-power: monitor sleep and energy states of processor, Intel® Quick Path Interconnect, DRAM memory, reasons of CPU frequency throttling and other energy-related metrics - pcm Grafana dashboard: graphical front-end for Grafana (in scripts/grafana directory)

Use cases

PCM tools are used for real-time monitoring of processor performance, energy consumption, memory bandwidth, accelerator utilization, memory latency, PCIe bandwidth, and power states. They can be applied in performance optimization, system troubleshooting, capacity planning, and data center energy efficiency analysis. The API allows integration into custom monitoring solutions.

Getting started

Clone the repository with submodules: git clone --recursive https://github.com/intel/pcm cd pcm Install cmake (and libasan on Linux), then build: cd build cmake .. cmake --build . For faster building, use --parallel. On Windows, additional drivers and steps are required (see WINDOWS_HOWTO.md). Pre-compiled packages are available for Linux distributions via package managers (e.g., sudo apt install pcm on Ubuntu/Debian). To run PCM tools under a non-root user on Linux, set /proc/sys/kernel/perf_event_paranoid to -1 and export PCM_NO_MSR=1 and PCM_KEEP_NMI_WATCHDOG=1.

License and pricing

The license is BSD-3-Clause. PCM is open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/intelpcm.svg)](https://yunodb.com/tools/intelpcm?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/intelpcm?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/intelpcm.svg" alt="Featured on YunoDB" height="20"></a>