Dep/s: Telemere and Telemere SLF4J provider are on Clojars.
Versioning: Telemere uses Break Versioning.

This is a pre-release intended for early adopters and those who'd like to give feedback. New betas will be released frequently, while I continue to fix issues and make other improvements/additions.

The included handlers and utils are still undergoing changes, though the signal creator and signal content APIs should already be mostly stable.

Please report any unexpected problems on GitHub or the Slack channel, thank you! 🙏

- Peter Taoussanis

Recent changes

• [mod] SLF4J and tools.logging signals now have a custom :kind and no :id (beta14)
• [mod] Renamed get-min-level -> get-min-levels (beta13)
• [mod] Renamed shut-down-handlers! -> stop-handlers! (beta13)
• [mod] Changed default handler back-pressure mechanism from :dropping to :blocking (eaiser for most users to understand and detect; override when calling add-handler!) (beta11)
• [mod] pr-signal-fn now takes only a single opts map (beta10)
• [mod] User-level kvs are no longer included by default in handler output. :incl-kvs? option has been added to format-signal-fn and pr-signal-fn (beta7)
• [mod] Middleware must now be a single fn, use comp-middleware to create one fn from many (beta7)
• [mod] OpenTelemetry handler is no longer auto added (beta1)
• [mod] Various API improvements to included handlers and utils

Recent additions

• [new] Ongoing API and wiki doc improvements
• [new] SLF4J and tools.logging signals now have a namespace (from logger name) (beta14)
• [new] Added get-handlers-stats (beta13)
• [new] add-handler! can now specify per-handler :drain-msecs (beta13)
• [new] Added *auto-stop-handlers?* (beta13)
• [new] remove-handler! now auto stops relevant handlers after removal (beta13)
• [new] with-handler and with-handler+ now auto stops relevant handlers after use (beta12)
• [new] (Advanced) Handler fns can now include :dispatch-opts metadata, useful for handler authors that want to set defaults for use by add-handler! (beta8)
• [new] Added Slack handler (beta8)
• [new] Added TCP and UDP socket handlers (beta7)
• [new] Clj signal content now includes :thread {:keys [group name id]} key (beta7)
• [new] Added postal (email) handler (beta5)
• [new] Handlers now block to try drain their signal queues on shutdown (beta3)
• [new] Rate limiter performance improvements (via Encore) (beta3)

Recent fixes

• [fix] Don't drop signals while draining async buffer during shutdown, add tests (via Encore) (beta12, beta13)
• [fix] pr-signal-fn wasn't realizing delayed messages, add tests [cf72017] (beta11)
• [fix] pr-signal-fn broken custom pr-fn support, add tests [e7cce0c] (beta10)
• [fix] [#6] Missing root stack trace, add tests [213c647] (beta9)
• [fix] Broken AOT support, add tests [ffea1a3] (beta1)
• [fix] SLF4J broken timestamps, add tests [e222297] (beta1)

📦 Telemere, Telemere SLF4J provider are on Clojars.
This project uses Break Versioning.

This is Telemere's first public pre-release and mostly intended for early testers and those that'd like to give feedback.

While no significant changes are expected before the planned v1.0 final release, you probably don't want to use this in production just yet.

Please report any unexpected problems and let me know if anything is unclear, inconvenient, etc. Now's the ideal time to get any last-minute changes in. Thank you! 🙏

- Peter Taoussanis