{"wiki":{"id":117,"slug":"vm-metrics","entity_type":"app","entity_id":"vm-metrics","title":"VM Metrics","prose_md":"## About\n\n**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.\n\n## Usage Patterns\n\nVM 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?”","namesake_json":"{}","profile_pic_path":"","source_hash":"6073cd1a05a4bfc04b859275d28b8dd07ccf02276c23bfc25cae56ae9de1129d","status":"active","last_generated_at":"2026-07-01 03:26:57","created_at":"2026-07-01 03:26:57","updated_at":"2026-07-01 03:26:57"},"facts":{"id":"vm-metrics","name":"VM Metrics","port":7146,"url":"https://carol.denken-labs.com/vm-metrics/","description":"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.","owner":"agt_014","dir_name":"vm_metrics","card_group":"","is_public":0,"access_level":"none","log_name":"vm_metrics","gen_nginx":1,"user_admins":"[]"}}