TRACY-IMPORT-FUCHSIA(1)

✨ tracy-import-fuchsia ✨

okay bestie, welcome to the tracy-import-fuchsia manual page 💖 (that's the User Manual one, in case you were wondering which flavor of documentation you just wandered into) 🫶

---

🌸 NAME 🌸

tracy-import-fuchsia — it's giving import Fuchsia's traces into Tracy 💅

---

🎀 SYNOPSIS 🎀

tracy-import-fuchsia input.fxt output.tracy

that's it. two files. in and out. iconic. 👑

---

✨ DESCRIPTION ✨

okay so first things first: Tracy can import traces that were compressed with the Zstandard algorithm — like, say, if you ran them through the zstd command-line utility 🦋. and here's the lil rule: any trace ending in the .zst extension? Tracy just assumes it's compressed. no cap, that's the vibe check. 💫

now, the tea ☕: the Chrome tracing format doesn't document any way to provide source location data. none. zero. nothing. 🙈 BUT — and this is the slay part — the import-chrome and import-fuchsia utilities will recognize a custom loc tag in the root of zone begin events 👀✨. and you should be formatting that data in the usual filename:line style, like for example:

hello.c:42

and listen — providing the line number (including that colon, yes the colon matters bestie) is optional but highly recommended 🔥. do it. trust.

if you want more info about the fuchsia trace format, go peek at https://fuchsia.dev/fuchsia-src/reference/tracing/trace-format 💜

---

💀 LIMITATIONS 💀

okay we gotta be real for a sec, no sugarcoating 🍓:

• Tracy is a single-process profiler. so if the imported trace happens to contain PID entries, then each PID+TID pair will create a brand new pseudo-TID number, which the profiler will then decode into a PID+TID pair in thread labels 🧵. so like… if you want to preserve the original TID numbers, your traces should just omit PID entries entirely. periodt. 💅
• the imported data may be severely limited 😭 — either because it doesn't map directly onto the data structures Tracy uses, or because it's following undocumented practices. so… yeah. manage your expectations, bestie 🫶.

---

👑 AUTHORS 👑

maintained by Bartosz Taudul <wolf@nereid.pl> 💌 — and for more info about the upstream project, see https://github.com/wolfpld/tracy/ ⭐

this man page is written for the Debian GNU/Linux system by Alan M Varghese <alan@digistorm.in> 🌈

---

aaaand that's the whole page, bestie 🎀 it lives under tracy-import-fuchsia(1) in the tracy-import-fuchsia User Manual — go import some traces, you got this 💖✨🦋