replikativ.logging — org.replikativ/logging 0.1.3

Unified structured logging for replikativ projects using trove facade.

All log calls require a namespaced keyword ID for structured filtering.

Provides level macros (trace, debug, info, warn, error), a raise macro for logging + throwing, and timing utilities.

Usage: (require '[replikativ.logging :as log])

;; message only (for backwards compatibility) (log/info "Using config")

;; ID + message (log/info :datahike/connector "Using config")

;; ID + message + data (log/info :datahike/connector "Using config" {:config c})

;; ID + data only (log/info :datahike/connector {:config c})

;; Error logging + throw (log/raise "Invalid input" {:type :validation-error :input x})

;; Timing (log/with-timing :info :component/op "msg" (body))

debug clj/s macro

(debug msg)

(debug id msg-or-data)

(debug id msg data)

debug-timing clj/s macro

(debug-timing id msg & body)

Execute body and log duration at DEBUG level.

error clj/s macro

(error msg)

(error id msg-or-data)

(error id msg data)

info clj/s macro

(info msg)

(info id msg-or-data)

(info id msg data)

info-timing clj/s macro

(info-timing id msg & body)

Execute body and log duration at INFO level.

raise clj/s macro

(raise & fragments)

Logging an error and throwing an exception with message and structured data. Arguments:

• Any number of strings that describe the error
• Last argument is a map of data that helps understanding the source of the error

trace clj/s macro

(trace msg)

(trace id msg-or-data)

(trace id msg data)

warn clj/s macro

(warn msg)

(warn id msg-or-data)

(warn id msg data)

with-timing clj/s macro

(with-timing level id msg & body)

Execute body and log duration at specified level. Returns the result of body.