Configuring Trace Levels

Trace output verbosity is determined by the following sources, listed in order of precedence:

1. Verbosity flags (-v/--verbose, -vv/--very-verbose). If these flags are provided, they override all other settings.
2. The SPICED_LOG environment variable. This is used only if verbosity flags are not set
3. The runtime.output_level YAML configuration file. This is used only if neither verbosity flags nor the environment variable are set.

Default

Spice's own components log at INFO, suitable for general information about the system. Everything else — the libraries the runtime is built on — logs at WARN, and a handful of particularly noisy targets are turned off outright.

SPICED_LOG="app=INFO,task_history=INFO,spiced=INFO,runtime=INFO,secrets=INFO,data_components=INFO,cache=INFO,extensions=INFO,spice_cloud=INFO,llms=INFO,tpc_extension=INFO,workers=INFO,search=INFO,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=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 raises Spice's own components to DEBUG and everything else to INFO:

SPICED_LOG="app=DEBUG,task_history=DEBUG,spiced=DEBUG,runtime=DEBUG,secrets=DEBUG,data_components=DEBUG,cache=DEBUG,extensions=DEBUG,spice_cloud=DEBUG,llms=DEBUG,tpc_extension=DEBUG,workers=DEBUG,search=DEBUG,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=off,INFO" 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 raises Spice's own components to TRACE and everything else to DEBUG:

SPICED_LOG="app=TRACE,task_history=TRACE,spiced=TRACE,runtime=TRACE,secrets=TRACE,data_components=TRACE,cache=TRACE,extensions=TRACE,spice_cloud=TRACE,llms=TRACE,tpc_extension=TRACE,workers=TRACE,search=TRACE,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=off,DEBUG" 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