Struct OperationalMetrics 

pub struct OperationalMetrics {
    pub queries_total: AtomicU64,
    pub query_errors: AtomicU64,
    pub query_rate_limited: AtomicU64,
    pub vector_queries: AtomicU64,
    pub graph_queries: AtomicU64,
    pub hybrid_queries: AtomicU64,
    pub documents_total: AtomicU64,
    pub index_size_bytes: AtomicU64,
    pub active_connections: AtomicU64,
}

Operational metrics for VelesDB monitoring (EPIC-050 US-001).

Thread-safe counters and gauges that can be exported in Prometheus format.

Fields

queries_total: AtomicU64

Total queries executed

query_errors: AtomicU64

Total query errors

query_rate_limited: AtomicU64

Queries rejected by guard rails (rate limiting, circuit breaker)

vector_queries: AtomicU64

Vector search queries

graph_queries: AtomicU64

Graph traversal queries

hybrid_queries: AtomicU64

Hybrid queries (vector + graph)

documents_total: AtomicU64

Total documents across all collections

index_size_bytes: AtomicU64

Total index size in bytes

active_connections: AtomicU64

Active connections (for server)

Implementations

impl OperationalMetrics

pub fn new() -> Self

Creates a new metrics instance.

pub fn new_arc() -> Arc<Self>

Creates a fresh metrics instance wrapped in an Arc for shared ownership across handlers.

This is a constructor convenience — every call returns a brand-new counter set. Callers that want a single workspace-wide instance must hold the returned Arc themselves (e.g. in AppState) and clone it where needed; this method does NOT back the instance with a global cache.

pub fn shared() -> Arc<Self>

👎Deprecated since 1.13.2:

use OperationalMetrics::new_arc instead

Deprecated alias of OperationalMetrics::new_arc.

The original name implied a global singleton, but the implementation always returned a fresh Arc::new(Self::new()). Kept as a forwarding alias to preserve the v1.13.1 public API surface; callers should migrate to new_arc.

pub fn inc_queries(&self)

Increments the total query counter.

pub fn inc_errors(&self)

Increments the query error counter.

pub fn inc_rate_limited(&self)

Increments the rate-limited/rejected counter.

pub fn record_vector_query(&self)

Records a vector search query.

pub fn record_graph_query(&self)

Records a graph traversal query.

pub fn record_hybrid_query(&self)

Records a hybrid query.

pub fn set_documents(&self, count: u64)

Sets the document count.

pub fn set_index_size(&self, bytes: u64)

Sets the index size.

pub fn inc_connections(&self)

Increments active connections.

pub fn dec_connections(&self)

Decrements active connections.

Uses fetch_update to saturate at 0, preventing underflow wrap to u64::MAX.

pub fn export_prometheus(&self) -> String

Exports metrics in Prometheus text format.

Trait Implementations

impl Debug for OperationalMetrics

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OperationalMetrics

fn default() -> OperationalMetrics

Returns the “default value” for a type.