1use std::time::Duration;
4
5use crate::origin::{OriginKey, Protocol};
6
7#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
9pub enum ConnectPhase {
10 Dns,
11 Tcp,
12 Tls,
13}
14
15impl ConnectPhase {
16 #[must_use]
18 pub const fn as_str(self) -> &'static str {
19 match self {
20 Self::Dns => "dns",
21 Self::Tcp => "tcp",
22 Self::Tls => "tls",
23 }
24 }
25}
26
27#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
29pub enum ScaleReason {
30 Saturated,
32 Waiters,
34 Min,
36 Idle,
38 Underused,
40 Expired,
42 Replace,
44}
45
46impl ScaleReason {
47 #[must_use]
49 pub const fn as_str(self) -> &'static str {
50 match self {
51 Self::Saturated => "saturated",
52 Self::Waiters => "waiters",
53 Self::Min => "min",
54 Self::Idle => "idle",
55 Self::Underused => "underused",
56 Self::Expired => "expired",
57 Self::Replace => "replace",
58 }
59 }
60}
61
62#[allow(unused_variables, reason = "default no-op bodies")]
65pub trait Observer: Send + Sync + 'static {
66 fn enabled(&self) -> bool {
68 false
69 }
70 fn request_queued(&self, o: &OriginKey, wait: Duration) {}
72 fn request_dispatched(&self, o: &OriginKey, delay: Duration) {}
74 fn connect_phase(&self, o: &OriginKey, phase: ConnectPhase, d: Duration, ok: bool) {}
75 fn connection_opened(&self, o: &OriginKey, p: Protocol) {}
76 fn connection_closed(&self, o: &OriginKey, p: Protocol, lifetime: Duration) {}
77 fn write_batch(&self, o: &OriginKey, bytes: usize, iovecs: usize) {}
78 fn bytes_read(&self, o: &OriginKey, n: usize) {}
79 fn actor_tick(&self, o: &OriginKey, busy: Duration, queue_depth: usize) {}
80 fn flow_control_stall(&self, o: &OriginKey, d: Duration) {}
81 fn h2_goaway(&self, o: &OriginKey, code: u32) {}
82 fn h2_rst_stream(&self, o: &OriginKey, code: u32, sent: bool) {}
83 fn pool_waiters(&self, o: &OriginKey, n: usize) {}
84 fn pool_scaled(&self, o: &OriginKey, conns: usize, reason: ScaleReason) {}
87}
88
89#[derive(Clone, Copy, Debug, Default)]
91pub struct NoopObserver;
92
93impl Observer for NoopObserver {}