Skip to main content

Module tracing

Module tracing 

Source
Expand description

Tracing and loging infrastructure. Includes our custom event log register. Tracing collectors, etc.

Re-exports§

pub use event_aggregator::AOFEventSource;
pub use event_aggregator::EventLogAggregator;
pub use event_aggregator::EventSource;
pub use event_aggregator::RoutingPath;
pub use event_aggregator::TransactionFlowEvent;
pub use event_aggregator::WebSocketEventCollector;
pub use state_verifier::StateVerifier;
pub use state_verifier::VerificationReport;
pub use telemetry::TelemetryReporter;
pub use event_kind::ConnectionType;
pub use event_kind::DisconnectReason;
pub use event_kind::EventKind;
pub use event_kind::HostingStoppedReason;
pub use event_kind::InterestSyncEvent;
pub use event_kind::OperationFailure;
pub use event_kind::PeerLifecycleEvent;
pub use event_kind::TransferDirection;
pub use event_kind::TransferEvent;

Modules§

event_aggregator
Event aggregation across multiple nodes for debugging and testing. Event aggregation infrastructure for correlating transactions across multiple nodes.
event_kind
Event kind types for network events.
state_verifier
Automatic state verification through telemetry linearization. Automatic state verification through telemetry linearization.
telemetry
Telemetry reporting to central collector. Telemetry reporter that sends events to a central OpenTelemetry collector.
tracer

Structs§

ClientGetOutcomeSummary
Client-visible GET outcome tallies — one entry per client GET OPERATION, taken from the authoritative [GetEvent::ClientTerminal] event the GET driver emits exactly once per client op (and the local-cache-hit path emits via emit_local_get_terminal_event).
EventFlushHandle
Handle for flushing an EventRegister (can be stored separately for testing)
GetOutcomeSummary
Per-attempt-transaction GET outcome summary (#4361).
NetLogMessage

Constants§

GET_TIMEOUT_CLASSIFICATION_MS
Failed GET outcomes with elapsed time at or above this threshold are classified as timeouts rather than NotFound (close to the 60s OPERATION_TTL).

Functions§

state_hash_full
Compute a full hash of contract state for convergence verification. Returns all 32 bytes of Blake3 hash as 64 hex characters.
state_hash_short
Compute a short hash of contract state for telemetry display. Returns first 4 bytes of Blake3 hash as 8 hex characters.
summarize_client_get_outcomes
Summarize CLIENT-VISIBLE GET outcomes from an event log — one entry per client GET operation, from [GetEvent::ClientTerminal]. See ClientGetOutcomeSummary for why this differs from the wire-attempt summarize_get_outcomes_per_tx, which double-counts a failed attempt of an ultimately-successful GET and misses local-cache hits.
summarize_get_outcomes_per_tx
Summarize GET outcomes from an event log, deduplicated per attempt transaction. See GetOutcomeSummary for why raw event counting is wrong.