#tracing #sparkles #parser #perfetto #format #trace #protocols

bin+lib sparkles-parser

Parser for sparkles tracing library

3 unstable releases

new 0.1.0 Mar 9, 2025
0.0.4 Sep 28, 2024
0.0.3 Sep 28, 2024

#923 in Parser implementations

Download history 1/week @ 2024-12-11 1/week @ 2025-02-05 1/week @ 2025-02-12 103/week @ 2025-03-05

104 downloads per month

Apache-2.0

205KB
2K SLoC

Sparkles parser

Library for parsing sparkles trace data.

Tracing information can be either saved to file or transmitted over UDP socket. These two flavors of sparkles tracing data protocol can be parsed and converted to Perfetto format file using this library.

Files compatible with Perfetto format can be easily viewed in browser on the Perfetto website.

✧ Installation

cargo install sparkles-parser --features bin-deps

Two binaries are included

✧ sparkles-parse-and-save

Used for default sparkles configuration. It will open directory trace and parse the latest saved file, or parse specific file provided as an argument.

The result is saved with filename trace.perf

✧ sparkles-udp-parse-and-save

Application need to enable udp sender in config first. Connect to running application and collect tracing data over UDP until it is finished. If you want to interrupt tracing data collection early, just press Ctrl-C.

The result is saved with filename trace.perf

✧ How to use

Run one of described binaries to generate Perfetto protobuf format file. Navigate to https://ui.perfetto.dev/ and drag'n'drop generated file.

Crate features

local-packet-bounds - Add received packet bounds to the result
self-tracing - Create trace file to analyze parser work ✧ perfetto - Add saving in perfetto format method to the library crate ✧ bin-deps - Should not be used if you are using library crate

。゚゚・。・゚゚。
゚。SkyGrel19 ✨
 ゚・。・

Dependencies

~10–23MB
~198K SLoC