Ashfaaq Farzaan

OOM-TUI 📟

📟 Project Overview

OOM-TUI is an evidence-first terminal user interface for investigating Linux Out-of-Memory (OOM) killer incidents. It reconstructs scattered, raw kernel log lines into structured, readable incident reports, helping systems engineers and SREs diagnose memory crashes fast.

🚀 Key Features

  • 🔎 Incident Reconstruction: Parses raw Linux kernel OOM dumps and correlates log context to build a clear incident timeline.
  • 💀 Victim & Memory Analytics: Displays the killed process, memory usage at termination, cgroup scope, and top memory-consuming processes.
  • 🏷️ Cgroup & Container Aware: Distinguishes host-wide memory exhaustion from cgroup-limit kills and decodes container and Kubernetes cgroup paths.
  • 📊 Interactive TUI & Exporting: Built with Ratatui to offer an interactive multi-view terminal interface with options to export reports to JSON/JSONL.

🛠️ Technical Highlights

  • Language: Rust (1.75+)
  • UI Framework: Ratatui / Crossterm TUI
  • Target OS: Linux (kernel log parser for dmesg / journalctl / syslog)

🔗 Explore the Repository