babeltrace2-source.ctf.lttng-live - Linux


babeltrace2-source.ctf.lttng-live is a command-line utility for converting live LTTng kernel traces in CT format to a human-readable text file. It is a part of the babeltrace package and is commonly used in performance debugging and analysis to convert and visualize trace data collected from various system components.


babeltrace2-source.ctf.lttng-live [options] <filename>


  • -l : Specify the trace type to convert. Default: "kernel" (kernel trace)
  • -o : Specify the output file to write the converted trace to. Default: stdout
  • -p: Convert stack unwinding data
  • -s : Filter traces by a specific subsystem
  • -e : Filter traces by a specific event name
  • -f : Specify the output format. Default: "text"
  • -h: Display help and usage information


Convert kernel LTTng trace to text:

babeltrace2-source.ctf.lttng-live -l kernel trace.ctf

Convert kernel LTTng trace with stack unwinding to JSON:

babeltrace2-source.ctf.lttng-live -l kernel -p -f json trace.ctf

Filter traces by a specific subsystem and output to a file:

babeltrace2-source.ctf.lttng-live -l kernel -s irq trace.ctf -o irq_trace.txt

Common Issues

  • Trace format not recognized: Ensure that the input file is in CT format and produced by LTTng.
  • Output file not written: Check if the specified output file path is valid and accessible.


Combining with libelf:

libelf -e data trace.ctf | babeltrace2-source.ctf.lttng-live

Converting to Hades:

babeltrace2-source.ctf.lttng-live trace.ctf | hades-parser

Related Commands

  • lttng-sessiond: Collect and manage LTTng trace sessions.
  • babeltrace2: Convert LTTng traces to other formats.
  • lttng-view: Visualize LTTng trace data.