beyond-handoff 0.1.2

Zero-downtime atomic binary handoff for long-running daemons
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

//! Observability name constants.
//!
//! These are **naming contracts**, not emitted values. The library does not
//! itself register or update any metric; consumers wire these constants into
//! their own metrics backend (Prometheus, OpenTelemetry, …) so dashboards
//! stay consistent across daemons that embed `handoff`. The `tracing` events
//! in `events::*` are emitted by the library directly.

/// Counters and histograms.
pub const HANDOFFS_TOTAL: &str = "handoff_handoffs_total";
pub const HANDOFFS_FAILED_TOTAL: &str = "handoff_failures_total";
pub const HANDOFFS_ROLLED_BACK_TOTAL: &str = "handoff_rolled_back_total";
pub const SEAL_FAILURES_TOTAL: &str = "handoff_seal_failures_total";

pub const HANDOFF_DURATION_SECONDS: &str = "handoff_duration_seconds";
pub const HANDOFF_DRAIN_SECONDS: &str = "handoff_drain_seconds";
pub const HANDOFF_SEAL_SECONDS: &str = "handoff_seal_seconds";
pub const HANDOFF_BEGIN_TO_READY_SECONDS: &str = "handoff_begin_to_ready_seconds";

/// `tracing` event names — emitted as spans or events per phase transition.
pub mod events {
    pub const PREPARE: &str = "handoff.prepare";
    pub const DRAINED: &str = "handoff.drained";
    pub const SEAL: &str = "handoff.seal";
    pub const SEAL_COMPLETE: &str = "handoff.seal_complete";
    pub const READY: &str = "handoff.ready";
    pub const COMMIT: &str = "handoff.commit";
    pub const ABORT: &str = "handoff.abort";
    pub const RESUME: &str = "handoff.resume";
}