stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
822a92faeebbceea6fa005b7eddb7572a8b29b41
git.stella-ops.org/docs/features/checked/doctor/doctor-scheduled-runs-with-alerting-and-trend-analysis.md
master 5bca406787 save checkpoint: save features
2026-02-12 10:27:23 +02:00

2.5 KiB
Raw Blame History

Doctor Scheduled Runs with Alerting and Trend Analysis

Module

Doctor

Status

VERIFIED

Description

Cron-based scheduled execution of Doctor health checks with configurable schedules, trend data storage for historical analysis, anomaly detection for health metric degradation, and alerting service integration for notifications on health regressions.

Implementation Details

  • Schedule worker: src/Doctor/StellaOps.Doctor.Scheduler/DoctorScheduleWorker.cs -- background worker for cron-based execution
  • Schedule executor: src/Doctor/StellaOps.Doctor.Scheduler/Services/ScheduleExecutor.cs -- executes scheduled doctor runs
  • Schedule models: src/Doctor/StellaOps.Doctor.Scheduler/Models/DoctorSchedule.cs -- schedule configuration
  • Execution tracking: src/Doctor/StellaOps.Doctor.Scheduler/Models/ScheduleExecution.cs -- execution records
  • Trend data: src/Doctor/StellaOps.Doctor.Scheduler/Models/TrendDataPoint.cs -- trend analysis data model
  • Alert service: src/Doctor/StellaOps.Doctor.Scheduler/Services/IAlertService.cs -- alerting interface for health regressions
  • Schedule repository: src/Doctor/StellaOps.Doctor.Scheduler/Services/IScheduleRepository.cs
  • Trend repository: src/Doctor/StellaOps.Doctor.Scheduler/Services/ITrendRepository.cs -- trend data persistence
  • Scheduler API endpoints: src/Doctor/StellaOps.Doctor.Scheduler/Endpoints/SchedulerEndpoints.cs -- schedule/trend HTTP surface under /api/v1/doctor/scheduler/*
  • In-memory scheduler stores: src/Doctor/StellaOps.Doctor.Scheduler/Services/InMemoryScheduleRepository.cs, src/Doctor/StellaOps.Doctor.Scheduler/Services/InMemoryTrendRepository.cs
  • Options: src/Doctor/StellaOps.Doctor.Scheduler/Options/DoctorSchedulerOptions.cs -- scheduler configuration
  • Source: SPRINT_20260118_020_Doctor_scheduled_runs_trending.md

E2E Test Plan

  • Verify scheduled doctor runs execute at configured intervals
  • Test trend data accumulation over multiple runs
  • Verify alert service triggers on health degradation (error-path alerting observed on downstream API unavailability)
  • Test schedule CRUD operations via repository and runtime API endpoints

Verification

Run: run-002 (2026-02-11)

  • Tier 1 build/test passed for StellaOps.Doctor.Scheduler and new repository unit coverage (4/4).
  • Tier 2 API probes passed for scheduler CRUD, manual execute, and trend endpoints (14 successful HTTP transactions; no failed probes).
  • Terminal outcome for this dossier: done.