Skip to content

v1.0.0

Latest

Choose a tag to compare

@underhax underhax released this 01 May 17:11

Initial stable release of bash-sys-monitor, a lightweight, modular suite of shell scripts designed for high-availability monitoring of Ubuntu Server 24+.

Core Features

  • Proactive system performance monitoring (high-load.sh) focused on resource saturation using a combination of Load Average and Pressure Stall Information (PSI).
  • Real-time security auditing (login.sh) by tracking the wtmp log for user access events.

Architecture & Integrations

  • Modular plugin-based architecture separating core scripts, communication senders, message templates, and state.
  • Native multi-channel alerting drivers for Matrix, Telegram, and ntfy.
  • Support for plain text and HTML formatted alerts, including automated file uploads for system process lists.
  • Advanced notifier filtering via command-line flags in systemd units.

Technical Foundation

  • Strict runtime configuration validation covering domain structures, IP formatting, and specific sender token schemas.
  • Robust URL encoding and sanitized input handling to ensure secure API communications.
  • Accurate per-CPU process sampling using top to capture system state during high-load events.
  • Automated CI/CD pipeline with shellcheck, shfmt, and comprehensive BATS test suites.