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.