hgn/monetta

HTTP Monitoring Server/Client for Systemd based Systems

Monetta - Linux Monitoring Daemon

A Lightweight¹ Logging and System Monitoring Web Server

¹lightweight in the sense that required processing operations are shifted to browser side. E.g. journal data is directly tailloged from journal -f json and piped into a websocket to the client - no intermediate processing. Open files within /proc cannot be optimized out (though, if tab is not active, no data is gathered)

Installation

# download this package
git clone https://github.com/hgn/monetta.git
cd monetta

# aiohttp package is required (python webserver)
pip install -f requirements.txt

# monetta is using python binding to log
# into journal
aptitude install python3-systemd

# start the server
./run.py -f assets/monetta.conf

# open your browser -> http://localhost:8080/

Journal Tab

Displays Systemd journal information. Some filters are available. Journal can also be downloaded as JSON or Syslog format (you can even wget the both formats if you want).

Utilization Tab

Focus on life data of the system. Update interval is one second.

• Avg Run [µs] average time spent on the CPU until scheduled out
• Avg Wait [µs] average time spent waiting on a runqueue until scheduled in
• Scheduled [/s] How often this process is switched into. See function prepare_task_switch(). Which will call sched_info_switch(). The number of context switches it divided by interval to get them per second. Or other: number of timeslices run on this cpu per seconds.

Process Tab

Provides static data of an process. The page is updated rarely (every 10 seconds).

IRQ Tab

Updated every second and display all interrupt related data, including affinity mask.

Problem Statement

Every mid-size and larger project - including embedded projects - requires at least a logging infrastructure. Piping the logging data via netcat to a client written in QT is fine but has drawbacks: cross platform limitations, software distribution, stable and and backward compatible APIs to serve old clients, writing nice GUIs, etc.

Monetta try to address this problem by using modern web technologies and simultaneously try to be resource friendly - at least try to do so:

  USS      PSS      RSS
23264    24320    29404

Monetta is released under a liberal licence - use it in your project without any pain!

Goals and Paradigms

• Targeted for Embedded Environments
• Shift computational tasks to the client (web browser), the server provide raw values
• Stick with Systemd and Journalctl
• Reduce external dependencies - just standard Python, aiohttp and python3-systemd
• If no client is connected the service should idle 100%

Installation

Debian based distribution:

aptitude install python3-systemd

monetta's Issues

Implement better Memory Overview

See:

• https://github.com/insop/ps_mem/blob/master/ps_mem.py

cpu-usage.py process_stat_data_by_pid_ng fails on processes with space

monetta/scripts/cpu-usage.py

Line 53 in d9e0f56

procdata = proctimes.split(' ')

Firefox starts a process with this stat file:
3102 (Web Content) S 2738 2279 2279 1026 2279 4194304 7879765 0 235 0 43890 5292 0 0 20 0 25 0 15091 2447937536 108858 18446744073709551615 474214596608 474214752772 140737361509984 140737361508192 140450924365581 0 0 16781314 1107297528 0 0 0 17 0 0 0 397 0 0 474216851856 474216853608 474247172096 140737361511027 140737361512373 140737361512373 140737361514463 0
split(' ') obviously fails with the space in the process name