202403 Release

Release Notes

New Features

• pcm: implement alternative metrics option -m (UTIL=C0 residency for cores, CFREQ=core frequency in GHz) and make it default by Roman Dementiev
• provide experimental kubernetes manifest by Pat Riehecky
• grafana scripts: use network instead of link and to use podman or docker by Vimal Kumar

Improvements

• Hardened binaries with "-Wl,-z,now" option on Linux by opcm
• pcm-raw: fall-back to older stepping PMURegisterDeclarations if available by Roman Dementiev
• Detect UPI LL PMUs on SPR/EMR through uncore PMU discovery and detect IMC PMUs on SPR/EMR through uncore PMU discovery by Roman Dementiev
• Use larger (1Gbyte) buffer in memoptest to increase LLC miss rate by Roman Dementiev
• grafana script enhancements by Roman Dementiev

Fixes

• Fixed parameter parsing in pcm-sensor-server by Roman Dementiev
• Fix: Accessing member of deleted objects by scuzqy
• Addressed issue #665 - Windows MSR driver compilation error by Roman Dementiev

202401 Release

Release Notes:

New Features

• Added Emerald Rapids processor support (Alexander Antonov and Roman Dementiev)
• Added support for TMA Level 2 metrics on SPR+ (Roman Dementiev)
• Added support of PP0 and PP1 energy metrics (Roman Dementiev)
• Added -c option (corelist) to pcm-numa and pcm-msr utilites (Duane E Galbi)
• pcm-msr new options added: iterate with seconds between each iteration and write results of each iteration to file (Duane E Galbi)
• Added support for pcm-sensor-server metric exporter/service on OSX (Roman Dementiev)

Improvements

• Removed hardcoded value for max supported sockets in pcm-iio tool (Alexander Antonov)
• Rely on CPUID leaf 0x1F topology info when available (Roman Dementiev)

Fixes

• Ensured PcmMsrClient on OSX can only be opened by root (HaoYan Qi)
• Fixed codeQL warnings (Roman Dementiev)
• Addressed issue with exceptions in msr.sys (Roman Dementiev)

Dependencies

• Bumped fedora from 37 to 39 in docker container (dependabot)

202311 Release

Release Notes

New Features

• Support for Sapphire Rapids accelerators in pcm-grafana dashboard. (Pavithran Pandiyan)
• Added support of Sapphire Rapids MCC CPUs in pcm-iio tool. (Alexander Antonov)
• Added support for M3UPI PMU for Sapphire Rapids. (Dementiev, Roman)
• Added new tool to access TPMI registers: pcm-tpmi (Dementiev, Roman)
• Added support for mmio register reads in pcm-raw tool. (Dementiev, Roman)
• pcm-raw now supports ha pmu and added invert,anythread,nc,isoc,opc and state emon event modifiers. (Dementiev, Roman)
• New script for filtering data in CSV. (Dementiev, Roman)
• Added bit operations for pcm register tools: pcm-msr, pcm-pcicfg, pcm-mmio (Dementiev, Roman)

Improvements

• Updated windows-related documentation. (Dementiev, Roman)
• Added instructions for compiling windows driver. (QiongwenXu)
• pcm-raw: Add PCU PMU declaration for BDX/SKX/CLX/CPX and document pcicfg register events (Dementiev, Roman)
• pcm-raw: remove the max number of event restrictions for register events (Dementiev, Roman)

Bug Fixes

• Fixed deadlock in processDVSEC. (Dementiev, Roman)
• Fixed race condition in isHWTMAL1Supported. (Dementiev, Roman)
• Fixed a clang scan warning. (Dementiev, Roman)
• Fixed the docker name for Grafana in start.sh. (Mike Yang)
• Fixed an issue in getMaxNumOfCBoxes to allow the fall-back perf API method to be called. (Dementiev, Roman)
• Fixed an issue with pcicfg reg syntax documentation. (opcm)
• Fixed an issue in pcm-accel to avoid confusion when overflow happens. (White Hu)
• Added exception handling in utils.cpp:get_cpu_bus(). (Steffen Persvold)
• Fix pcm for PCU and MDF: IO read size is data size (xuqiongwen-ms)

Other Changes

