Files
inbuxa-server/crates/services/src/task_manager/scheduler.rs
T
jcoffey-dev 9f7035588f Monitoring: metric history, one edition of metrics, and x:Metric over the stored samples (MON-4 to MON-7, MON-9, MON-17, MON-39)
Every node writes a sample per metric on metricsCollectionInterval:
counters as the increase since its last sample, gauges always, histograms
as totals when changed. Samples are x:Metric in the registry's encoding
under the telemetry key class, ids time-ordered. x:Metric/get and /query
read them with metric and timestamp filters and full paging, hide what's
past holdMetricsFor, and the data purge deletes it. The is_enterprise
split is gone, so every gauge and histogram is collected and exported, and
queue.count is set from the queue itself. The shared metrics suite runs.
2026-09-19 08:21:45 -07:00

437 lines
17 KiB
Rust

/*
* SPDX-FileCopyrightText: 2020 Stalwart Labs LLC <[email protected]>
*
* SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-SEL
*/
use std::time::Duration;
use std::{
collections::BinaryHeap,
sync::Arc,
time::{Instant, SystemTime},
};
use common::{
BuildServer, Inner, LONG_1D_SLUMBER,
config::{mailstore::spamfilter, telemetry::OtelMetrics},
};
use registry::{
schema::{
enums::{TaskSpamFilterMaintenanceType, TaskStoreMaintenanceType, TaskType},
structs::{Task, TaskSpamFilterMaintenance, TaskStatus, TaskStoreMaintenance},
},
types::EnumImpl,
};
use store::write::{BatchBuilder, now};
use trc::{ClusterEvent, Collector, MetricType, TaskManagerEvent, TelemetryEvent};
#[derive(PartialEq, Eq)]
struct Action {
due: Instant,
event: Event,
}
#[derive(PartialEq, Eq, Debug)]
enum Event {
PurgeAccount,
PurgeDataStore,
PurgeBlobStore,
OtelMetrics,
CalculateMetrics,
TrainSpamClassifier,
RenewNodeIdLease,
// inbuxa: MON-4: metric history
StoreMetrics,
}
/// When the next metric-history tick is due (MON-4), read from the registry
/// so a change needs no reload (MON-3).
async fn metrics_collection_delay(server: &common::Server) -> Duration {
utils::cron::SimpleCron::from(
common::telemetry::metrics::store::retention(server)
.await
.metrics_collection_interval,
)
.time_to_next()
}
#[derive(Default)]
struct Queue {
heap: BinaryHeap<Action>,
}
pub fn spawn_task_scheduler(inner: Arc<Inner>) {
tokio::spawn(async move {
trc::event!(TaskManager(TaskManagerEvent::SchedulerStarted));
let start_time = SystemTime::now();
// Add all events to queue
let mut queue = Queue::default();
{
let server = inner.build_server();
// Account purge
queue.schedule(
Instant::now() + server.core.email.account_purge_frequency.time_to_next(),
Event::PurgeAccount,
);
queue.schedule(
Instant::now() + server.core.email.data_purge_frequency.time_to_next(),
Event::PurgeDataStore,
);
queue.schedule(
Instant::now() + server.core.email.blob_purge_frequency.time_to_next(),
Event::PurgeBlobStore,
);
// Node ID lease renewal
if server.core.storage.coordinator.is_enabled() {
queue.schedule(
Instant::now() + server.registry().refresh_node_id_interval(),
Event::RenewNodeIdLease,
);
}
// Spam classifier training
if let Some(train_frequency) = server
.core
.spam
.classifier
.as_ref()
.and_then(|c| c.train_frequency)
{
let next_train = match server.inner.data.spam_classifier.load().as_ref() {
spamfilter::SpamClassifier::FhClassifier {
last_trained_at, ..
}
| spamfilter::SpamClassifier::CcfhClassifier {
last_trained_at, ..
} => now().saturating_sub(*last_trained_at).min(train_frequency),
spamfilter::SpamClassifier::Disabled => train_frequency,
};
queue.schedule(
Instant::now() + Duration::from_secs(next_train),
Event::TrainSpamClassifier,
);
}
// OTEL Push Metrics
if let Some(otel) = &server.core.metrics.otel {
OtelMetrics::enable_errors();
queue.schedule(Instant::now() + otel.interval, Event::OtelMetrics);
}
// Calculate expensive metrics
queue.schedule(Instant::now(), Event::CalculateMetrics);
// inbuxa: MON-4: metric history on its own schedule
queue.schedule(
Instant::now() + metrics_collection_delay(&server).await,
Event::StoreMetrics,
);
}
let mut next_metric_update = Instant::now();
loop {
tokio::time::sleep(queue.wake_up_time()).await;
let server = inner.build_server();
let roles = &server.core.network.roles;
let mut batch = (roles.task_scheduler).then(BatchBuilder::new);
while let Some(event) = queue.pop() {
match event.event {
Event::PurgeAccount => {
queue.schedule(
Instant::now()
+ server.core.email.account_purge_frequency.time_to_next(),
Event::PurgeAccount,
);
if let Some(batch) = batch.as_mut() {
trc::event!(
TaskManager(TaskManagerEvent::TaskQueued),
Type = TaskStoreMaintenanceType::PurgeAccounts.as_str()
);
batch.schedule_task(Task::StoreMaintenance(TaskStoreMaintenance {
maintenance_type: TaskStoreMaintenanceType::PurgeAccounts,
status: TaskStatus::now(),
shard_index: None,
}));
}
}
Event::PurgeDataStore => {
queue.schedule(
Instant::now() + server.core.email.data_purge_frequency.time_to_next(),
Event::PurgeDataStore,
);
if let Some(batch) = batch.as_mut() {
trc::event!(
TaskManager(TaskManagerEvent::TaskQueued),
Type = TaskStoreMaintenanceType::PurgeData.as_str()
);
batch.schedule_task(Task::StoreMaintenance(TaskStoreMaintenance {
maintenance_type: TaskStoreMaintenanceType::PurgeData,
status: TaskStatus::now(),
shard_index: None,
}));
}
}
Event::PurgeBlobStore => {
queue.schedule(
Instant::now() + server.core.email.blob_purge_frequency.time_to_next(),
Event::PurgeBlobStore,
);
if let Some(batch) = batch.as_mut() {
trc::event!(
TaskManager(TaskManagerEvent::TaskQueued),
Type = TaskStoreMaintenanceType::PurgeBlob.as_str()
);
batch.schedule_task(Task::StoreMaintenance(TaskStoreMaintenance {
maintenance_type: TaskStoreMaintenanceType::PurgeBlob,
status: TaskStatus::now(),
shard_index: None,
}));
}
}
Event::RenewNodeIdLease => {
queue.schedule(
Instant::now() + server.registry().refresh_node_id_interval(),
Event::RenewNodeIdLease,
);
trc::event!(
Cluster(ClusterEvent::NodeIdRenewed),
Id = server.registry().node_id()
);
let server = server.clone();
tokio::spawn(async move {
if let Err(err) = server.registry().refresh_node_id_lease().await {
trc::error!(err.details("Failed to renew node ID lease"));
}
});
}
Event::OtelMetrics => {
if let Some(otel) = &server.core.metrics.otel {
queue.schedule(Instant::now() + otel.interval, Event::OtelMetrics);
if roles.metrics_push {
let otel = otel.clone();
tokio::spawn(async move {
let elapsed = Instant::now();
otel.push_metrics(start_time).await;
trc::event!(
Telemetry(TelemetryEvent::MetricsPushed),
Elapsed = elapsed.elapsed()
);
});
}
}
}
Event::CalculateMetrics => {
// Calculate expensive metrics every 5 minutes
queue.schedule(
Instant::now() + Duration::from_secs(5 * 60),
Event::CalculateMetrics,
);
let update_other_metrics = if Instant::now() >= next_metric_update {
next_metric_update = Instant::now() + Duration::from_secs(86400);
true
} else {
false
};
let server = server.clone();
tokio::spawn(async move {
let elapsed = Instant::now();
if server.core.network.roles.metrics_calculate {
// inbuxa: MON-7: the queue gauge from the queue itself,
// so it's right after a restart
match server.total_queued_messages().await {
Ok(total) => {
Collector::update_gauge(MetricType::QueueCount, total);
}
Err(err) => {
trc::error!(err.details("Failed to count queued messages"));
}
}
if update_other_metrics {
match server.total_accounts().await {
Ok(total) => {
Collector::update_gauge(
MetricType::UserCount,
total as u64,
);
}
Err(err) => {
trc::error!(
err.details("Failed to obtain account count")
);
}
}
match server.total_domains().await {
Ok(total) => {
Collector::update_gauge(
MetricType::DomainCount,
total as u64,
);
}
Err(err) => {
trc::error!(
err.details("Failed to obtain domain count")
);
}
}
}
}
match tokio::task::spawn_blocking(memory_stats::memory_stats).await {
Ok(Some(stats)) => {
Collector::update_gauge(
MetricType::ServerMemory,
stats.physical_mem as u64,
);
}
Ok(None) => {}
Err(err) => {
trc::error!(
trc::EventType::Server(trc::ServerEvent::ThreadError,)
.reason(err)
.caused_by(trc::location!())
.details("Join Error")
);
}
}
trc::event!(
Telemetry(TelemetryEvent::MetricsCollected),
Elapsed = elapsed.elapsed()
);
});
}
// inbuxa: MON-4: every node writes its own samples
Event::StoreMetrics => {
queue.schedule(
Instant::now() + metrics_collection_delay(&server).await,
Event::StoreMetrics,
);
let server = server.clone();
tokio::spawn(async move {
server.store_metrics().await;
});
}
Event::TrainSpamClassifier => {
if let Some(train_frequency) = server
.core
.spam
.classifier
.as_ref()
.and_then(|c| c.train_frequency)
{
// Schedule next training
queue.schedule(
Instant::now() + Duration::from_secs(train_frequency),
Event::TrainSpamClassifier,
);
if let Some(batch) = batch.as_mut() {
trc::event!(
TaskManager(TaskManagerEvent::TaskQueued),
Type = TaskType::SpamFilterMaintenance.as_str()
);
batch.schedule_task(Task::SpamFilterMaintenance(
TaskSpamFilterMaintenance {
maintenance_type: TaskSpamFilterMaintenanceType::Train,
status: TaskStatus::now(),
},
));
}
}
}
}
}
if let Some(mut batch) = batch
&& !batch.is_empty()
&& let Err(err) = server.store().write(batch.build_all()).await
{
trc::error!(err.details("Failed to write scheduled tasks"));
}
}
});
}
impl Queue {
pub fn schedule(&mut self, due: Instant, event: Event) {
trc::event!(
TaskManager(TaskManagerEvent::TaskScheduled),
Due = trc::Value::Timestamp(
now() + due.saturating_duration_since(Instant::now()).as_secs()
),
Id = event.name()
);
self.heap.push(Action { due, event });
}
pub fn wake_up_time(&self) -> Duration {
self.heap
.peek()
.map(|e| e.due.saturating_duration_since(Instant::now()))
.unwrap_or(LONG_1D_SLUMBER)
}
pub fn pop(&mut self) -> Option<Action> {
if self.heap.peek()?.due <= Instant::now() {
self.heap.pop()
} else {
None
}
}
}
impl Ord for Action {
fn cmp(&self, other: &Self) -> std::cmp::Ordering {
self.due.cmp(&other.due).reverse()
}
}
impl PartialOrd for Action {
fn partial_cmp(&self, other: &Self) -> Option<std::cmp::Ordering> {
Some(self.cmp(other))
}
}
impl Event {
fn name(&self) -> &'static str {
match self {
Event::PurgeAccount => "purgeAccount",
Event::PurgeDataStore => "purgeDataStore",
Event::PurgeBlobStore => "purgeBlobStore",
Event::OtelMetrics => "otelMetrics",
Event::CalculateMetrics => "calculateMetrics",
Event::TrainSpamClassifier => "trainSpamClassifier",
Event::RenewNodeIdLease => "renewNodeIdLease",
Event::StoreMetrics => "storeMetrics",
}
}
}