curl / Mailing Lists / curl-library / Single Mail
Buy commercial curl support. We help you work out your issues, debug your libcurl applications, use the API, port to new platforms, add new features and more. With a team lead by the curl founder Daniel himself.

Introducing perf2html. A data visualization app for the curl perf tool.

From: A Johnston via curl-library <curl-library_at_lists.haxx.se>
Date: Wed, 18 Nov 2026 07:06:19 -0700

Hello everyone,

This is the first public announcement of the perf2html profiling and data
visualization app for the curl perf tool. It would be easy to add other
targets, but that has not been my focus.

perf2html is a profiling tool that builds and runs curl's perf tool with
special instrumentation. In particular it uses an emulator to generate a
lot of data about the operation of a virtual machine executing the code.

Then it generates an html report with the following:

- A view of the source code with per-line and per-function CPU and cache
events with editable columns, and navigable information tables.
- A flame graph showing a timeline of the function's operation on real
hardware.
- A searchable database of function data with editable columns.
- A tree view of the call-graph showing the big picture view.
- Navigation for blind/disabled users.

All this data tells different stories. The flame graph makes a good first
sanity check. Then the emulator data spells out the exact cost of your x64
assembly on a low end machine. Even the data on the overview page has a few
interesting hints.

Here is a link to a report generated from the last curl release:

https://whatchamacallem.github.io/perf2html/

perf2html can also generate a "diff" report that shows you the changes
between two html reports. This allows you to isolate the exact effects of a
modification.

To give credit where it is due, this project relied heavily the GNU tool
chain, specifically callgrind. And perf2html embeds the speedscope flame
graph app, which is an important tool too. This also required a few months
of working with an expensive coding agent.

Let me know if you find a bug, I am not aware of any. If you are interested
in seeing more of these reports or in using this tool yourself, also let me
know.


Regards,

Adrian


-- 
Unsubscribe: https://lists.haxx.se/mailman/listinfo/curl-library
Etiquette:   https://curl.se/mail/etiquette.html
Received on 2026-11-18