\ No newline at end of file
diff --git a/index.cljs.html b/index.cljs.html
index 5b8c68d..d6e6a3f 100644
--- a/index.cljs.html
+++ b/index.cljs.html
@@ -1,4 +1,4 @@
-Telemere 1.0.0-beta10
\ No newline at end of file
diff --git a/index.html b/index.html
index 7673bff..3a01730 100644
--- a/index.html
+++ b/index.html
@@ -1,3 +1,3 @@
-Telemere 1.0.0-beta10
\ No newline at end of file
diff --git a/taoensso.telemere.cljs.html b/taoensso.telemere.cljs.html
index 5915ea3..b5d72ad 100644
--- a/taoensso.telemere.cljs.html
+++ b/taoensso.telemere.cljs.html
@@ -1,6 +1,6 @@
-taoensso.telemere documentation
Structured telemetry for Clojure/Script applications.
See the GitHub page (esp. Wiki) for info on motivation and design:
<https://www.taoensso.com/telemere>
Dynamic context: arbitrary user-level state attached as `:ctx` to all signals.
@@ -50,10 +50,10 @@ Dispatch options include:
NB handling order may be non-sequential when `n-threads` > 1.
Default:
- {:mode :dropping, :buffer-size 1024, :n-threads 1, :daemon-threads? true}
+ {:mode :blocking, :buffer-size 1024, :n-threads 1, :daemon-threads? true}
- I.e. async by default, with a buffer of size 1024 that drops new entries
- when full.
+ I.e. async by default, with a buffer of size 1024 that blocks on new
+ entries when full.
Options:
`mode` - Mode of operation, ∈ #{:sync :blocking :dropping :sliding}.
@@ -608,23 +608,25 @@ Useful for conditionally splicing in extra message content, etc.:
(log! [(when <cond> (msg-splice ["Username:" "Steve"]))])
%> {:msg_ "Username: Steve"}
Structured telemetry for Clojure/Script applications.
See the GitHub page (esp. Wiki) for info on motivation and design:
<https://www.taoensso.com/telemere>
Dynamic context: arbitrary user-level state attached as `:ctx` to all signals.
@@ -50,10 +50,10 @@ Dispatch options include:
NB handling order may be non-sequential when `n-threads` > 1.
Default:
- {:mode :dropping, :buffer-size 1024, :n-threads 1, :daemon-threads? true}
+ {:mode :blocking, :buffer-size 1024, :n-threads 1, :daemon-threads? true}
- I.e. async by default, with a buffer of size 1024 that drops new entries
- when full.
+ I.e. async by default, with a buffer of size 1024 that blocks on new
+ entries when full.
Options:
`mode` - Mode of operation, ∈ #{:sync :blocking :dropping :sliding}.
@@ -736,23 +736,25 @@ Useful for conditionally splicing in extra message content, etc.:
(log! [(when <cond> (msg-splice ["Username:" "Steve"]))])
%> {:msg_ "Username: Steve"}
\ No newline at end of file
diff --git a/taoensso.telemere.timbre.html b/taoensso.telemere.timbre.html
index 3f2a5c0..7044820 100644
--- a/taoensso.telemere.timbre.html
+++ b/taoensso.telemere.timbre.html
@@ -1,6 +1,6 @@
-taoensso.telemere.timbre documentation
Experimental, subject to change.
-Returns given signal with possible `:error` replaced by
-[{:keys [type msg data]} ...] cause chain.
-
-Useful when serializing signals to edn/JSON/etc.
Experimental, subject to change.
Returns a (fn pr [signal]) that:
- Takes a Telemere signal (map).
- - Returns a machine-readable (minified) signal string.
+ - Returns a machine-readable signal ?string.
Options:
`:pr-fn` - ∈ #{<unary-fn> :edn (default) :json (Cljs only)}
- `:incl-thread?` - Include signal `:thread` info? (default false)
- `:incl-kvs?` - Include signal `:kvs` info? (default false)
- `:incl-newline?` - Include terminating system newline? (default true)
+ `:incl-kvs?` - Include signal's user-level kvs? (default false)
+ `:incl-nils?` - Include signal's keys with nil values? (default false)
+ `:incl-newline?` - Include terminating system newline? (default true)
+ `:incl-keys` - Subset of signal keys to retain from those otherwise
+ excluded by default: #{:location :kvs :file :thread}
Examples:
(pr-signal-fn {:pr-fn :edn ...}) ; Outputs edn
(pr-signal-fn {:pr-fn :json ...}) ; Outputs JSON (Cljs only)
To output JSON for Clj, you must provide an appropriate `:pr-fn`.
- `jsonista` is one good option, Ref. <https://github.com/metosin/jsonista>:
+ `jsonista` offers one good option, Ref. <https://github.com/metosin/jsonista>:
(require '[jsonista.core :as jsonista])
(pr-signal-fn {:pr-fn jsonista/write-value-as-string ...})
-See also `format-signal-fn` for human-readable output.
Experimental, subject to change.
-Returns given signal with possible `:error` replaced by
-[{:keys [type msg data]} ...] cause chain.
-
-Useful when serializing signals to edn/JSON/etc.
Experimental, subject to change.
Opens the specified file and returns a stateful fn of 2 arities:
@@ -50,44 +46,40 @@ Options:
See also `pr-signal-fn` for machine-readable output.
host-ip
clj
(host-ip timeout-msecs timeout-val)(host-ip)
Returns cached local host IP address string, or `timeout-val` (default "UnknownHost").
hostname
clj
(hostname timeout-msecs timeout-val)(hostname)
Returns cached local hostname string, or `timeout-val` (default "UnknownHost").
-
Experimental, subject to change.
Returns a (fn pr [signal]) that:
- Takes a Telemere signal (map).
- - Returns a machine-readable (minified) signal string.
+ - Returns a machine-readable signal ?string.
Options:
`:pr-fn` - ∈ #{<unary-fn> :edn (default) :json (Cljs only)}
- `:incl-thread?` - Include signal `:thread` info? (default false)
- `:incl-kvs?` - Include signal `:kvs` info? (default false)
- `:incl-newline?` - Include terminating system newline? (default true)
+ `:incl-kvs?` - Include signal's user-level kvs? (default false)
+ `:incl-nils?` - Include signal's keys with nil values? (default false)
+ `:incl-newline?` - Include terminating system newline? (default true)
+ `:incl-keys` - Subset of signal keys to retain from those otherwise
+ excluded by default: #{:location :kvs :file :thread}
Examples:
(pr-signal-fn {:pr-fn :edn ...}) ; Outputs edn
(pr-signal-fn {:pr-fn :json ...}) ; Outputs JSON (Cljs only)
To output JSON for Clj, you must provide an appropriate `:pr-fn`.
- `jsonista` is one good option, Ref. <https://github.com/metosin/jsonista>:
+ `jsonista` offers one good option, Ref. <https://github.com/metosin/jsonista>:
(require '[jsonista.core :as jsonista])
(pr-signal-fn {:pr-fn jsonista/write-value-as-string ...})
-See also `format-signal-fn` for human-readable output.