MonsterOps logo MonsterOps
Docs / Automation / Scheduler

Scheduler

Overview

The Scheduler runs recurring background jobs on a time schedule (via APScheduler) — the housekeeping that keeps a RADIUS deployment tidy: stale-IP sweeps, expired-user cleanup, log retention, and scheduled reports.

Where Automation reacts to events, the Scheduler runs on the clock.

Where things are

  • Job list — the recurring jobs, their schedules, and last-run status.
  • Built-in jobs — stale IP sweep, expired-user cleanup, Log Retention, and scheduled Reports.
  • Run history — each job's runs and outcomes.

Common tasks

  • Free stuck IP leases automatically — enable/tune the stale-IP sweep so phantom IP Pool leases are reclaimed.
  • Prune old logs — the Log Retention job trims radpostauth, the audit log, notification history, and dispatch logs on the windows set in Configuration (MONSTEROPS_RETENTION_*). Set a window to 0 to keep a table forever.
  • Email a periodic report — schedule a Report (needs SMTP).

Problems you may hit

  • A job didn't run — check the run history for the last outcome; a job that errors is recorded there.
  • Logs still growing — Log Retention windows are 0 (disabled) or too long; adjust MONSTEROPS_RETENTION_* and restart.
  • Scheduled report didn't send — SMTP isn't configured; see Configuration.