Fuel Core Trace

This crate provides a simple way to enable tracing for tests across the fuel repo.

Usage

To enable tracing for a test, add the following to the lib.rs file of the crate you want to trace:

rust

#[cfg(test)]
fuel_core_trace::enable_tracing!();

If you also want tracing in your integration tests, you need to add the above to each integration tests file.

Tracing is still disabled by default so to enable it set the following environment variable:

bash

export FUEL_TRACE=1

Or if you just want it for a single test run:

bash

FUEL_TRACE=1 cargo test

Now you will have error level tracing like:

2023-01-25T02:27:14.362856Z ERROR works: tracing: I'm visible if FUEL_TRACE=1 is set

You can use the RUST_LOG environment variable to control the level of tracing you want to see. For example:

bash

FUEL_TRACE=1 RUST_LOG=trace cargo test

You can set a few different types of subscribers:

Compact output:

bash

FUEL_TRACE=compact cargo test

Pretty output:

bash

FUEL_TRACE=pretty cargo test

Log to file:

bash

FUEL_TRACE=log-file cargo test

Log to file and output to console:

bash

FUEL_TRACE=log-show cargo test

You can also set the log file path:

bash

FUEL_TRACE_PATH=/some/path FUEL_TRACE=log-file cargo test

If you don't set the path, it will default to CARGO_MANIFEST_DIR/logs/logfile.