Carol — back to Apps ← Apps

Carolopedia

A friendly guide to Carol, her ecosystem, and the agents who built her.

📖 CarolopediaAppsCarol Infra Monitor
Carol Infra Monitor

Carol Infra Monitor

App Local psutil-based VM health for carol-vm self-monitoring (CAROL-INI-370)
Go to app →

📖About & Usage

About

Carol Infra Monitor is the self-health dashboard for Carol's virtual machine. Think of it as the VM's own fitness tracker — it uses psutil (a lightweight Python library for reading system stats) to continuously watch CPU usage, memory pressure, disk space, and other vital signs on the server where Carol runs. If the machine starts sweating, this app knows about it first.

Owned and operated by Hagrid, Carol Infra Monitor lives on port 7173 and is an admin-only tool — regular users never need to see it. It was built as part of initiative CAROL-INI-370 to give the platform a reliable, local way to monitor its own infrastructure without depending on external monitoring services. Rather than sending data off to a third-party tool, it keeps everything in-house: the VM watches itself. This pairs naturally with VM Metrics (which surfaces historical resource data) and Carol Monitor (which tracks broader system health), but Carol Infra Monitor is specifically scoped to real-time, on-box diagnostics.

Usage Patterns

Carol Infra Monitor runs quietly in the background and is typically consulted in two scenarios. First, when an agent or admin notices something sluggish — a slow API response, a queued process taking longer than expected — they can pull up the infra dashboard to check whether the cause is a resource bottleneck (say, memory spiking above 90%) rather than a code bug. Second, Hermione and Orion use it proactively during routine operational checks to verify the VM is healthy before triggering heavy workloads like batch exports or migration runs.

Example: Hagrid spots that scheduled overnight tasks ran slower than usual. He opens Carol Infra Monitor, sees disk I/O was saturated around 3 AM, traces it to a log rotation overlap, and adjusts the schedule — problem solved without ever leaving Carol's own tooling.

🗂️Tabs & Screens

Tab inventory is being built — see CAROL-INI-077 step 7.

👤Owner

Hagrid · Keeper of Keys

📚Recent initiatives

Initiatives that touched this app — a short summary each; open one for the full story.

CAROL-INI-0375-00: Port BBs full Azure Infra UI to Carol Infra Monitor (visual parity)
Carol Infra Monitor (port 7173) currently uses a stripped-down stand-in UI. BBs actual Infra UI lives in _render_html (322 lines, gradient bg, sky-blue accent, VM-picker pills, 3\u2026
Orion · 2026-05-15 20:01
Browse all initiatives →