pub struct EmbeddedTelemetryConfig {
pub store: DurableTelemetryConfig,
pub local_limits: DurableTelemetryLimits,
pub object_tier: ObjectTierConfig,
pub max_ram_bytes: Option<u64>,
pub max_ssd_bytes: Option<u64>,
pub shutdown_flush_timeout: Duration,
}Expand description
Lifecycle configuration for a one-process embedded ShardTelemetry runtime.
Fields§
§store: DurableTelemetryConfigDurable local WAL, index, and object-tier configuration.
local_limits: DurableTelemetryLimitsBounded hot-memory, journal, and SSD-cache limits.
object_tier: ObjectTierConfigImmutable group sizing used for local deletion or S3 publication.
max_ram_bytes: Option<u64>Optional bound for engine-controlled resident telemetry state.
Transient request decoding and query result allocations are outside this storage-state budget.
max_ssd_bytes: Option<u64>Optional bound for local immutable payload and SSD-cache bytes.
Filesystem metadata and one in-flight WAL/spool group may temporarily exceed this steady-state data budget.
shutdown_flush_timeout: DurationUpper bound applied when draining the embedded store during shutdown.
Implementations§
Source§impl EmbeddedTelemetryConfig
impl EmbeddedTelemetryConfig
Sourcepub fn new(store: DurableTelemetryConfig) -> Self
pub fn new(store: DurableTelemetryConfig) -> Self
Creates an embedded runtime configuration around one durable store.
Sourcepub fn bounded_local(
data_directory: impl Into<PathBuf>,
retention: Duration,
) -> Self
pub fn bounded_local( data_directory: impl Into<PathBuf>, retention: Duration, ) -> Self
Creates a one-shard, SSD-backed embedded configuration with time-based retention.
The local immutable object directory lives below data_directory, so
completed blocks can replace raw WAL packs while remaining queryable.
Call EmbeddedTelemetryRuntime::compact_retention periodically to
reclaim complete groups older than retention.
Sourcepub fn bounded(
data_directory: impl Into<PathBuf>,
retention: Duration,
eviction: EmbeddedEvictionPolicy,
) -> Self
pub fn bounded( data_directory: impl Into<PathBuf>, retention: Duration, eviction: EmbeddedEvictionPolicy, ) -> Self
Creates a one-shard embedded store with a recent local window and an explicit eviction destination.
Sourcepub fn with_max_ram_bytes(self, max_bytes: u64) -> Self
pub fn with_max_ram_bytes(self, max_bytes: u64) -> Self
Sets a total bound for storage-engine telemetry state in RAM.
Two thirds is divided across log, trace, and metric heads on every physical stripe, one twelfth is reserved for compression dictionaries, and the remainder is divided across verified payload and control caches.
Sourcepub fn with_max_ssd_bytes(self, max_bytes: u64) -> Self
pub fn with_max_ssd_bytes(self, max_bytes: u64) -> Self
Sets the steady-state local data budget and derives cache/group limits.
Local-delete mode reserves three quarters for immutable payloads, one eighth for caches, one sixteenth for lifetime rollups, and the remainder for catalog/filesystem overhead. S3 mode assigns the remaining managed budget to local caches because authoritative immutable objects are remote.
Sourcepub fn with_storage_budgets(
self,
max_ram_bytes: u64,
max_ssd_bytes: u64,
) -> Self
pub fn with_storage_budgets( self, max_ram_bytes: u64, max_ssd_bytes: u64, ) -> Self
Sets both embedded storage-state budgets.
Sourcepub fn with_local_limits(self, limits: DurableTelemetryLimits) -> Self
pub fn with_local_limits(self, limits: DurableTelemetryLimits) -> Self
Replaces the complete bounded local-storage policy.
Sourcepub fn with_head_memory_bytes_per_stripe(
self,
logs: usize,
traces: usize,
metrics: usize,
) -> Self
pub fn with_head_memory_bytes_per_stripe( self, logs: usize, traces: usize, metrics: usize, ) -> Self
Sets the hot in-memory head limit for logs, traces, and metrics on each physical stripe.
Sourcepub fn with_ssd_caches(
self,
control_cache: SsdCacheConfig,
payload_cache: SsdCacheConfig,
) -> Self
pub fn with_ssd_caches( self, control_cache: SsdCacheConfig, payload_cache: SsdCacheConfig, ) -> Self
Sets independent SSD-cache policies for metadata/index objects and compressed payload ranges.
Sourcepub const fn with_shutdown_flush_timeout(self, timeout: Duration) -> Self
pub const fn with_shutdown_flush_timeout(self, timeout: Duration) -> Self
Sets the bounded shutdown flush timeout.
Trait Implementations§
Source§impl Clone for EmbeddedTelemetryConfig
impl Clone for EmbeddedTelemetryConfig
Auto Trait Implementations§
impl Freeze for EmbeddedTelemetryConfig
impl RefUnwindSafe for EmbeddedTelemetryConfig
impl Send for EmbeddedTelemetryConfig
impl Sync for EmbeddedTelemetryConfig
impl Unpin for EmbeddedTelemetryConfig
impl UnsafeUnpin for EmbeddedTelemetryConfig
impl UnwindSafe for EmbeddedTelemetryConfig
Blanket Implementations§
impl<T> Allocation for T
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> FutureExt for T
impl<T> FutureExt for T
Source§fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
Source§fn with_current_context(self) -> WithContext<Self> ⓘ
fn with_current_context(self) -> WithContext<Self> ⓘ
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T in a tonic::Request