docs/10_utilities/trace_api_util.md
trace_api_util is a command-line interface (CLI) utility that allows node operators to perform low-level tasks associated with the Trace API Plugin. trace_api_util can perform one of the following operations:
log file into the compressed clog format.trace_api_util <options> command ...
| Option (=default) | Description |
|---|---|
-h [ --help ] | show usage help message |
| Command | Description |
|---|---|
compress | Compress a trace file to into the clog format |
Compress a trace log file into the clog format. By default the name of the compressed file will be the same as the input-path but with the file extension changed to clog.
trace_api_util compress <options> input-path [output-path]
| Option (=default) | Description |
|---|---|
input-path | path to the file to compress |
output-path | [Optional] output file or directory path |
| Option (=default) | Description |
|---|---|
-h [ --help ] | show usage help message |
-s [ --seek-point-stride ] arg (=512) | the number of bytes between seek points in a compressed trace. A smaller stride may degrade compression efficiency but increase read efficiency |
When trace_api_util is launched, the utility attempts to perform the specified operation, then yields the following possible outcomes:
stderr and terminates with a non-zero error code (indicating an error).