ugnos 0.5.0

A high-performance, concurrent time-series database core written in Rust, designed for efficient IoT data ingestion, real-time analytics, and monitoring.
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

#![doc = include_str!("../README.md")]
// Declare modules
pub mod buffer;
mod cardinality_store;
pub mod core;
pub mod encoding;
pub mod error;
pub mod index;
pub mod persistence;
pub mod query;
/// Stable PromQL-like query surface (label matchers =, !=, =~, !~) for Grafana compatibility.
pub mod query_surface;
pub mod segments;
pub mod storage;
pub mod telemetry;
pub mod types;
pub mod utils;

/// gRPC (Tonic) API for ingest, query, and administration.
pub mod grpc;

/// HTTP ops endpoints (liveness/readiness) for hyper.
pub mod http_ops;

/// Prometheus Remote Write ingest: decode Snappy-compressed WriteRequest and map to DbCore inserts.
pub mod remote_write;

/// Prometheus HTTP API v1 (query, query_range, labels, label values, series) for Grafana compatibility.
pub mod prometheus_api;

/// Generated Prometheus prompb types (WriteRequest, TimeSeries, Sample, Label).
pub mod prometheus {
    #![allow(clippy::all)]
    include!(concat!(env!("OUT_DIR"), "/prometheus.rs"));
}

/// Configuration options for the database core.
pub use crate::core::DbConfig;
/// Main entry point for interacting with the time-series database core.
pub use crate::core::DbCore;
/// Error type for database operations.
pub use crate::error::DbError;
/// Snapshot manager for point-in-time backups and fast recovery.
pub use crate::persistence::Snapshotter;
/// Write-Ahead Log for durability and recovery.
pub use crate::persistence::WriteAheadLog;
/// Structured event hook for observability.
pub use crate::telemetry::{DbEvent, DbEventListener};
/// Represents a single time-series data point.
pub use crate::types::DataPoint;
/// Type alias for a set of tags (key-value pairs) associated with a data point.
pub use crate::types::TagSet;
/// Type alias for a timestamp (nanoseconds since epoch).
pub use crate::types::Timestamp;
/// Type alias for a value in a time series (f64).
pub use crate::types::Value;

// Default flush interval if not specified
use std::time::Duration;
/// The default interval between automatic buffer flushes (1 second).
pub const DEFAULT_FLUSH_INTERVAL: Duration = Duration::from_secs(1);