HawkTracer Converter
HawkTracer Converter is a command line tool for converting HawkTracer binary stream to well-known tracing format. Converter supports following output formats:
- FlameGraph HTML files (http://www.brendangregg.com/flamegraphs.html)
- Trace Event Format (https://github.com/catapult-project/catapult/wiki/Trace-Event-Format)
- Debug output - prints raw events in a human-readable form
We strive to support as many formats as possible, so please create an issue to let us know that you need another output format to be supported.
Documentation quick links
Screenshots of output formats
Trace Event Format | FlameGraph |
---|---|
Installation
Download binary files
For each release team publishes ready-to-run executables for Linux and Windows operating systems. If you don't have rust environment, and you don't want to build the converter on your own, we recommend to download binaries from the release page.
You should download a file with the following name: hawktracer-converter-{VERSION}-{OPERATING_SYSTEM}-{ARCHITECTURE}
(optionally with .exe
extension for Windows platforms), e.g. hawktracer-converter-0.1.0-linux-x86_64
.
Cargo Install
If you have Rust developer tools, the easiest way to install the converter is to run cargo install command:
This command will install hawktracer-converter
application to user's installation bin root's bin folder (by default it's $HOME/.cargo/bin
). Make sure that directory is in your $PATH
to be able to run the application without specifying a full path.
Usage
)
Examples
- Read HawkTracer data stream from the network and generate FlameGraph in the default location:
- Read HawkTracer data file and print raw events to standard output:
Building
HawkTracer Converter is implemented in Rust, and it's recommended to use cargo
tool to compile the project:
License Summary
This project is made available under the MIT license. (See LICENSE file)