Fleet & tracking
Troubleshooting (Fleet & tracking)
Common issues across live tracker, vehicles, and devices.
Access and redirects
| Symptom | Likely cause |
|---|---|
| Live tracker sends you to Dashboard home | Missing view_vehicle. |
| Vehicles list redirects home | Missing view_vehicle. |
| Device pages redirect to Devices list | Missing view_device on detail, or missing view_sensor on sensors tab route. |
| Button missing (Add vehicle, Add device, etc.) | CanI requires multiple permissions; see Permissions and access. |
Data and empty states
- No vehicles on map: Filters or search exclude all rows, or your group has no vehicles.
- Telemetry zeros or missing speed: Device not reporting; check assignment and hardware.
- Vehicle history empty: No telematics for the selected window—widen
startDate/endDate. - Camera history empty: Device may not support camera or no captures in range.
- Device parameters empty in Raw data: Field not populated in API response.
UI vs code mismatches
- Live tracker search hint mentions company name, but the client filter only checks plate, make, and model. If search seems wrong, use plate or make/model keywords.
Features intentionally not documented here
The following routes exist in the router but are not treated as production-ready tenant workflows in this manual:
- Device activity log (
.../activity-log) shows a “coming soon” placeholder only. - Vehicle work order and vehicle incidents tabs use mock data modules and are not present in the vehicle detail navigation; do not use them as reference processes.
Still stuck?
- Confirm organization and group context.
- Retry with a hard refresh after permission changes.
- Capture the URL (including search params) and approximate time range for history issues; share with support or engineering.