canic-host 0.110.29

Host-side App build and desired-state Fleet reconciliation library for Canic workspaces
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

//! Module: fleet_ensure::dto::observation
//!
//! Responsibility: expose bounded timing evidence for existing observation stages.
//! Does not own: planning authority, cached state, retries, or remote effects.
//! Boundary: elapsed time and logical transport attempts are diagnostic only.

use serde::Serialize;

/// Existing observation boundary whose elapsed cost is measured.
#[derive(Clone, Copy, Debug, Eq, PartialEq, Serialize)]
#[serde(rename_all = "snake_case")]
pub enum FleetObservationStage {
    ConfiguredCanisters,
    EstateFunding,
    FleetSnapshot,
    LedgerFee,
    OperatorBalance,
    Planning,
    PoolBalances,
    ProtocolActions,
    ProtocolReadiness,
    RootManagement,
    TerminalInventory,
}

/// Completed stage measurement, emitted on success and failure.
#[derive(Clone, Debug, Eq, PartialEq, Serialize)]
pub struct FleetObservationTiming {
    pub stage: FleetObservationStage,
    /// Enclosing inclusive stage, if any; child counts must not be added to its totals.
    pub parent_stage: Option<FleetObservationStage>,
    pub elapsed_millis: u128,
    /// Logical host transport attempts, including failures; excludes internal IC hops.
    pub remote_call_attempts: u64,
    /// Local ICP identity Principal lookups, including failures.
    pub identity_lookup_attempts: u64,
    /// Responses served from the current observation cache, including repeated consumers.
    pub cached_read_hits: u64,
    pub succeeded: bool,
}