strest 0.1.10

Blazing-fast async HTTP load tester in Rust - lock-free design, real-time stats, distributed runs, and optional chart exports for high-load API testing.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

use std::collections::VecDeque;
use std::time::Duration;

use tokio::time::Instant;

pub(in crate::metrics::collector) fn prune_latency_window(
    window: &mut VecDeque<(Instant, u64)>,
    now: Instant,
    window_span: Duration,
) {
    while window
        .front()
        .is_some_and(|(ts, _)| now.duration_since(*ts) > window_span)
    {
        window.pop_front();
    }
}

pub(in crate::metrics::collector) fn prune_rps_window(
    window: &mut VecDeque<(Instant, u64)>,
    now: Instant,
) {
    while window
        .front()
        .is_some_and(|(ts, _)| now.duration_since(*ts) > Duration::from_secs(60))
    {
        window.pop_front();
    }
}

pub(in crate::metrics::collector) fn prune_bytes_window(
    window: &mut VecDeque<(Instant, u64)>,
    now: Instant,
) {
    while window
        .front()
        .is_some_and(|(ts, _)| now.duration_since(*ts) > Duration::from_secs(60))
    {
        window.pop_front();
    }
}

pub(in crate::metrics::collector) fn record_rps_sample(
    samples: &mut VecDeque<(Instant, u64)>,
    now: Instant,
    rps: u64,
    window_span: Duration,
) {
    samples.push_back((now, rps));
    prune_rps_samples(samples, now, window_span);
}

fn prune_rps_samples(samples: &mut VecDeque<(Instant, u64)>, now: Instant, window_span: Duration) {
    while samples
        .front()
        .is_some_and(|(ts, _)| now.duration_since(*ts) > window_span)
    {
        samples.pop_front();
    }
}

pub(in crate::metrics::collector) fn record_bytes_sample(
    samples: &mut VecDeque<(Instant, u64)>,
    now: Instant,
    bytes_per_sec: u64,
    window_span: Duration,
) {
    samples.push_back((now, bytes_per_sec));
    prune_bytes_samples(samples, now, window_span);
}

fn prune_bytes_samples(
    samples: &mut VecDeque<(Instant, u64)>,
    now: Instant,
    window_span: Duration,
) {
    while samples
        .front()
        .is_some_and(|(ts, _)| now.duration_since(*ts) > window_span)
    {
        samples.pop_front();
    }
}

pub(in crate::metrics::collector) fn compute_percentiles(
    window: &VecDeque<(Instant, u64)>,
) -> (u64, u64, u64) {
    if window.is_empty() {
        return (0, 0, 0);
    }

    let mut values: Vec<u64> = window.iter().map(|(_, latency)| *latency).collect();
    values.sort_unstable();

    let p50 = percentile(&values, 50);
    let p90 = percentile(&values, 90);
    let p99 = percentile(&values, 99);

    (p50, p90, p99)
}

fn percentile(data: &[u64], percentile: u64) -> u64 {
    if data.is_empty() {
        return 0;
    }
    let count = data.len().saturating_sub(1) as u64;
    let index = (percentile.saturating_mul(count).saturating_add(50) / 100) as usize;
    *data.get(index).unwrap_or(&0)
}