Skip to content

Releases: jmuehlig/perf-cpp

v0.12.5

22 Dec 08:48

Choose a tag to compare

  • Bugfix: The library could not compile for specific Linux kernels (see #10).
  • Symbol Translation: Improved translation from instruction pointer to symbol.

v0.12.4

28 Oct 19:18

Choose a tag to compare

  • Bugfix: The library crashed when events loaded from an external CSV file contained empty spaces (see #8). Thanks to @Liteom.
  • Bugfix: The library could not compile for specific Linux kernels not providing PERF_MEM_LVLNUM_UNC and PERF_MEM_SNOOPX_PEER (see #7). Thanks to @Raphalex46 for pointing out.
  • Perf Data Export: Samples can now be written as perf data files using Sampler::to_perf_file(), enabling analysis with standard perf ecosystem tools like perf report (see the documentation). Note that this feature is experimental.

v0.12.3

22 Aug 17:07

Choose a tag to compare

This update simplifies the handling of counter definitions by introducing a default instance.

  • Default Counter Definitions: Supplying a user-defined perf::CounterDefinition to each perf::EventCounter or perf::Sampler is no longer required. If none is provided, a default instance is used automatically. Custom definitions now extend the default set of events instead of duplicating them.

v0.12.2

19 Jul 07:53

Choose a tag to compare

  • Metric Functions: Metrics now support built-in functions such as ratio(A, B) and sum(A, B, C, ...), enabling more expressive and reusable formulas (see the documentation).
  • Optimized Compile-time Event Injection: The generated runtime event registration class is now only created if it does not already exist, reducing unnecessary recompilation.
  • Improved Live Event Accuracy: Live event values now account for partial runtime durations via time scaling, improving accuracy when counters were not active for the full measurement window.

v0.12.1

29 Jun 17:44

Choose a tag to compare

  • Automatic Event Discovery on ARM: Hardware event types are now automatically detected on ARM architectures when initializing a perf::CounterDefinition instance.
  • Hardware Counter Introspection: The number of available physical performance counters per logical core, along with the number of events each counter can multiplex, is now determined automatically when creating a perf::EventCounter.
  • Recursive and Scientific Metrics: Metric expressions can now reference other metrics recursively. Support for scientific notation (e.g., 1e5) in formula-based metrics has also been added.

v0.12.0

25 Jun 06:35

Choose a tag to compare

This release expands symbolic analysis capabilities, introduces FlameGraph generation, and improves hardware event management through both runtime and compile-time support.

  • Symbol Resolution: Instruction pointers captured during sampling can now be resolved to function names using perf::SymbolResolver (see the documentation).
  • FlameGraph Export: Sampling data can be converted into formats compatible with visualization tools such as Brendan Gregg's FlameGraph, Speedscope, and flamegraph.com using perf::analyzer::FlameGraphGenerator (see the documentation).
  • Built-in Event Definitions: A set of x86-specific hardware events is now bundled in events/x86 and can be loaded at runtime using perf::CounterDefinition. This serves as an alternative to the make perf-list target.
  • Compile-time Event Injection: Processor-specific event definitions can now be embedded directly at build time by configuring CMake with -DGEN_PROCESSOR_EVENTS=1. These are immediately available via perf::CounterDefinition (see the documentation).
  • Automatic Event Discovery: Additional event types–including RAPL energy counters and AMD IO MMU events–are now automatically detected during the creation of a perf::CounterDefinition instance (issue #6).

v0.11.1

27 May 20:06

Choose a tag to compare

  • Unified the behaviour of the time and timestamp fields in the sampling API, removing discrepancies between the two.

v0.11.0

26 May 17:50

Choose a tag to compare

This version rolls out a redesigned sampling API.
Recorded data are now grouped into dedicated sub-structures (such as Metadata, InstructionExecution, and DataAccess) inside perf::Sample (see the sampling documentation).

The previous flat API is still available but deprecated and will be removed in v0.12.

  • New Sampling Interface: Work with clearly separated sample sections, exposing additional AMD IBS fields that are not surfaced by the perf_event_open records.
  • Explicit Latency Attributes: Vendor-specific latency signals–cache-access on Intel and cache-miss on AMD–are now surfaced as distinct fields.
  • Heterogeneous-core Support: Sampling can target multiple PMU domains (e.g., cpu_core and cpu_atom) on hybrid Intel processors.

v0.10.0

15 Feb 10:28

Choose a tag to compare

  • New feature: The auxiliary event is added automatically if required by the (Intel-) hardware (see the documentation).
  • New feature: The Memory Access Analyzer allows the description of complex data objects and maps sampled memory addresses in order to report latency and access information (see the documentation).
  • The number of pages for the sampling buffer is now aligned automatically if the number is not configured properly, i.e., a power of two plus one page for the header.
  • New feature: Copy sampled data from the mmap-ed perf buffer into the application-level buffer whenever the buffer comes close to full (see the documentation).

v0.9.0

05 Dec 03:52

Choose a tag to compare

  • Removed deprecated warnings about the sampling interface (and the old sampling interface).
  • New feature: Access interim results from counters without stopping the counter using live counters.
  • New feature: Sampling the user stack.
  • New feature: Create custom metrics using expressions, e.g., "instructions/cycles".
  • New feature: Use metrics when sampling counter values.
  • New feature: Control scheduling of events to physical hardware counters.
  • New feature: Added time events (e.g., seconds, milliseconds, etc.) as virtual counters.