babeltrace2-plugin-text - Linux
Overview
babeltrace2-plugin-text converts Babeltrace events into textual summaries or full traces. It’s a powerful tool for capturing and analyzing trace data and is often used in debugging, profiling, and performance analysis.
Syntax
babeltrace2-plugin-text [options] <input_file>
Options/Flags
| Option | Description | Default |
| ———————– | ———————————————————————————————————- | ——– |
| -a, --all
| Print all events, including those normally filtered out | false
|
| -f, --format
| Output format: summary
(default), full
, json
, csv
, dot
, callgraph
| summary
|
| -s, --start-time
| Start time in nanoseconds (relative to trace start) | 0
|
| -e, --end-time
| End time in nanoseconds (relative to trace start) | -1
|
| -w, --context-width
| Width of surrounding context in full mode | 0
|
| -E, --experimental
| Activate experimental formats and features | false
|
| -h, --help
| Display this help message and exit | |
| -V, --version
| Display version information and exit | |
| -j, --json-format
| Format when --format
is json
(defaults to pretty JSON, use --json-format=csv
for CSV) | pretty
|
| -c, --color
| Enable ANSI colors for output (disabled by default) | false
|
| -T, --timestamp-format
| Timestamp format: absolute
(default), relative
, utc
| absolute
|
| -P, --plugins
| Load additional plugins from the specified directory | |
| -l, --log-level
| Default log level for plugins | info
|
Examples
Print only sched
events:
babeltrace2-plugin-text /path/to/trace.lttng | grep sched
Generate a full trace from a specific time range:
babeltrace2-plugin-text -f full -s 123456789 -e 987654321 /path/to/trace.lttng
Export all events to CSV format:
babeltrace2-plugin-text -f csv /path/to/trace.lttng > trace.csv
Generate a callgraph for function profiling:
babeltrace2-plugin-text -f callgraph /path/to/trace.lttng > callgraph.dot
Common Issues
Empty output:
- Ensure the input trace file contains events.
- Check if the provided time range is valid.
Unrecognized format:
- Specify a valid format using the
--format
option. Refer to the Options section for available formats.
Integration
Combine with other commands:
- Use
grep
to filter specific events from the output. - Pipe the output to
dot
to generate a graphical representation of callgraphs.