bin+lib flamelens

Flamegraph viewer in the terminal

3 releases (breaking)

0.3.0 Sep 27, 2024
0.2.0 Jul 7, 2024
0.1.0 Jun 29, 2024

#95 in Visualization

Download history 155/week @ 2024-06-24 141/week @ 2024-07-01 73/week @ 2024-07-08 2/week @ 2024-07-15 8/week @ 2024-07-29 22/week @ 2024-09-16 124/week @ 2024-09-23 56/week @ 2024-09-30

202 downloads per month

MIT license

115KB
2.5K SLoC

flamelens

flamelens is an interactive flamegraph viewer in the terminal.

Demo

What is it?

Flamegraph tools such as FlameGraph and inferno process output from various profiling tools and generate intermediate data in the "folded" format ready for flamegraph plotting. Instead of plotting the flamegraph as an SVG file, flamelens takes the folded stacks data and generate an interactive flamegraph in the terminal.

No more hauling SVG files and opening a browser just to have a quick look at the profiling result!

Usage

Run flamelens with the filename of the profiling data in the form of "folded stacks":

flamelens <folded-stacks-filename>

You can also pipe data directly to flamelens without providing a filename.

cargo-flamegraph

You can use flamelens as the viewer of cargo flamegraph this way:

cargo flamegraph --post-process 'flamelens --echo' [other cargo flamegraph arguments]

The --echo flag ensures that the flamegraph SVG file is also generated by cargo flamegraph on exit.

Viewing perf data

If have a perf.data file generated by perf (e.g. by using cargo flamegraph to profile your program in Linux), you can visualize it in flamelens this way with the help of inferno:

perf script -i perf.data | inferno-collapse-perf | flamelens

See inferno on generating folded stacks data from profiling data of different formats.

Python

Display a live flamegraph of a running Python program using py-spy as the profiler:

flamelens --pid <pid-of-python-program>

This requires enabling the python feature when installing.

Example of a live flamegraph

demo-live

Key bindings

Key Action
hjkl (or ← ↓ ↑→ ) Navigate cursor for frame selection
f Scroll down
b Scroll up
G Scroll to bottom
g Scroll to top
Enter Zoom in on the selected frame
Esc Reset zoom
/<regex> Find and highlight frames matching the regex
# Find and highlight frames matching the selected frame
n Jump to next match
N Jump to previous match
r Reset to default view
z (in Live mode) Freeze the flamegraph
q (or Ctrl + c) Exit

Installation

If you have Rust installed, flamelens is available on crates.io and you can install it using:

cargo install flamelens --locked

If you want the live flamegraph functionality, install with the --all-features option:

cargo install flamelens --locked --all-features

Alternatively, build and install from source after cloning this repo:

cargo install --path $(pwd) --locked

Dependencies

~9–23MB
~351K SLoC