oom-notifier

oom-notifier is a program and a library used to track oom scores for Linux.

Description

oom-notifier gets the oom score of each process by getting the /proc/<PID>/oom_score value. As a program, it tracks the oom scores of each process (by default) every 5 seconds and the threshold is set to 1000. If you want to change these values, refer to the configuration header below.

Getting Started

Dependencies

• Any Linux-based distribution
• Python>=3.6
• pip

Installing

1. Install oom-notifier using pip.

$ pip install oom-notifier

Usage

As a library:

import oom_notifier

oom = oom_notifier.OOM()

# to get all pids and oom scores of each process, use this:
all_oom_scores = oom.info  # this is a dictionary

# to get the maximum oom score of all processes, use this:
max_oom_score = oom.max  # this is also a dictionary

As a program:

$ oom-notifier  # launches oom-notifier in the background

Configuration

In ~/.config/oom-notifier/config.ini:

[Main]
; this sets the threshold to where oom-notifier will trigger a notification if it passes this value
threshold = <NUMBER_HERE>
; this sets the time where oom-notifier will wait to refresh the oom-scores
wait_time = <NUMBER_HERE>

Help

oom-notifier only displays in the command line

This usually means that the dbus can't contact the notification service (as, internally, dbus-python raises an exception incase of failure). AFAIK, most of the time the reason this happens is because the notification service isn't installed.

In XFCE:

Check if xfce4-notifyd is running in the background.

$ ps cax | grep xfce4-notifyd

if there's no output, it means xfce4-notifyd isn't running and means it isn't started or isn't installed. If it isn't installed, you can install using your distribution's package manager.

License

This project is licensed under the GNU GPLv3 License - see the LICENSE file for details