Skip to content

Latest commit

 

History

History
254 lines (192 loc) · 10.2 KB

CHANGELOG.md

File metadata and controls

254 lines (192 loc) · 10.2 KB
Raw

Changelog

1.5.0

  • Implement uploading flamegraphs to flamebin.dev.
  • Unify flamegraph configuration. All changeable flamegraph options (highlight, transforms, sorting) can now be pre-initialized through:
    • :config option passed to generate-flamegraph and other functions.
    • Query parameter ?config=.
  • Add buttons to copy and paste the flamegraph config, and save the current config to server to use for subsequent flamegraphs.
  • Deprecate :predefined-transforms option. Use :config {:transforms ...} instead.

1.4.0 (2024-10-22)

  • New index page design.
  • Add diffgraph generation buttons to the web UI.
  • Try to prevent horizontal scrollbar appearing on flamegraph.
  • Fix tooltip getting clipped at the bottom of the screen.

1.3.3 (2024-10-04)

1.3.2 (2024-09-30)

  • Update diffgraph color palette.
  • Implement custom frame tooltip instead of the native on-hover tooltip.
  • Close context menu by pressing Escape.

1.3.1 (2024-09-24)

  • #37: Fix load crashing when the profiler is compiled with AOT.
  • Remove support for :return-file option in profile macro.
  • Add special :all shortcut to select all features.

1.3.0 (2024-09-10)

1.2.2 (2024-05-28)

  • Fix the current view resetting when the flamegraph becomes inactive.

1.2.1 (2024-05-25)

  • Work around a bug in Chrome that caused the rendered flamegraph to become blank if the user switches away and back to the flamegraph tab.

1.2.0 (2024-02-06)

  • Update vendored async-profiler libraries to 3.0.
  • Remove dedicated musl binary and special handling for musl-based distros (Linux x64 now handles both glibc and musl).
  • Add support for optional async-profiler features (currently supported: :vtable and :comptask).
  • Add support for new event type :ctimer which doesn't require perf_events (so it works in limited permission containers) but is more accurate than :itimer. Note that :ctimer is only supported on Linux.
  • BREAKING: Remove serve-files which has been deprecated since version 1.0.1. Use serve-ui instead.

1.1.1 (2023-10-18)

  • Fix "Hide frames below" transform being stuck in an endless loop.

1.1.0 (2023-10-16)

  • Add print-jvm-opt-for-startup-profiling to simplify setting up startup profiling with async-profiler and then render the results with clj-async-profiler.
  • Add right-click menu for frames to automatically generate common transforms.
  • In dynamic transforms, the stack string now includes leading and trailing semicolons (i.e. ;frame1;frame2;frame3;) for easier matching of frame boundaries.
  • #28: Customize output dir via a Java property.

1.0.5 (2023-08-15)

  • Update vendored async-profiler libraries to 2.9.

1.0.4 (2023-05-29)

  • Diffgraphs are now non-normalized by default (which is, probably, a less surprising behavior).
  • Add a button to copy the title of the currently selected frame to make writing transforms easier.

1.0.3 (2022-11-16)

  • Add clj-async-profiler.ui/stop-server function for shutting down the Web UI HTTP server.

1.0.2 (2022-11-04)

  • Fix diffgraphs incorrectly calculating deltas for topmost frames.
  • Add ability to toggle sidebar visibility using query params.
  • Sort frames by width by default.

1.0.1 (2022-10-27)

  • Update vendored async-profiler libraries to 2.8.3.
  • Add a new function clj-async-profiler.core/serve-ui which supersedes serve-files. serve-ui takes an explicit host argument. If host is not provided, localhost is used by default (used to be 0.0.0.0).
  • The now deprecated serve-files still binds to 0.0.0.0 to retain compatibility.

1.0.0 (2022-07-22)

  • BREAKING: Replace SVG flamegraphs with HTML flamegraphs. It is not possible to generate SVG flamegraphs anymore.
  • Add dynamic configuration into the flamegraph. User can now change the following without regenerating a flamegraph:
    • minimal frame width
    • frame sort order
    • normal/inverse orientation (for icicles graphs)
    • stack transforms
  • Remove the following options passed to generate-flamegraph: :reverse?, :icicle?, :width, :height, :min-width. These options are no longer needed at generation time since they are configurable within the HTML flamegraph itself.
  • Introduce :predefined-transforms option that bakes the provided transforms into the generated HTML (see docstring for clj-async-profiler.core/stop).
  • Enable browser caching of flamegraph files. Repeated opening of the same flamegraph in browser will no longer refetch the file from the server.
  • Rewrite stack post-processing code into Java for faster generation of flamegraphs.
  • Fix the 10-something second delay on MacOS when starting the profiler for the first time.

0.5.2 (2022-07-15)

  • Update vendored async-profiler libraries to 2.8.2.
  • Add prepackaged binary for Linux x64 MUSL libc.
  • BREAKING: Remove prepackaged binaries for Linux x86 and Linux ARMv7 (arm32) since async-profiler no longer ships them. These platforms continue to be supported but you'll have to build binaries for them manually.

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.