#client #profiler #bindings #crates #level #project #libraries

tracy-client

High level bindings to the client libraries for the Tracy profiler

9 releases (5 breaking)

0.12.0 Feb 17, 2021
0.11.0 Jan 26, 2021
0.10.0 Nov 18, 2020
0.9.0 Oct 11, 2020
0.7.3 Jun 24, 2020

#23 in Profiling

Download history 248/week @ 2020-11-06 220/week @ 2020-11-13 319/week @ 2020-11-20 226/week @ 2020-11-27 170/week @ 2020-12-04 161/week @ 2020-12-11 120/week @ 2020-12-18 46/week @ 2020-12-25 218/week @ 2021-01-01 193/week @ 2021-01-08 238/week @ 2021-01-15 184/week @ 2021-01-22 195/week @ 2021-01-29 199/week @ 2021-02-05 252/week @ 2021-02-12 369/week @ 2021-02-19

814 downloads per month
Used in 8 crates (2 directly)

MIT/Apache

11MB
215K SLoC

C++ 193K SLoC // 0.0% comments C 19K SLoC // 0.1% comments Visual Studio Project 1.5K SLoC Rust 445 SLoC // 0.0% comments HLSL 368 SLoC // 0.0% comments Objective-C 209 SLoC // 0.1% comments Visual Studio Solution 180 SLoC Shell 38 SLoC // 0.1% comments Batch 3 SLoC // 0.4% comments

Tracy profiler clients in Rust

This project contains Rust crates for producing Tracy profiler traces. Tracy features nanosecond precision, ability to profile remotely and a full-featured graphical interface for finding hot spots in profiled programs.

While Tracy's support for Rust is not first-class, it is still a very potent tool. If you have an application instrumented with the tracing crate, Tracy can be used with your program in minutes via the tracing-tracy crate. It can work well as both a profiling and, to a lesser extent, an observability tool.

Important note

Simply depending on crates in this repository is sufficient for tracy to be enabled at program startup, even if none of the APIs provided by this crate are invoked. Tracy will broadcast discovery packets to the local network and expose the data it collects in the background to that same network. Traces collected by Tracy may include source and assembly code as well.

As thus, you may want make sure to only enable the tracing-tracy, tracy-client and tracy-client-sys crates conditionally, via the enable feature flag provided by the crates.

Version support table

This project, unlike Tracy itself, follows semantic versioning. We will publish a breaking version bump whenever there is a potentially breaking protocol change, even if the Tracy project itself does not. An older version of Tracy being unable to communicate with the client of a more recent version is an example of such a breaking change.

The following table lists the version correspondence between the libraries.

Tracy tracy-client-sys tracy-client tracing-tracy
0.7.1 0.9.0 0.8.0 0.2.0
0.7.3 0.10.0 0.9.0 0.3.0
0.7.4 0.11.0 0.10.0 0.4.0
0.7.5 0.12.0 0.11.0 0.5.0
0.7.6 0.13.0 0.12.0 0.6.0

Dependencies