• DLL-related code enhancements (Dementiev, Roman)
• Added PCM_NO_MAIN_EXCEPTION_HANDLER variable. (Dementiev, Roman)

202307 Release

Release Notes

• pcm-memory and grafana dashboard: support CXL bandwidth monitoring on Sapphire Rapids
• pcm-raw: support collection for MSR and PCICFG (CSR) registers in csv format
• pcm-mmio: support dumps for memory regions
• pcm-raw: additional CPU model/steppings supported (CPX, SPR)
• pcm-pcicfg: support PCICFG register lookup/search by device ID
• documentation updates (how to run under non-root user, CXL monitoring, pcm-accel IAA, DSA, QAT, pcm-raw register monitoring)
• addressed CVE-2023-34351
• bug fixes

202302 Release

Release Notes

• pcm-accel: support monitoring of Intel® QuickAssist Technology (QAT) performance metrics
• grafana: support grafana dashboards with multiple hosts (with host selector) and fix UPI charts
• grafana: added dram pmem bandwidth and their ratio to grafana charts
• added python script to automate the generation of summary reports from pcm csv
• added backtrace info with signal SEGV for better debugability
• pcm-pcie: fix issues with delay parameter
• pcm-raw: validate counter event restrictions
• pcm-raw: initial support of hybrid cpus
• added LLCRDMISSLAT metric support for SPR
• added support for Gemini Lake
• added support memory bandwidth metrics for more ADL&TGL CPU models
• added systemd unit for Linux systems
• pcm-sensor-server: enhanced error handling in close, setSocket and sync calls
• avoid using errata events on older processors
• pcm-sensor-server: implement -force-rtm-abort-mode option

202212 Release

Release Notes:

• pcm-memory: add SPR HBM support
• support multiple hosts for Grafana dashboard with prometheus
• fixes for pcm-iio/pcm-accel

202211 Release

Release Notes:

• added Sapphire Rapids processor support
• added new pcm-accel utility to monitor Sapphire Rapids accelerator performance
• added --version option to all pcm tools
• pcm: new "enforce flush output" option
• pcm-raw: support ocr_msr_val and tid modifiers
• fixed default value for CHA filter1 on CLX and SKX
• pcm-sensor-server: allow build on FreeBSD
• pcm-raw: adopt new JSON event file format, new URLs for perfmon event lists

202210 Release

Change notes:

• rename Processor Counter Monitor to Intel(r) Performance Counter Monitor
• implement Raptor Lake support in pcm utility
• pcm-raw: support event collection by name by default (via simdjson submodule)
• prevent injections in event names in core pcm-raw and pcm-core
• add no output directory error
• expand custom counter memory for PCM-Service
• removed custom processing of CMAKE_INSTALL_PREFIX
• suppress stderr messages when --help/-h called
• README: added command to install PCM on RHEL
• add SNR register definitions
• code quality enhancements
• refactor argument parsing in pcm utilities
• stability improvements
• fix top-down events on some Linux kernels
• refactored OSX-specific code
• pcm-memory: option to enforce output flush

202207 Release

Change notes:

• pcm-raw: add json output to pcm-raw
• pcm-memory: fix csv output inconsistency for channels without traffic
• fix automatic version generation on checkout
• use GNUInstallDirs for install paths
• pcm-iio: optionally display root port pci device id
• automatically increase limit on open files on Linux
• pcm-daemon: add 'memory mode hit approximation' metric + client sample app fixes
• pcm-daemon: document all pcm-daemon metrics in the common.h header
• handle non-Unicode build configurations on Windows
• add CPU model number in processor information list
• correct hardcoded QPI strings and change to UPI when applicable
• pcm-iio: add missing header item
• check legacy .x files and uninstall them if any found
• pcm-raw: fix "EDP" format prints for offlined cores
• move simdjson wrapper logic to cmake

202205 Release

Change notes:

• PCM_KEEP_NMI_WATCHDOG=1 env variable to keep NMI watchdog running
• support pcm-iio on ICX-D
• compile with up-to-date pre-installed simdjson library if available (e.g. on ubuntu 22.04)
• support additional Alderlake cpu model
• document -pid option in pcm-numa and pcm-tsx