alexjustesen/speedtest-tracker
Speedtest Tracker
Speedtest Tracker is a self-hosted application that automatically schedules and records internet speed tests on a recurring basis. It continuously monitors download and upload speeds, ping latency, and packet loss, storing results as time-series data in a relational database. The application displays historical trends through a web dashboard and provides a read-only public URL for sharing speed test history with unauthenticated visitors. When network performance degrades, Speedtest Tracker triggers alerts based on user-defined thresholds.
Security and access control are built in: an IP address allowlist restricts incoming requests to authorized source addresses. Notifications are delivered through multiple channels—database, mail, or webhook—and automatically retry delivery up to three times if the initial attempt fails. The interface and scheduling are timezone-aware, and the dashboard supports multiple languages via community-contributed translations. Alert thresholds are fully configurable, allowing users to set limits for download speed, upload speed, and ping values.
Speedtest Tracker uses a cron-driven scheduler to invoke a CLI wrapper around the Ookla Speedtest binary, parsing its JSON output for each test run. The application is designed for containerized deployment and can be installed on various platforms using Docker or other container runtimes.
Features
- Recurring Task Scheduling - Runs internet bandwidth and latency tests on a customizable recurring schedule to continuously track connection performance.
- Automated Extraction Schedulers - Runs automated internet speed tests on a recurring schedule to continuously collect performance data.
- CLI Wrappers - Executes the Ookla Speedtest binary and parses its JSON output to extract network metrics.
- Cron Scheduling - Uses cron-based scheduling to run speed tests at configurable recurring intervals.
- Alert Thresholds - Evaluates speed test results against user-defined thresholds and triggers notifications when limits are exceeded.
- Bandwidth Testers - Schedules and executes bandwidth tests on a regular cadence without manual intervention.
- Internet Performance Monitors - Runs recurring internet speed tests to track download, upload, and ping performance over time.
- Metric Collection - Collects and records download/upload speeds, ping, and packet loss for each test.
- Network Alerting Systems - Sends notifications when measured download, upload, or ping values exceed user-defined thresholds.
- Speed Test Dashboards - Provides a web-based dashboard for viewing speed test history and trends.
- Self-Hosted Monitoring Suites - A self-hostable application for tracking internet connection quality over time using containerized deployment.
- Public - Shares a read-only view of speed test results with unauthenticated users via a public URL.
- Relational Time-Series Stores - Stores each speed test result as a time-stamped row in a relational database for historical querying.
- Public Dashboards - Provides a public URL that displays read-only speed test history without requiring authentication.
- Trend Tracking - Collects and visualizes speed test history to identify trends and evaluate internet service provider reliability.
- Performance Degradation Alerts - Triggers alerts when download/upload speeds or ping values cross configured thresholds.
- Allowlist Management - Restricts incoming requests to authorized IP addresses using a configurable allowlist.
- Notification Channels - Delivers alerts via database, mail, and webhook channels.
- Trend Plotters - Displays historical speed test results and trends as visual charts.
