MonsterOps logo MonsterOps
Docs / Monitoring / Health

Health

Overview

Health is the operations panel: FreeRADIUS service status and controls, database health, and a live log viewer. It's also home to the optional Server Console. The Dashboard — the first page after login — surfaces the same signals as at-a-glance widgets (active sessions, auth stats, bandwidth, NAS status, recent auth).

Where things are

  • FreeRADIUS controls — service status with reload / restart / start / stop actions.
  • Database health — connection/latency indicators (the bottom status strip shows DB latency everywhere).
  • Logs — the live log viewer (app log and FreeRADIUS log), streamed over SSE.
  • Server Console — an optional slide-in panel (see below).

Dashboard widgets

The Dashboard's widgets are individually show/hide-able and saved per user account: active sessions, auth stats, bandwidth, NAS Status (up/down and active/idle), and recent auth attempts.

Server Console

The Server Console is off by default. Enable it with MONSTEROPS_CONSOLE_ENABLED=true — it's opt-in because its command palette acts on the host straight from the browser. Once enabled, superadmins see a terminal icon in the bottom-left (or press backtick ` anywhere). It has:

  • App Log — live-tails the MonsterOps process log.
  • RADIUS Log — live-tails the FreeRADIUS log files.
  • Commands — reload FreeRADIUS config, restart FreeRADIUS, run pending migrations. A Recent runs list records each command (result + timestamp) and persists across page reloads.

The console runs privileged actions from the browser

Restarting FreeRADIUS and running migrations are real operations on the host. That's why the console is opt-in, superadmin-only, and its command endpoints refuse to run when disabled (enforced server-side, before any command executes).

Common tasks

  • Reload FreeRADIUS after config changes — Health → reload (or the console Commands tab).
  • Watch a live issue — open the log viewer or the console App/RADIUS log tabs.
  • Customise the Dashboard — show/hide widgets; the layout is saved to your account.

Problems you may hit

  • No terminal icon / console won't open — it's disabled (default) or you're not a superadmin; set MONSTEROPS_CONSOLE_ENABLED=true and log in as superadmin.
  • FreeRADIUS controls do nothing — the service manager isn't reachable (permissions), or FreeRADIUS runs on a different host than MonsterOps.
  • DB latency high in the status strip — investigate PostgreSQL; the PostgreSQL log helps.
  • Logs — the log sources in detail
  • Configuration — MONSTEROPS_CONSOLE_ENABLED
  • Roles — console is superadmin-only