A Terminal Flamegraph Viewer
Project description
Flameshow
Flameshow is a terminal Flamegraph viewer.
Features
- Renders Flamegraphs in your terminal
- Supports zooming in and displaying percentages
- Keyboard input is prioritized
- All operations can also be performed using the mouse.
- Can switch to different sample types
Install
Flameshow is written in pure Python, so you can install via pip
:
pip install flameshow
Usage
View golang's goroutine dump:
$ curl http://localhost:9100/debug/pprof/goroutine -o goroutine.out
$ flameshow goroutine.out
After entering the TUI, the available actions are listed on Footer:
- q for quit
- j i j k or ← ↓ ↑ → for moving around, and Enter for zoom in, then Esc for zoom out.
- You can also use a mouse, hover on a span will show it details, and click will zoom it.
Supported Formats
At the moment, Flameshow supports only Golang's pprof dump. I'm actively working on adding more formats. Admittedly, I might not be familiar with every tool and its specifics. So, if you'd like Flameshow to integrate with a tool you love, feel free reach out and drop an issue.
- Golang pprof
Development
If you want to dive into the code and make some changes, start with:
git clone git@github.com:laixintao/flameshow.git
cd flameshow
pip install poetry
poetry install
This project is proudly powered by textual.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
flameshow-0.2.1.tar.gz
(2.3 MB
view hashes)
Built Distribution
flameshow-0.2.1-py3-none-any.whl
(18.6 kB
view hashes)
Close
Hashes for flameshow-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0e0d1f17f32bd4176fad291fa6cae51c309d3fb70d8fb302f2ca4392ed16fd50 |
|
MD5 | bb59f21ecb5dda6df43b1dcf7eb9facc |
|
BLAKE2b-256 | d0e1edd43005440d385a9de669b5de545de3a1e16b1a8a07ce174cc38b73511e |