healthchecks/healthchecks

Features

• Heartbeat Monitors - Tracks task health by alerting when expected periodic HTTP or SMTP heartbeat signals fail to arrive.
• Cron Job Monitoring - Tracks the execution, success, and reliability of scheduled tasks and systemd timers.
• Monitoring Email Aliases - Enables the creation of unique email addresses that scheduled tasks use to signal health status via SMTP.
• Cron Scheduling - Uses standard cron syntax to determine expected ping arrival times and calculate late-state transitions.
• Hanging Job Alerts - Triggers alerts if a job sends a start signal but fails to report success within a configured grace period.
• Heartbeat Signal Parsing - Processes incoming SMTP messages to allow scheduled tasks to signal their health status through email.
• SMTP Server Implementations - Implements an SMTP server to receive and process incoming emails as health check pings.
• Alert Notification Systems - Polls the system for state changes in monitored tasks and dispatches alerts when expected signals are missed.
• Dead Man Switch Alerting - Functions as a dead man switch, alerting users when expected periodic signals from remote processes fail to arrive.
• Health Checks - Provides a comprehensive API for managing the lifecycle of health checks, including creation and state control.
• Notification Channels - Delivers failure notifications through multiple channels including email, webhooks, SMS, and chat platforms.
• System Health Dashboards - Displays the current health and operational status of all monitored tasks via a web dashboard.
• Signal Classification Filtering - Scans email subjects and bodies for keywords to classify messages as start, success, or failure signals.
• Multi-Channel Dispatchers - Routes failure alerts through a pluggable system of webhooks, SMTP, and third-party API integrations.
• Health State History - Maintains a history of transitions between up and down states for each check with time-based filtering.
• Exit Status Reporters - Accepts numeric exit codes via HTTP requests to determine if a remote script succeeded or failed.
• Device Heartbeat Monitoring - Verifies network router health by receiving heartbeat pings sent via scheduled scripts from router firmware.
• Infrastructure Project Organization - Groups monitors and integrations into distinct projects to manage different environments or task sets.
• Concurrent Execution Monitors - Uses unique identifiers to match start and success events, enabling accurate duration tracking for overlapping jobs.
• Multi-Factor Authentication - Implements second-factor authentication using hardware security keys via the WebAuthn standard.
• Task Completion Timing - Calculates the duration between start and success signals to track how long scheduled tasks take to complete.
• Systemd Service Monitoring - Tracks the execution of systemd services by receiving start and completion signals to detect missed runs.
• Grace Periods - Provides configurable time windows after a task is due before triggering an alert to account for deviations.
• Automatic Check Provisioning - Allows the automatic creation of a new monitoring check during the first execution of a script using a provisioning key.
• Availability Reports - Sends periodic email summaries detailing check statuses and downtime statistics across all projects.
• Diagnostic Logging - Records event information without changing the health state to capture diagnostic logs without triggering alerts.
• Supplemental Diagnostic Data - Allows including supplemental status information in the request body to provide context when a task reports health.
• Execution Logs - Captures the request body of pings as log entries to allow inspection of command output.
• Automatic Provisioning - Automatically creates a new monitoring check upon the first ping if it does not already exist.
• State Management - Controls how pings affect service status and allows checks to be paused during maintenance.
• Immediate Failure Signaling - Allows signaling a failure immediately via URL suffixes or keywords to trigger notifications without waiting for a timeout.
• Availability Summaries - Compiles weekly and monthly summaries of task performance and uptime to track reliability over time.
• Task Outcome Metrics - Stores numeric exit codes and request body data sent from tasks to analyze execution success or failure.
• Prometheus Exporters - Exposes internal check health and status counts via a scrapeable Prometheus-compatible endpoint.
• Status Badges - Generates visual indicators and URLs that report the health of checks or projects for external dashboards.
• Automation - Monitoring service for cron jobs and scheduled tasks.
• Automation Tools - Listed in the “Automation Tools” section of the Awesome Selfhosted awesome list.
• DevOps and Infrastructure - Cron job and background task monitoring.
• Monitoring and Process Control - Web-based monitoring service for scheduled cron jobs.
• Monitoring and Status - Monitoring for cron jobs and scheduled tasks.
• Monitoring Systems - Monitoring for cron jobs and scheduled tasks.
• Observability and Monitoring - Service for monitoring cron jobs and scheduled tasks.
• Open Source Projects - Cron monitoring tool.

Star history