title: 'Configuring Trace Levels'
sidebar_label: 'Trace Levels'
description: 'Configuring Spice.ai OSS trace output verbosity levels'
pagination_prev: null
tags:
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
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,ballista=INFO,datafusion=INFO,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,delta_kernel::listed_log_files=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=off,tower::buffer=off,h2::codec=off,WARN"
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,ballista=INFO,datafusion=INFO,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,delta_kernel::listed_log_files=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=off,tower::buffer=off,h2::codec=off,WARN"
The equivalent runtime.output_level configuration is info:
runtime:
output_level: info
runtime:
output_level: info
Enabling Debug Mode
Use the -v/--verbose CLI flags to enable detailed logs, useful for debugging.
Alternatively you can use runtime.output_level yaml configuration:
runtime:
output_level: verbose
runtime:
output_level: verbose
This raises Spice's own components to DEBUG. Everything else falls back to INFO, and the same handful of noisy targets stay held down — turned off outright:
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,ballista=DEBUG,datafusion=DEBUG,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,delta_kernel::listed_log_files=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=off,tower::buffer=off,h2::codec=off,INFO" spice run
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,ballista=DEBUG,datafusion=DEBUG,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,delta_kernel::listed_log_files=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=off,tower::buffer=off,h2::codec=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.
Alternatively you can use runtime.output_level yaml configuration:
runtime:
output_level: very_verbose
runtime:
output_level: very_verbose
This raises Spice's own components to TRACE. Everything else falls back to DEBUG, and a few noisy targets stay held down — turned off outright:
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,ballista=TRACE,datafusion=TRACE,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,delta_kernel::listed_log_files=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=off,tower::buffer=off,h2::codec=off,DEBUG" spice run
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,ballista=TRACE,datafusion=TRACE,reqwest_retry::middleware=off,opentelemetry_sdk=off,delta_kernel::log_segment=off,delta_kernel::listed_log_files=off,aws_config::imds::region=off,aws_config::meta::credentials::chain=off,tower::buffer=off,h2::codec=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
SPICED_LOG="spiced=INFO,runtime=DEBUG,data_components=WARN,cache=WARN" spice run
