← BACK TO RIGGING

timbre

High quality, structured logging.

Timbre - Turn those logs into quality lumber 🪵

Debugging a program with tons of output? Pass them to timbre

CI

Features

  • Pure zig, even the regex lib
  • Log filter with regex!
  • Categorize your logs to each filter
  • [Optional] toml configuration
./app_with_tons_of_output | timbre

Structured logs add soundness to the noise of development. Add custom filters and categories to timbre with a configuration file to chop those logs in their respective files.

ls -l .timbre/
  error.log
  warn.log
  info.log
  debug.log

Basic Usage

# Process logs with default settings
./app | timbre

# Use custom configuration
./app | timbre --config=timbre.toml

# Enable verbose output
./app | timbre --verbose

Configuration timbre.toml

[timbre]
log_dir = "/var/log/timbre"

[log_level]
debug = "debug"
warn = "warn(ing)?"
error = "error|exception|fail"