NAME

       tracy-import-fuchsia - Import Fuchsia's traces into Tracy

SYNOPSIS

       tracy-import-fuchsia input.fxt output.tracy

DESCRIPTION

       Tracy  can  import  traces compressed with the Zstandard algorithm (for example, using the
       zstd command-line  utility).   Traces  ending  with  .zst  extension  are  assumed  to  be
       compressed.

       Chrome tracing format doesn't document a way to provide source location data.  The import-
       chrome and import-fuchsia utilities will however recognize a custom loc tag in the root of
       zone  begin  events.  You should be formatting this data in the usual filename:line style,
       for example: hello.c:42.  Providing the line number (including a colon)  is  optional  but
       highly recommended.

       See  <https://fuchsia.dev/fuchsia-src/reference/tracing/trace-format> for more information
       about fuchsia trace format.

LIMITATIONS

       • Tracy is a single-process profiler.  Should the imported trace contain PID entries, each
         PID+TID  pair  will  create a new pseudo-TID number, which the profiler will then decode
         into a PID+TID pair in thread labels.  If you want to preserve the original TID numbers,
         your traces should omit PID entries.

       • The  imported  data  may be severely limited, either by not mapping directly to the data
         structures used by Tracy or by following undocumented practices.

AUTHORS

       Maintained by Bartosz Taudul <<wolf@nereid.pl>>.   For  more  information  about  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>>.

                                                                          tracy-import-fuchsia(1)