Configuring Trace Levels
Trace output verbosity is determined by the following sources, listed in order of precedence:
- Verbosity flags (
-v
/--verbose
,-vv
/--very-verbose
). If these flags are provided, they override all other settings. - The
SPICED_LOG
environment variable. This is used only if verbosity flags are not set - The
runtime.output_level
YAML configuration file. This is used only if neither verbosity flags nor the environment variable are set.
Default​
The default trace level is INFO
, suitable for general information about the system.
SPICED_LOG="task_history=INFO,spiced=INFO,runtime=INFO,secrets=INFO,data_components=INFO,cache=INFO,extensions=INFO,spice_cloud=INFO,llms=INFO,reqwest_retry::middleware=off,WARN"
The equivalent runtime.output_level
configuration is info
:
runtime:
output_level: info
Enabling Debug Mode​
Use the -v
/--verbose
CLI flags to enable detailed logs, useful for debugging.
spice run -v
spiced -v
Alternatively you can use runtime.output_level
yaml configuration:
runtime:
output_level: verbose
This sets SPICED_LOG
to DEBUG
level:
SPICED_LOG="task_history=DEBUG,spiced=DEBUG,runtime=DEBUG,secrets=DEBUG,data_components=DEBUG,cache=DEBUG,extensions=DEBUG,spice_cloud=DEBUG,llms=DEBUG,DEBUG" spice run
Enabling Trace Mode​
Use the -vv
/--very-verbose
CLI flag to enable the most detailed logs, typically for in-depth troubleshooting.
spice run -vv
spiced -vv
Alternatively you can use runtime.output_level
yaml configuration:
runtime:
output_level: very_verbose
This sets SPICED_LOG
to TRACE
level:
SPICED_LOG="task_history=TRACE,spiced=TRACE,runtime=TRACE,secrets=TRACE,data_components=TRACE,cache=TRACE,extensions=TRACE,spice_cloud=TRACE,llms=TRACE,TRACE" spice run
Granular Configuration​
For specific component trace configuration, adjust the trace levels as needed:
SPICED_LOG="spiced=INFO,runtime=DEBUG,data_components=WARN,cache=WARN" spice run