#delays #events #analyzing #recording #tokio #loops #eld

tokio-eld

Histogram-based sampler for recording and analyzing event loop delays

2 unstable releases

0.2.0 Nov 17, 2024
0.1.0 Nov 16, 2024

#571 in Math

Download history 881/week @ 2024-11-17 1007/week @ 2024-11-24 1227/week @ 2024-12-01 1670/week @ 2024-12-08 1639/week @ 2024-12-15 1490/week @ 2024-12-22 1414/week @ 2024-12-29 1368/week @ 2025-01-05 2123/week @ 2025-01-12 1636/week @ 2025-01-19 1807/week @ 2025-01-26 1517/week @ 2025-02-02 1715/week @ 2025-02-09 1960/week @ 2025-02-16 2409/week @ 2025-02-23 1929/week @ 2025-03-02

8,169 downloads per month
Used in 13 crates (via deno_node)

MIT/Apache

7KB
82 lines

Crates.io

Documentation

tokio_eld provides a histogram-based sampler for recording and analyzing event loop delays in a current_thread Tokio runtime. The API is similar to Node.js's perf_hooks.monitorEventLoopDelay().

use tokio_eld::EldHistogram;

let mut histogram = EldHistogram::<u64>::new(20)?; // 20 ms resolution

h.start();
// do some work
h.stop();

println!("min: {}", h.min());
println!("max: {}", h.max());
println!("mean: {}", h.mean());
println!("stddev: {}", h.stdev());
println!("p50: {}", h.value_at_percentile(50.0));
println!("p90: {}", h.value_at_percentile(90.0));

lib.rs:

tokio_eld provides a histogram-based sampler for recording and analyzing event loop delays in a current_thread Tokio runtime. The API is similar to Node.js's perf_hooks.monitorEventLoopDelay().

EldHistogram

EldHistogram supports recording and analyzing event loop delay using a High Dynamic Range (HDR) Histogram. The recorded delays are in nanoseconds.

Refer to documentation for hdrhistogram::Histogram for more information on how to use the core data structure.

Usage

use tokio_eld::EldHistogram;

let mut h = EldHistogram::<u64>::new(20).unwrap();
h.start();
// do some work
h.stop();

println!("min: {}", h.min());
println!("max: {}", h.max());
println!("mean: {}", h.mean());
println!("stddev: {}", h.stdev());
println!("p50: {}", h.value_at_percentile(50.0));
println!("p90: {}", h.value_at_percentile(90.0));

Dependencies

~2.5–8MB
~56K SLoC