Struct mz_storage::statistics::AggregatedStatistics
source · pub struct AggregatedStatistics {
worker_id: usize,
worker_count: usize,
local_source_statistics: BTreeMap<GlobalId, (usize, SourceStatistics)>,
local_sink_statistics: BTreeMap<GlobalId, (usize, SinkStatistics)>,
global_source_statistics: BTreeMap<GlobalId, (usize, Vec<Option<SourceStatisticsUpdate>>)>,
global_sink_statistics: BTreeMap<GlobalId, (usize, Vec<Option<SinkStatisticsUpdate>>)>,
}
Expand description
A structure that keeps track of local statistics, as well as aggregating statistics into a single worker (currently worker 0).
This is because we ONLY want to emit statistics for gauge-style-statistics when
ALL workers have caught up to the currently running instance of a source/sink and have
reported an accurate gauge. This prevents issues like 1 worker reporting
snapshot_committed=true
before the others workers have caught up to report that they haven’t
finished snapshotting.
The API flow is:
- Initialize sources/sinks with
initialize_source
orinitialize_sink
. This advances the local epoch. - Advance the global epoch with
advance_global_epoch
. This should always be called strictly before reinitializing objects. - Emit a snapshot of local data with
emit_local
, which can be broadcasted to other workers. - Ingest data from other workers with
ingest
. - Emit a
snapshot
of global data (i.e. skipping objects that don’t have all workers caught up) withsnapshot
.
All functions can and should be called from ALL workers.
Note that we hand-roll a statistics epoch here, but in the future, when the storage controller has top-level support for dataflow epochs, this logic can be entirely moved there.
Fields§
§worker_id: usize
§worker_count: usize
§local_source_statistics: BTreeMap<GlobalId, (usize, SourceStatistics)>
§local_sink_statistics: BTreeMap<GlobalId, (usize, SinkStatistics)>
§global_source_statistics: BTreeMap<GlobalId, (usize, Vec<Option<SourceStatisticsUpdate>>)>
§global_sink_statistics: BTreeMap<GlobalId, (usize, Vec<Option<SinkStatisticsUpdate>>)>
Implementations§
source§impl AggregatedStatistics
impl AggregatedStatistics
sourcepub fn new(worker_id: usize, worker_count: usize) -> Self
pub fn new(worker_id: usize, worker_count: usize) -> Self
Initialize a new AggregatedStatistics
.
sourcepub fn get_source(&self, id: &GlobalId) -> Option<&SourceStatistics>
pub fn get_source(&self, id: &GlobalId) -> Option<&SourceStatistics>
Get a SourceStatistics
for an id, if it exists.
sourcepub fn get_sink(&self, id: &GlobalId) -> Option<&SinkStatistics>
pub fn get_sink(&self, id: &GlobalId) -> Option<&SinkStatistics>
Get a SinkStatistics
for an id, if it exists.
sourcepub fn deinitialize(&mut self, id: GlobalId)
pub fn deinitialize(&mut self, id: GlobalId)
Deinitialize an object. Other methods other than initialize_source
and initialize_sink
will never overwrite this.
sourcepub fn advance_global_epoch(&mut self, id: GlobalId)
pub fn advance_global_epoch(&mut self, id: GlobalId)
Advance the global epoch for statistics. Local statistics before this epoch will be ignored.
sourcepub fn initialize_source<F: FnOnce() -> SourceStatistics>(
&mut self,
id: GlobalId,
stats: F,
)
pub fn initialize_source<F: FnOnce() -> SourceStatistics>( &mut self, id: GlobalId, stats: F, )
Re-initialize a source. If it already exists, then its local epoch is advanced.
sourcepub fn initialize_sink<F: FnOnce() -> SinkStatistics>(
&mut self,
id: GlobalId,
stats: F,
)
pub fn initialize_sink<F: FnOnce() -> SinkStatistics>( &mut self, id: GlobalId, stats: F, )
Re-initialize a sink. If it already exists, then its local epoch is advanced.
sourcepub fn ingest(
&mut self,
source_statistics: Vec<(usize, SourceStatisticsRecord)>,
sink_statistics: Vec<(usize, SinkStatisticsRecord)>,
)
pub fn ingest( &mut self, source_statistics: Vec<(usize, SourceStatisticsRecord)>, sink_statistics: Vec<(usize, SinkStatisticsRecord)>, )
Ingest data from other workers.
fn _emit_local( &mut self, ) -> (Vec<(usize, SourceStatisticsRecord)>, Vec<(usize, SinkStatisticsRecord)>)
sourcepub fn emit_local(
&mut self,
) -> (Vec<(usize, SourceStatisticsRecord)>, Vec<(usize, SinkStatisticsRecord)>)
pub fn emit_local( &mut self, ) -> (Vec<(usize, SourceStatisticsRecord)>, Vec<(usize, SinkStatisticsRecord)>)
Emit a snapshot of this workers local data.
sourcepub fn snapshot(
&mut self,
) -> (Vec<SourceStatisticsUpdate>, Vec<SinkStatisticsUpdate>)
pub fn snapshot( &mut self, ) -> (Vec<SourceStatisticsUpdate>, Vec<SinkStatisticsUpdate>)
Emit a global snapshot of data. This does not include objects whose workers have not initialized gauges for the current epoch.
Auto Trait Implementations§
impl Freeze for AggregatedStatistics
impl !RefUnwindSafe for AggregatedStatistics
impl !Send for AggregatedStatistics
impl !Sync for AggregatedStatistics
impl Unpin for AggregatedStatistics
impl !UnwindSafe for AggregatedStatistics
Blanket Implementations§
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
source§impl<T> FmtForward for T
impl<T> FmtForward for T
source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.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> 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
source§impl<T, U> OverrideFrom<Option<&T>> for Uwhere
U: OverrideFrom<T>,
impl<T, U> OverrideFrom<Option<&T>> for Uwhere
U: OverrideFrom<T>,
source§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moresource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moresource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.source§impl<T> Pointable for T
impl<T> Pointable for T
source§impl<P, R> ProtoType<R> for Pwhere
R: RustType<P>,
impl<P, R> ProtoType<R> for Pwhere
R: RustType<P>,
source§fn into_rust(self) -> Result<R, TryFromProtoError>
fn into_rust(self) -> Result<R, TryFromProtoError>
RustType::from_proto
.source§fn from_rust(rust: &R) -> P
fn from_rust(rust: &R) -> P
RustType::into_proto
.source§impl<'a, S, T> Semigroup<&'a S> for Twhere
T: Semigroup<S>,
impl<'a, S, T> Semigroup<&'a S> for Twhere
T: Semigroup<S>,
source§fn plus_equals(&mut self, rhs: &&'a S)
fn plus_equals(&mut self, rhs: &&'a S)
std::ops::AddAssign
, for types that do not implement AddAssign
.source§impl<T> Tap for T
impl<T> Tap for T
source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read moresource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read moresource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read moresource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read moresource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read moresource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read moresource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.