oomkill(8)

📦 version 0.36.1, in centos-stream 10, centos-stream 9, fedora 43, fedora 44

💀 oomkill(8) 💀

🎀 NAME 🎀

okay so the manual name is oomkill, and it's literally the thing that does Trace oom_kill_process(). Uses Linux eBPF/bcc. ✨ it's giving tracing vibes, periodt 💅

✨ SYNOPSIS ✨

oomkill

just type oomkill. that's the whole outfit 🫶

🌸 DESCRIPTION 🌸

okay bestie, this one traces the kernel out-of-memory killer 🔥 and prints basic details, including the system load averages at the moment of the OOM kill. 😭 this gives you more context on what the system was up to right then. was it getting busier, or was it steady? you can tell from the load averages 👀

this tool is also lowkey great to customize for investigations. for example, you can add other task_struct details at the time of OOM 🧚

⚠️ only the root user can use this tool, because it uses BPF. not me being bossy, that's just how it is 🙈

🦋 REQUIREMENTS 🦋

you'll need CONFIG_BPF and bcc. no cap, that's the whole list 💖

🍓 EXAMPLES 🍓

Trace OOM kill events:

# oomkill

🌈 FIELDS 🌈

💜 Triggered by ...

this is the process ID and process name of the task that was running when another task got OOM killed. ✨ the main character who was still vibing when the chaos happened 💀

🔥 OOM kill of ...

this is the process ID and name of the target process that got OOM killed. 😭 rip to that one

📊 loadavg

this is the contents of /proc/loadavg 🫧 the first three numbers are the 1, 5, and 15 minute load averages. ngl they're an exponentially damped moving sum, and those numbers are constants in the equation 🤓 then you get the number of running tasks, a slash, and the total number of tasks. the last number is the last PID that got created 🦋

🧚 OVERHEAD 🧚

negligible 💅 basically no cost, iconic behavior

🎀 SOURCE 🎀

this is from bcc 💖

https://github.com/iovisor/bcc

also look in the bcc distribution for a companion _examples.txt file. it has example usage, output, and commentary for this tool, so it's like a little study guide 📚🫶

🌊 OS 🌊

Linux only, bestie 🐧

🧪 STABILITY 🧪

Unstable - in development. ⚠️ it's still cooking, so don't be shocked if things change 🙈

👑 AUTHOR 👑

Brendan Gregg 🌟 the queen who made it

🫶 SEE ALSO 🫶

memleak(8) 💜 go check that one next, it's giving sibling energy

okay that's the whole tea ☕✨ this was oomkill(8) from the USER COMMANDS section, dated 2016-02-09. stay iconic, bestie 🌸💅🦋

📦 where this page comes from