rust_hawktracer
Rust bindings for Amazon's Hawktracer profiler. This offers simple, minimal bindings to help you profile your programs.
Warning
You need an external tool in order to transform bindings from a binary format to something that can be interpreted by chrome:://tracing This tool can be build for now from the main hawktracer repo (client/hawktracer-to-json). I recommend taking the binaries from the official rust_hawktracer releases: https://github.com/amzn/hawktracer/releases/tag/v0.6.0
How to use
In Cargo.toml:
[]
= "0.3.0"
=["profiling_enabled"]
In your main.rs:
extern crate rust_hawktracer;
use *;
use ;
Visualization
Download hawktracer-converter.exe and use it like this:
If you use HawktracerListenerType::ToFile
:
.\hawktracer-converter.exe --source trace.bin --output trace.json
If you use HawktracerListenerType::TCP
you can listen and capture traces by specifying the IP:port as the --source
parameter:
.\hawktracer-converter.exe --source 127.0.0.1:12345 --output trace_12345.json
Open a chrome browser and go to this address: chrome://tracing/
For the program above you should see the following trace:
Things to watch out for.
In rust macros I can't create new variable names right now, this means that if you want to avoid warnings, the tracepoint variable names have to start with a leading _
, as in scoped_tracepoint!(_second_tracepoint)
.
If you figure out a way to do this, feel free to raise a PR / issue.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE or http://opensource.org/licenses/MIT)
at your option.