MinMon
Get a lightweight monitoring and alarming solution for Linux. Use a single binary and a simple TOML config file to set up checks, actions, and reports. No GUI or DB.
This is an opinionated and minimal monitoring tool designed for users who find other solutions too heavy or complex. It operates as a single binary with a single TOML configuration file, eliminating the need for databases, graphical interfaces, or complex setups. The focus is purely on effective monitoring and alarming for Linux systems.
The system is built around three core concepts:
- Checks: These read the measurement values you want to monitor, such as filesystem usage or system pressure.
- Actions: Triggered when a check's alarm changes state. Actions can include sending webhooks, writing to a log file, or running a process.
- Reports: To ensure your monitoring system is actually running, you can configure regular report events that confirm its operational status.
Key design principles include a commitment to simplicity with no complex scripting languages or directory structures. You define your own alarm thresholds, and all time-based operations are handled in UTC to avoid timezone issues. The tool is stateless between restarts, ensuring predictable behavior. Advanced features like placeholders and data filters provide flexibility for customizing actions and transforming measurement data. Installation is straightforward via Docker, cargo, or the Arch User Repository (AUR).
Directory Structure
docker-compose.yml
services:
minmon:
image: ghcr.io/flo-at/minmon:latest
container_name: minmon
restart: unless-stopped
volumes:
- ./config/minmon.toml:/etc/minmon.toml:ro
.env
# MinMon configuration is primarily handled via the minmon.toml file.
# No sensitive environment variables are required for this docker-compose setup.
Tags:
Similar to MinMon