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

• Installation
• Usage
• Examples
• Building

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: bash cargo install hawktracer-converter 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

```bash $ hawktracer-converter --help USAGE: hawktracer-converter [FLAGS] [OPTIONS] --format --output-file --source

FLAGS: -h, --help Prints help information --stdout Print data to standard output -V, --version Prints version information --verbose Print debug information

OPTIONS: --format Conversion format [possible values: debug, chrome-tracing, flamegraph] --map-files List of mapping files --output-file Output file [default: hawktracer-trace-%Y-%m-%d-%H%M%S.httrace] --source Data source description (either filename, or server address)

```

Examples

• Read HawkTracer data stream from the network and generate FlameGraph in the default location: bash $ hawktracer-converter --format flamegraph --source 10.16.32.249:5443
• Read HawkTracer data file and print raw events to standard output: bash $ hawktracer-converter --format debug --stdout

Building

HawkTracer Converter is implemented in Rust, and it's recommended to use cargo tool to compile the project: bash $ git clone https://github.com/loganek/hawktracer-converter $ cd hawktracer-converter $ cargo build --release $ ./target/release/hawktracer-converter --version hawktracer-converter 0.1.0

License Summary

This project is made available under the MIT license. (See LICENSE file)