kotoba-projection-engine 0.1.21

Real-time projection engine for GraphDB materialization using RocksDB
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

//! Metrics Collection
//!
//! Metrics collection for projection engine performance monitoring.

use std::sync::Arc;
use tokio::sync::RwLock;
use metrics::{counter, histogram, gauge};
use serde::{Deserialize, Serialize};

/// Metrics collector for projection engine
pub struct MetricsCollector {
    stats: Arc<RwLock<ProjectionMetrics>>,
}

impl MetricsCollector {
    /// Create new metrics collector
    pub fn new() -> Self {
        Self {
            stats: Arc::new(RwLock::new(ProjectionMetrics::default())),
        }
    }

    /// Record event processing
    pub async fn record_event_processed(&self, processing_time_ms: f64) {
        let mut stats = self.stats.write().await;
        stats.total_events_processed += 1;
        stats.total_processing_time_ms += processing_time_ms;

        // Update metrics
        // counter!("projection_engine.events_processed", 1);
        // histogram!("projection_engine.processing_time", processing_time_ms);

        // Update average
        if stats.total_events_processed > 0 {
            stats.avg_processing_time_ms = stats.total_processing_time_ms / stats.total_events_processed as f64;
        }
    }

    /// Record cache hit
    pub async fn record_cache_hit(&self) {
        let mut stats = self.stats.write().await;
        stats.cache_hits += 1;
        // counter!("projection_engine.cache_hits", 1);
    }

    /// Record cache miss
    pub async fn record_cache_miss(&self) {
        let mut stats = self.stats.write().await;
        stats.cache_misses += 1.0;
        // counter!("projection_engine.cache_misses", 1);
    }

    /// Record projection creation
    pub async fn record_projection_created(&self) {
        let mut stats = self.stats.write().await;
        stats.active_projections += 1;
        // gauge!("projection_engine.active_projections", stats.active_projections as f64);
        // counter!("projection_engine.projections_created", 1);
    }

    /// Record projection deletion
    pub async fn record_projection_deleted(&self) {
        let mut stats = self.stats.write().await;
        if stats.active_projections > 0 {
            stats.active_projections -= 1;
        }
        // gauge!("projection_engine.active_projections", stats.active_projections as f64);
        // counter!("projection_engine.projections_deleted", 1);
    }

    /// Get current metrics
    pub async fn get_metrics(&self) -> ProjectionMetrics {
        self.stats.read().await.clone()
    }

    /// Reset metrics
    pub async fn reset_metrics(&self) {
        let mut stats = self.stats.write().await;
        *stats = ProjectionMetrics::default();
    }
}

/// Projection metrics data
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ProjectionMetrics {
    pub total_events_processed: u64,
    pub total_processing_time_ms: f64,
    pub avg_processing_time_ms: f64,
    pub cache_hits: u64,
    pub cache_misses: f64,
    pub active_projections: u64,
    pub total_projections_created: u64,
    pub total_projections_deleted: u64,
}

impl Default for ProjectionMetrics {
    fn default() -> Self {
        Self {
            total_events_processed: 0,
            total_processing_time_ms: 0.0,
            avg_processing_time_ms: 0.0,
            cache_hits: 0,
            cache_misses: 0.0,
            active_projections: 0,
            total_projections_created: 0,
            total_projections_deleted: 0,
        }
    }
}

impl Default for MetricsCollector {
    fn default() -> Self {
        Self::new()
    }
}