mirror of
https://github.com/taoensso/telemere.git
synced 2025-12-31 23:18:24 +00:00
26 lines
1.1 KiB
Text
26 lines
1.1 KiB
Text
A signal will be provided to a handler iff ALL of the following are true:
|
|
1. Signal (creation) is allowed by compile-time filters
|
|
2. Signal (creation) is allowed by runtime filters
|
|
3. Signal (handling) is allowed by handler filters
|
|
|
|
4. Signal middleware does not suppress the signal (return nil)
|
|
5. Handler middleware does not suppress the signal (return nil)
|
|
|
|
For 1-3, filtering may depend on (in order):
|
|
Sample rate → namespace → kind → id → level → when form/fn → rate limit
|
|
|
|
Note that sample rates are multiplicative:
|
|
If a signal is created with 20% sampling and a handler handles 50%
|
|
of given signals, then 10% of possible signals will be handled.
|
|
|
|
This multiplicative rate is helpfully reflected in each signal's final
|
|
`:sample-rate` value.
|
|
|
|
For a visual flowchart, see: Ref. <https://www.taoensso.com/telemere/flow>
|
|
|
|
For more info:
|
|
- On signal filters, see: `help:signal-filters` docstring
|
|
- On handler filters, see: `help:signal-handlers` docstring
|
|
|
|
If anything is unclear, please ping me (@ptaoussanis) so that I can
|
|
improve these docs!
|