Mini monitoring web-based app and CLI tool for Gnu/linux server.
/!\ In progress...
Monitoring
| Feature | Web | CLI |
|---|---|---|
| Get system infos: O/S, kernel version, uptime/last boot date | ✔️ | ✔️ |
| Get CPU infos: model, frequency, cores number, bogomips, temperature | ✔️ | ✔️ |
| Get Network usage: displaying the IP address of each network interface with the data transmitted and received | ✔️ | ✔️ |
| Check memory/swap usage | ✔️ | ✔️ |
| Check disks/inodes usage | ✔️ | ✔️ |
| Check packages: installed, upgradable, error (.deb packages only) | ✔️ | - |
| Check Fail2ban status and get jails stats | ✔️ (stats based on db) | - |
| Check Iptables/Ip6tables content | ✔️ | - |
| Check ping stats for a configurable host list | ✔️ | ✔️ |
| List all cron jobs (user/system crons, system timers) | ✔️ | - |
Logs reader: support for configurable logs list, including syslog, Apache access/error, Fail2ban logs |
✔️ | - |
| Services status check (check tcp/udp port) for configurable services list | ✔️ | - |
| List system users/groups, last/currently connected users | ✔️ | - |
Web app
- Lightweight and smooth javascript navigation system
- Responsive design
- Dark/Light theme
- Localization (EN, FR)
- Web installer
- A Linux1 web server2 with root privileges
- A dedicated subdomain OR a server with graphical interface to run app in local 3
- PHP >=7.3
- pdo_sqlite extension
1 For now tested only on Debian 10, Ubuntu 21.04, Linux Mint 20.1
2 For now tested only with Apache.
3 For now Alias is not supported.
Minitoring is inspired from ezservermonitor-web and comes with additional features.
Basic monitoring commands can be executed by web server process without admin permissions. Such data are available via a standard web API (protected by a login system).
For some features (logs reader, packages, fail2ban stats...), app must be run with root privileges: Minitoring comes with a WebSocket server wich is run as service and completes the web API (protected by a token).
For now Minitoring is only available as .deb package.
See Install minitoring on debian bullseye with Apache.
For others systems, you will have to build the package:
- Install dependencies and build autoloader using
composer. - [Install dev dependencies and compile scss/js (requires
npm)] I try to keep the assets directory up to date - Run and manage minitoring-server
Most config tasks are done by web installer or can be changed from web interface (only admin user can change monitoring settings). For advanced config changes, like using a custom port or secure WebSocket server, see config.
- You cannot be logged in with the same account on multiple devices at the same time (won't fix).
- Message when login with cookie is not localized (?)
- Web installer does not honor Mysql and PostgreSQL, for now Sqlite only (TODO but for now, no periodic monitoring so large database not needed)
- Packages: deb only, support for
rpmpackages should come soon (TODO -> config) - Supposes iptables/ip6tables used (TODO -> option).
- Supposes Fail2ban used (TODO -> option).
- Supposes systemd is init program: maintainer scripts take care to check that systemd is the init program before running scripts but there is for now no alternative.
- Translation in progress
- Logreader: To add a log file, webserver checks file exists first. To add log files like apache logs, located in
/var/log/apache2on debian, you need to addexecutepermission to that directory (chmod +x /var/log/apache2), otherwise, app will refuse to add file saying it doesn't exist. Note: no need to addreadpermission to web server as file will be read by a service launch by root.