FlameScope is a wonderful performance visualization tool from Netflix. If you have never heard about it, you should start by reading Brendan Gregg's FlameScope Pattern Recognition blog post as an introduction.
But as Go developer, you might have not have had a chance to use it because pprof profiles don't contain timestamps. Using Linux perf is an option, but that may not always be available in your environment.
However, thanks to a patch from Rhys Hiltner, go1.19+ execution traces include CPU samples with timestamps when when having the CPU profiler enabled. The only thing missing, until now, was a way to extract these CPU samples, so they can be visualized in FlameScope.
So I spend some time this weekend to implement FlameScope support for my traceutils project. You can follow the steps below to install it, and create an example
json.stacks file by running the
# install traceutils go install github.com/felixge/traceutils/cmd/traceutils@latest # record an example trace with CPU samples go test -bench . -cpuprofile /dev/null -trace json.trace encoding/json # convert it to the format used by perf script traceutils flamescope json.trace json.stacks
The next thing you need to do is installing FlameScope itself. The steps below should work if you're on an M1 MacBook Pro.
# clone repo git clone https://github.com/Netflix/flamescope cd flamescope # add the json.stacks file mv ../json.stacks examples # install libmagic brew install libmagic # install python deps pip install -r requirements.txt # build ui npm install npm run webpack # run flamescope python run.py
Once you've got it up and running, you should be able to select the
json.stacks file by hitting the
Open as Linux Perf button next to it.
This will bring up the FlameScope heatmap. You can use it to select one of the hot parts of the profile as shown below.
This will bring up a FlameGraph for the selected time range. In this case the
RunParallel frame near the bottom of the stack explains why this part of the profile was hot: The benchmark was executing on all of our CPUs.
And that's it, you can now enjoy FlameScope visualizations using Go.
But please note that this is still relatively experimental and I've identified at least one problem while using it so far. Also note that CPU profiling on macOS is a bit broken these days, so you should prefer to collect this kind of data on Linux.