Nex Uptime Healthcheck Monitor

The problem

Standard monitoring tools often spam your inbox every few minutes when a service is down, leading to alert fatigue and muted notifications. Relying on heavy monitoring stacks for a single self-hosted app or Raspberry Pi is overkill and consumes unnecessary resources.

What it does

• Generates a Python monitor that probes HTTP endpoints and Docker containers on a custom schedule.
• Tracks service status in a local JSON state file to detect transitions.
• Sends Telegram notifications only when a service changes state (down or recovered), remaining silent when healthy.
• Calculates and reports total downtime duration in the recovery alert.
• Provides a complete deployment package including systemd timers, an idempotent install script, and a test mode.

Frameworks & tools

Python, Docker, systemd, Telegram Bot API, and Linux.

Why this beats prompting it yourself

Writing a script is easy, but getting the state-change logic right is difficult. This skill ensures you never get duplicate alerts for the same outage and includes a production-ready systemd configuration that handles environment variables securely through an EnvironmentFile.

Use cases

• Monitor uptime for a personal website or self-hosted dashboard.
• Watch critical Docker containers like databases or Nginx proxies on a Pi.
• Receive immediate Telegram alerts for production outages without the noise of interval pings.
• Track outage history and duration for basic reliability reporting.

Known limitations

Requires a Linux environment with systemd for the scheduling components. Designed for simple up/down status checks rather than complex performance metrics or telemetry.