Changelog

0.5.1 (2021-07-30)

• Update vendored async-profiler libraries to 1.8.6.
• Add prepackaged binaries for Linux x86 and Linux AArch64.
• Add early access prepackaged binary for MacOS AArch64 (M1). Note that this is not an experimental version.

0.5.0 (2020-12-16)

• Update vendored async-profiler libraries to 1.8.2.
• Add ability to customize the frame buffer size with :framebuf option to start and profile.
• Add ability to set default profiling/rendering options.

0.4.1 (2020-03-23)

• Update vendored async-profiler libraries to 1.6.
• Fix the bug with Clojure special characters not being properly demunged in stackframes.

0.4.0 (2019-06-02)

• Add support for differential profiles.
• Refine browser UI.
• Allow to pass profiler run IDs instead of full filenames to generate-* functions.
• Change the format of generated filenames. They now include a run ID and event type.
• #10: Add support for SVG's width and height options.

0.3.1 (2019-03-15)

• #9: Fix out-of-bounds string access when demunging stackframes.

0.3.0 (2019-02-04)

• Add custom color scheme for generated flamegraphs.
• Automatically demunge Java and Clojure frames in the output.
• Add :transform <fn> capability to specify a custom transform function to post-process the collected stacks.
• Add :threads true option to generate stacks for each thread separately.
• BREAKING: remove arities that take an explicit PID argument. If you want to profile another process, pass :pid <PID> argument to any profiling function.

0.2.2 (2019-01-16)

• Update vendored async-profiler libraries to 1.5. Big features of the new async-profiler:
  • Native stack traces on macOS.
  • Wall-clock profiler: pass :event :wall to the profiling command.
• Ship prebuilt library for Linux ARM platform.
• Fix profile generating flamegraph twice.
• Avoid illegal access warning on JDK9+.
• #1: Don't create flamegraph file if profiler was not running.

~0.2.1 - botched release~

0.2.0 (2018-11-21)

• Update vendored async-profiler libraries to 1.4. From now on, clj-async-profiler ships binaries prebuilt by async-profiler maintainers themselves, no longer building them manually.
• Deprecate arities in user-facing functions that take explicit pid argument. Instead, they now retrieve :pid value from the option map. If the value is not present, use the current process as profiler target.
• Add default arity without options map for each user-facing function.
• Add profile macro which runs the profiler exactly for the duration of body.
• Make it possible to use clj-async-profiler outside of REPL environment (see clojure-goes-fast/clj-memory-meter#2 for context).
• Make the profiled event configurable through options.
• BREAKING: profile-for no longer returns a future, instead it blocks the current thread for the specified duration. You can still wrap this call in (future ...) manually if needed.

0.1.3 (2018-04-13)

• #1: Fix problems with starting the profiler with Leiningen on Linux.
• #3: Add a more informative message in case of missing agent dependencies.

0.1.2 (2018-02-09)

New options for stop and profile-for:

• :min-width - a number in pixels to limit the minimal width of a stackframe. Use this if the resulting flamegraph is too big and hangs your browser. Recommended value is from 1 to 5.
• :reverse? - if true, generate the reverse flamegraph which grows from callees up to callers.
• :icicle? - if true, invert the flamegraph upside down.

0.1.0 (2017-12-11)

The initial release of clj-async-profiler. Includes the ability to start and stop the profiler manually, profile for a period of time, and generate flamegraphs from the profiled data.