Skip to content

Analytics

Olivier edited this page Apr 22, 2026 · 1 revision

πŸ“Š Visual Analytics: The Dashboard

RAM-FLOW provides a surgical diagnostic of your Python process's memory lifecycle. Whether you are debugging locally or monitoring production workers, this dashboard bridges the gap between high-level code and low-level system reality.


πŸ—οΈ 1. Executive Dashboard (Main Tab)

The entry point for a "Go/No-Go" production decision. It performs a differential audit by categorizing every allocated byte into three distinct layers. This taxonomy is crucial: optimizing a function is useless if your framework's initialization already consumes 90% of your available RAM.

πŸ“Έ Executive Dashboard and KPI


The Three Pillars of Execution

  • Bootstrap (+16.89 MB) β€” The "Engine Ignition" Cost: Represents the absolute immutable footprint of the Python interpreter (core binary, built-in types, initial sys.modules). It serves as your "Zero-Point."
  • Ecosystem Bloat (+401.78 MB) β€” The "Framework Tax": The delta between a clean start and a fully initialized environment (Registry loading, ORM introspection, Middleware). If this is high, you are suffering from Architecture Bloat.
  • Integrity (Status: BLOATED / SECURE) β€” The "System Truth": A final post-execution audit. BLOATED signals that memory is "stuck" in global variables, unclosed cursors, or C-level buffers (Oracle/Pandas).

πŸ“ˆ KPI Glossary (Executive Scorecard)

  • πŸ›‘οΈ Safety Margin (e.g., 49.0%): Available "oxygen" on the Host. Below 10%, you risk an OOM-Killer crash.
  • πŸ‘£ Process Footprint (e.g., 569.8 MB): Peak RSS usage. Use this value to set your Docker/Kubernetes RAM limits accurately (always add a 20% buffer).
  • ⚑ Efficiency Ratio (e.g., 94.1 MB/s): Allocation speed. A high speed indicates "Greedy" logic loading massive data chunks at once.
  • βš–οΈ Leak Probability (High/Medium/Low): Based on Residual Leak vs. Peak Footprint. Essential for long-running workers (Celery) to prevent slow system degradation.

🌊 2. Execution Flow: The Interactive Timeline (Second Tab)

The second tab provides a chronological view of your memory consumption. This is where you visualize the "Pulse" of your application.

πŸ“Έ View Execution Flow & Memory Timeline


The Memory Pulse & Profiling

  • The Timeline: A step-by-step visual of every tracked function. Look for "staircase" patterns to identify cumulative leaks. If it spikes and drops, you have a heavy task but a clean reclamation.
  • Net Self Impact (The Culprit Finder): RAM-FLOW's gold standard. It calculates what a function consumes locally, excluding its children. Target the top consumers here to get 80% of your performance back.

🌍 3. System Context: The Monolith Analysis (Third Tab)

The final tab helps you understand the relationship between your specific code and the host framework infrastructure.

πŸ“Έ View Host infrastructure and Badge


Contextual Insights

Memory Expansion Journey

  • Memory Expansion Journey: Ratio between Infrastructure Baseline and Peak RSS. The Expansion Factor (e.g., x1.4) tells you how much your business logic "stretched" the process footprint. Ecosystem Impact Analysis: A visual breakdown of the total footprint.
  • The Reality Check: If the Infrastructure represents 70%+ of the peak, stop refactoring your loops. Instead, focus on removing unused INSTALLED_APPS or stripping down heavy imports.