Module PerformanceDashboard 

Performance Dashboard

Advanced monitoring + distributed-tracing module. Records PerformanceMetric::Struct samples into a ring buffer, tracks TraceSpan::Struct lifecycles, raises PerformanceAlert::Struct when configured thresholds are exceeded, and rolls everything into a DashboardStatistics::Struct. The Dashboard::Struct aggregator + 25-method impl lives in one sibling because the impl is tightly coupled with the DTOs (see Convention’s “tightly-coupled cluster” exception).

Modules

AlertSeverity

Severity tag for a PerformanceAlert::Struct.

Dashboard

PerformanceDashboard aggregator + 25-method impl. Holds the metric ring-buffer, trace store, alert ring, statistics cell, and the is_running lifecycle flag. Method bodies tightly couple with the sibling DTOs so the impl stays a single file (per the “tightly-coupled cluster” exception).

DashboardConfig

Tunable knobs for the performance dashboard - update cadence, retention window, alert threshold, sampling rate, and the trace ring-buffer cap.

DashboardStatistics

Aggregated dashboard counters - cumulative metric / trace / alert counts plus the rolled-up averages and last-update tick.

LogLevel

Severity tag for TraceLog::Struct entries.

MetricType

Discriminator for PerformanceMetric::Struct - tags each sample with the underlying counter so the dashboard can group them.

PerformanceAlert

Threshold-violation alert raised by the dashboard - what tripped, current vs threshold, severity, human-readable message.

PerformanceMetric

One sample point: typed metric, value, timestamp, optional channel, free-form tag bag.

TraceLog

Single in-span structured log: timestamp, message, level, free-form fields. Carried inside TraceSpan::Struct::logs.

TraceSpan

Distributed trace span: trace + span ids, parent linkage, operation name, start / end / duration, tag bag, embedded TraceLog::Struct entries.