How rootmax84/redbox-telemetry works
RedBox Telemetry receives vehicle logs, stores them by user and session, then serves a browser experience for exploring, charting, searching, and managing telemetry. The documented fast path queues uploads in Redis for a worker to persist; without Redis, uploads are processed inline. Authentication, quotas, session operations, remote controls, exports, and monitoring form important supporting capabilities. Some feature endpoints are listed only in the tree, so their connections are shown only where the README or excerpts establish them.
Main entry points: page.php Dashboard view · db.php Database access · ul.php Upload endpoint · worker.php Stream worker
Components 30
Telemetry ingestion
- Upload endpoint
web/ul.php - Upload processor
web/src/upload_processor.php - Redis streams
web/src/redis.php - Stream worker
web/worker.php
Browser experience
- Telemetry dashboard
web/src/pages/index.php - Dashboard view
web/src/templates/index/page.php - Charts and map
web/src/templates/index/partials/plot-data.php - Session filters
web/src/templates/index/partials/filters.php - Localization
web/translations.php
Identity and data
- Database access
web/src/db.php - Telemetry database
- Authentication
web/src/auth_functions.php - Login gate
web/src/auth_user.php - Cache layer
web/src/cache.php - User quotas
web/src/db_limits.php - Session retrieval
web/src/get_sessions.php
Operations
- Session operations
web/del_sessions.php - Background tasks
web/src/heavy_tasks.php - Admin panel
web/src/templates/index/partials/admin.php - Log imports
web/import_redlog.php - Session export
web/export.php - Telemetry search
web/search_processor.php
Integrations
- Session sharing
web/share.php - Remote controls
web/remote.php - Live streaming
web/stream.php - Latest metrics API
web/url.php - Prometheus exporter
prometheus/api_exporter.py
Other components
- Vehicle devices
- Browser user
- Prometheus / Grafana
Connections 29
- Vehicle devices → Upload endpoint: submit logs
- Upload endpoint → Redis streams: enqueue upload
- Redis streams → Stream worker: deliver stream
web/worker.php - Stream worker → Upload processor: process upload
web/worker.php - Upload processor → Telemetry database: persist telemetry
- Upload endpoint → Upload processor: inline fallback
- Browser user → Login gate: sign in
web/src/auth_user.php - Login gate → Authentication: authenticate
web/src/auth_user.php - Browser user → Telemetry dashboard: open telemetry
- Telemetry dashboard → Dashboard view: render page
web/src/pages/index.php - Dashboard view → Charts and map: include chart
web/src/templates/index/page.php - Dashboard view → Session filters: include filters
web/src/templates/index/page.php - Telemetry dashboard → Session retrieval: load sessions
- Database access → Cache layer: initialize cache
web/src/db.php - Database access → Redis streams: connect Redis
web/src/db.php - Database access → Telemetry database: query database
- User quotas → Session retrieval: check usage
web/src/db_limits.php - Session operations → Background tasks: queue deletion
web/src/heavy_tasks.php - Stream worker → Background tasks: consume tasks
web/worker.php - Browser user → Log imports: import logs
- Browser user → Session export: export sessions
- Browser user → Telemetry search: search telemetry
- Browser user → Session sharing: share sessions
- Browser user → Remote controls: control settings
- Browser user → Live streaming: view live data
- Browser user → Latest metrics API: fetch latest metrics
- Prometheus exporter → Latest metrics API: fetch metrics
- Prometheus exporter → Prometheus / Grafana: expose metrics
- Dashboard view → Localization: localize interface