Documentation | Latest releases | Get support

Timbre

Pure Clojure/Script logging library

Getting even the simplest Java logging working can be maddeningly complex, and it often gets worse at scale as your needs become more sophisticated.

Timbre offers an all Clojure/Script alternative that's fast, deeply flexible, easy to configure with pure Clojure data, and that just works out the box.

Supports optional interop with tools.logging and log4j/logback/slf4j.

Latest release/s

• 2023-07-18 v6.2.2 (stable): changes

See here for earlier releases.

Why Timbre?

• Full Clojure & ClojureScript support, with built-in appenders for both.
• A single, simple config map, and you're set. No need for XML or properties files.
• Simple (fn [data]) -> ?effects appenders, and (fn [data]) -> ?data middleware.
• Easily save raw logging arguments to the DB of your choice.
• Easily filter logging calls by any combination of: level, namespace, appender.
• Zero overhead compile-time level/ns elision.
• Powerful, easy-to-configure rate limits and async logging.
• Great performance and flexibility at any scale.
• Small, simple, cross-platform pure-Clojure codebase.

Documentation

• Full documentation (getting started and more)
• Auto-generated API reference: Codox, clj-doc

Funding

You can help support continued work on this project, thank you!! 🙏

License

Copyright © 2014-2023 Peter Taoussanis.
Licensed under EPL 1.0 (same as Clojure).