How alexjustesen/speedtest-tracker works
Speedtest Tracker monitors internet performance through scheduled and user-triggered Ookla tests, stores result history, and presents dashboards, APIs, and alerts. The graph includes documented metric export and major README capabilities; unsampled scheduling, event-driven notification, and dashboard internals are represented at their supported directory paths, with unverified connections dashed. Source excerpts and the SOURCE INDEX support only a subset of internal call relationships.
Main entry points: Ookla Test job workflow · Result.php Result model · ResultsController.php Results API · Actions.php Quick actions
Components 26
Speedtest execution
- Scheduled tests
app/Services/ScheduledSpeedtestService.php - Test job workflow
app/Jobs/Ookla - Run speedtest
app/Actions/Ookla/RunSpeedtest.php - Server lookup
app/Actions/GetOoklaSpeedtestServers.php - Test events
app/Events
Results and reporting
- Result model
app/Models/Result.php - Result attributes
app/Models/Traits/ResultDataAttributes.php - Dashboard
app/Filament/Pages/Dashboard.php - Trend charts
app/Filament/Widgets - API routes
routes/api/v1/routes.php - Results API
app/Http/Controllers/Api/V1/ResultsController.php - API response tools
app/Http/Controllers/Api/V1/ApiController.php - Result serialization
app/Http/Resources/V1/ResultResource.php
Administration
- Web interface
routes/web.php - Quick actions
app/Livewire/Topbar/Actions.php - Admin settings
app/Filament/Pages/Settings
Integrations and alerts
- Metrics endpoint
app/Http/Controllers/MetricsController.php - Prometheus metrics
app/Services/PrometheusMetricsService.php - Integration settings
app/Settings/DataIntegrationSettings.php - InfluxDB export
app/Jobs/Influxdb/v2 - Notification settings
app/Settings/NotificationSettings.php - Notification processing
app/Listeners - Notification channels
app/Notifications
Other components
- User
- Ookla service
- Notification services
Connections 26
- User → Quick actions: starts test
app/Livewire/Topbar/Actions.php - Quick actions → Server lookup: loads servers
app/Livewire/Topbar/Actions.php - Quick actions → Run speedtest: dispatches test
app/Livewire/Topbar/Actions.php - Run speedtest → Test job workflow: initiates workflow
- Test job workflow → Ookla service: runs tests
- Scheduled tests → Test job workflow: schedules runs
- Test job workflow → Result model: records results
- Test job workflow → Test events: emits events
- Test events → Notification processing: triggers processing
- Notification processing → Notification channels: sends alerts
- Notification channels → Notification services: delivers notifications
- Admin settings → Notification settings: configures alerts
app/Filament/Pages/Settings/Notification.php - User → API routes: requests data
routes/api/v1/routes.php - API routes → Results API: routes results
routes/api/v1/routes.php - Results API → Result model: queries results
app/Http/Controllers/Api/V1/ResultsController.php - Results API → Result serialization: serializes results
app/Http/Controllers/Api/V1/ResultsController.php - Results API → API response tools: uses response tools
app/Http/Controllers/Api/V1/ResultsController.php - User → Web interface: opens interface
- Dashboard → Result model: reads history
- Trend charts → Result model: plots trends
- Metrics endpoint → Prometheus metrics: generates metrics
app/Http/Controllers/MetricsController.php - Metrics endpoint → Integration settings: checks enablement
app/Http/Controllers/MetricsController.php - Prometheus metrics → Result model: reads latest result
app/Services/PrometheusMetricsService.php - Prometheus metrics → Integration settings: uses settings
app/Services/PrometheusMetricsService.php - Test job workflow → InfluxDB export: exports results
- Web interface → Dashboard: serves dashboard