Skip to main content

Crate oxigdal_observability

Crate oxigdal_observability 

Source
Expand description

OpenTelemetry-based observability, monitoring, and alerting for OxiGDAL.

This crate provides comprehensive observability capabilities for the OxiGDAL geospatial data processing library, including:

  • OpenTelemetry Integration: Distributed tracing, metrics, and logs
  • Custom Geospatial Metrics: Raster, vector, I/O, cache, query, GPU, and cluster metrics
  • Distributed Tracing: W3C Trace Context propagation across services
  • Real-time Dashboards: Grafana and Prometheus dashboard templates
  • Anomaly Detection: Statistical and ML-based anomaly detection
  • SLO/SLA Monitoring: Service level objectives and error budget tracking
  • Alert Management: Rule-based alerting with routing and escalation
  • Metric Exporters: Prometheus, StatsD, InfluxDB, CloudWatch support

§Example

use oxigdal_observability::telemetry::{TelemetryConfig, init_with_config};

// Initialize telemetry
let config = TelemetryConfig::new("oxigdal")
    .with_service_version("1.0.0")
    .with_jaeger_endpoint("localhost:6831")
    .with_sampling_rate(0.1);

let provider = init_with_config(config).await.expect("Failed to initialize telemetry");

Re-exports§

pub use error::ObservabilityError;
pub use error::Result;
pub use health::HealthCheckManager;
pub use health::HealthStatus;
pub use profiling::ProfileStats;
pub use profiling::Profiler;
pub use telemetry::TelemetryConfig;
pub use telemetry::TelemetryProvider;

Modules§

alerting
Alert management and routing.
anomaly
Anomaly detection engine for metrics.
config
Configuration management for observability system.
correlation
Metric correlation and causation analysis.
dashboard
Real-time performance dashboards with metric aggregation and visualization.
dashboards
Real-time performance dashboards (Grafana templates).
error
Error types for observability operations.
exporters
Metric exporters for various backends.
health
Health check and status monitoring.
integration
Integration with external monitoring systems.
metrics
Custom geospatial metrics for OxiGDAL operations.
profiling
Performance profiling and monitoring.
reporting
Automated reporting and notification systems.
slo
SLO/SLA monitoring and error budget tracking.
telemetry
OpenTelemetry integration and telemetry setup.
tracing
Distributed tracing infrastructure.

Macros§

log_with_context
Structured log macros helpers.