neo3 1.0.8

Production-ready Rust SDK for Neo N3 blockchain with high-level API, unified error handling, and enterprise features
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

// Monitoring module for NeoRust SDK
// Provides metrics, tracing, and observability features

pub mod metrics;
pub mod tracing;
pub mod health;

use once_cell::sync::Lazy;
use std::sync::Arc;

/// Global monitoring configuration
pub static MONITORING: Lazy<Arc<MonitoringConfig>> = Lazy::new(|| {
    Arc::new(MonitoringConfig::from_env())
});

/// Monitoring configuration
#[derive(Debug, Clone)]
pub struct MonitoringConfig {
    pub metrics_enabled: bool,
    pub metrics_port: u16,
    pub tracing_enabled: bool,
    pub tracing_endpoint: String,
    pub log_level: String,
    pub health_check_enabled: bool,
    pub health_check_port: u16,
}

impl MonitoringConfig {
    /// Create configuration from environment variables
    pub fn from_env() -> Self {
        Self {
            metrics_enabled: std::env::var("NEO_METRICS_ENABLED")
                .unwrap_or_else(|_| "true".to_string())
                .parse()
                .unwrap_or(true),
            metrics_port: std::env::var("NEO_METRICS_PORT")
                .unwrap_or_else(|_| "9090".to_string())
                .parse()
                .unwrap_or(9090),
            tracing_enabled: std::env::var("NEO_TRACING_ENABLED")
                .unwrap_or_else(|_| "true".to_string())
                .parse()
                .unwrap_or(true),
            tracing_endpoint: std::env::var("NEO_TRACING_ENDPOINT")
                .unwrap_or_else(|_| "http://localhost:4317".to_string()),
            log_level: std::env::var("NEO_LOG_LEVEL")
                .unwrap_or_else(|_| "info".to_string()),
            health_check_enabled: std::env::var("NEO_HEALTH_CHECK_ENABLED")
                .unwrap_or_else(|_| "true".to_string())
                .parse()
                .unwrap_or(true),
            health_check_port: std::env::var("NEO_HEALTH_CHECK_PORT")
                .unwrap_or_else(|_| "8080".to_string())
                .parse()
                .unwrap_or(8080),
        }
    }
}

/// Initialize monitoring subsystems
pub fn init() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize metrics
    if MONITORING.metrics_enabled {
        metrics::init(MONITORING.metrics_port)?;
    }
    
    // Initialize tracing
    if MONITORING.tracing_enabled {
        tracing::init(&MONITORING.tracing_endpoint, &MONITORING.log_level)?;
    }
    
    // Initialize health checks
    if MONITORING.health_check_enabled {
        health::init(MONITORING.health_check_port)?;
    }
    
    Ok(())
}

/// Shutdown monitoring subsystems
pub fn shutdown() {
    metrics::shutdown();
    tracing::shutdown();
    health::shutdown();
}