Carol — back to Apps ← Apps

Carolopedia

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

📖 CarolopediaAppsVM Metrics
VM Metrics

VM Metrics

App Live psutil-based metrics for carol-vm. Consumed by BB Azure Infra app for cross-VM monitoring. Returns same shape as bb-vm /api/current.
Go to app →

📖About & Usage

About

VM Metrics is Carol’s live health-checker for the virtual machine (VM) that hosts Carol herself — think of it as a stethoscope for the server computer. This app grabs real-time performance data (like CPU usage, memory, and running processes) straight from the VM’s operating system using a Python library called “psutil.” Because the data it collects follows the same format as another tool called bb-vm, it plugs easily into the BB Azure Infra app, which can then watch multiple virtual machines at once across the Azure cloud. VM Metrics exists so Carol’s operations team — particularly Elrond (Head of Engineering) and Hermione (Process Monitor) — can quickly understand if Carol’s host computer is struggling, behaving oddly, or running smoothly. It’s a behind-the-scenes utility that helps keep the whole Carol ecosystem stable.

Usage Patterns

VM Metrics fires automatically whenever the BB Azure Infra app needs to check on Carol’s VM. For a concrete example: imagine Elrond notices that Carol is responding sluggishly. Instead of logging into the server directly, they open the BB Azure Infra dashboard, which quietly asks VM Metrics for the latest numbers. Within seconds, the dashboard shows that Carol’s VM is using 90% of its memory — a clear red flag. With that clue, Elrond knows to restart a memory-hungry background process. VM Metrics also works for scheduled “health rounds,” where the system polls it every few minutes to build a long-term picture of performance trends. Because it’s built and running (not under construction), it’s always on standby, ready to answer one simple question: “How is Carol’s computer doing right now?”

🗂️Tabs & Screens

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

👤Owner

Guardian · Director of WhatsApp Reliability

📚Recent initiatives

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

No initiatives recorded for this app yet.