This project uses Break Versioning.

---

v1.0.0-beta22 (2024-08-28)

📦 Available on Clojars: Telemere | SLF4J provider | Facade API for library authors
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

Beta 22, 21, 20:

• [mod] Move dep: com.taoensso/slf4j-telemere -> com.taoensso/telemere-slf4j [77ed27cfd] (beta 22)
• [mod] Generalize "intake", rename -> "interop" [ef678bcc] (beta 20)
• [mod] Make :host output opt-in for default signal handlers [88eb5211] (beta 20)

Earlier:

• [mod] OpenTelemetry handler: rename (generalize) [064ef323] (beta 19)
• [mod] OpenTelemetry handler: revert #10 [599236f4] (beta 18)
• [mod] Decrease level of :on-init signals [4d2b5d46] (beta 18)
• [mod] Removed *auto-stop-handlers?* var (beta 15)
• [mod] Removed :needs-stopping? handler dispatch opt (beta 15)
• [mod] Cljs handlers MUST now include stop (0) arity (beta 15)
• [mod] Users MUST now manually call stop-handlers! (beta 15)
• [mod] SLF4J and tools.logging signals now have a custom :kind and no :id (beta 14)
• [mod] Renamed get-min-level -> get-min-levels (beta 13)
• [mod] Renamed shut-down-handlers! -> stop-handlers! (beta 13)
• [mod] Changed default handler back-pressure mechanism from :dropping to :blocking (eaiser for most users to understand and detect; override when calling add-handler!) (beta 11)
• [mod] pr-signal-fn now takes only a single opts map (beta 10)
• [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 (beta 7)
• [mod] Middleware must now be a single fn, use comp-middleware to create one fn from many (beta 7)
• [mod] OpenTelemetry handler is no longer auto added (beta 1)
• [mod] Various API improvements to included handlers and utils

Recent additions

Beta 22, 21, 20:

• [new] Added experimental facade API for library authors [ece51b2ef] (beta 22)
• [new] Auto stop existing handler when replacing it (beta 22)
• [new] Added "(.*)" wildcard syntax to kind/ns/id filters (beta 22)
• [new] Internal and doc improvements: [8066776a8], [b4b06f324], [3068ccf8d] (beta 21)
• [new] OpenTelemetry handler: improve span interop [84957c6d] (beta 20)

Earlier:

• [new] OpenTelemetry handler: add experimental trace output [67cb4941] (beta 18)
• [new] Improve uid control, switch to nano-style by default [5ab2736c] (beta 18)
• [new] Add host info to signal content [1cef1957] (beta 18)
• [new] Add extra tracing info to signal content [d635318f] (beta 18)
• [new] Ongoing API and wiki doc improvements (beta 15)
• [new] [#5] Added comparison to Mulog (beta 15)
• [new] SLF4J and tools.logging signals now have a namespace (from logger name) (beta 14)
• [new] Added get-handlers-stats (beta 13)
• [new] add-handler! can now specify per-handler :drain-msecs (beta 13)
• [new] Added *auto-stop-handlers?* (beta 13)
• [new] remove-handler! now auto stops relevant handlers after removal (beta 13)
• [new] with-handler and with-handler+ now auto stops relevant handlers after use (beta 12)
• [new] (Advanced) Handler fns can now include :dispatch-opts metadata, useful for handler authors that want to set defaults for use by add-handler! (beta 8)
• [new] Added Slack handler (beta 8)
• [new] Added TCP and UDP socket handlers (beta 7)
• [new] Clj signal content now includes :thread {:keys [group name id]} key (beta 7)
• [new] Added postal (email) handler (beta 5)
• [new] Handlers now block to try drain their signal queues on shutdown (beta 3)
• [new] Rate limiter performance improvements (via Encore) (beta 3)

Recent fixes

Beta 22, 21, 20:

• [fix] Signal :line info missing for some wrapped-macro cases [0f09b797e] (beta 22)

Earlier:

• [fix] OpenTelemetry handler: use signal callsite Context as root span parent [a8e92303] (beta 19)
• [fix] [#16] OpenTelemetry handler: coerce line attrs (@flyingmachine) [17349a08] (beta 19)
• [fix] Decrease min Java version (11->8) (@flyingmachine) [a1c50f10] (beta 19)
• [fix] Broken handler ns and kind filters [23194238] (beta 16)
• [fix] [#10] OpenTelemetry handler: render keywords as plain strings [6e94215e] (beta 15)
• [fix] [#11] OpenTelemetry handler: signals without message fail [863cea15] (beta 15)
• [fix] [#14] File handler: Don't truncate gzip output [2d4b0497] (beta 15)
• [fix] Don't drop signals while draining async buffer during shutdown, add tests (via Encore) (beta 12, beta 13)
• [fix] pr-signal-fn wasn't realizing delayed messages, add tests [cf72017a] (beta 11)
• [fix] pr-signal-fn broken custom pr-fn support, add tests [e7cce0c1] (beta 10)
• [fix] [#6] Missing root stack trace, add tests [213c6470] (beta 9)
• [fix] Broken AOT support, add tests [ffea1a30] (beta 1)
• [fix] SLF4J broken timestamps, add tests [e222297a] (beta 1)