Feed troubleshooting
Check the five feed URLs and fix the first broken row.
Feed Health is the operator page for discovery metadata, static GTFS, Vehicle Positions, Trip Updates, and Alerts. Use it before asking someone to run command-line fetches.
What Good Looks Like
| Feed | Good state | Common fix | Open next |
|---|---|---|---|
/public/feeds.json | Lists every configured public feed URL and useful metadata. | Complete publication metadata and public base URL configuration. | /admin/operations/setup |
/public/gtfs/schedule.zip | Returns the active static GTFS ZIP. | Import or publish a schedule before reviewing realtime feeds. | /admin/operations/gtfs-import |
/public/gtfsrt/vehicle_positions.pb | Returns valid Vehicle Positions data or a valid empty feed when appropriate. | Check vehicle data freshness, device bindings, stale thresholds, and assignment confidence. | /admin/operations/realtime |
/public/gtfsrt/trip_updates.pb | Returns Trip Updates only when the prediction adapter can produce safe output. | Review withheld reasons, active GTFS, assignment confidence, and predictor configuration. | /admin/operations/prediction-lab |
/public/gtfsrt/alerts.pb | Returns the Alerts feed from the active alert lifecycle. | Review Alerts Console and affected-service metadata. | /admin/alerts/console |
Fix Feed Issues
- Schedule missingImport or publish GTFS first. Recheck feed health after the active schedule exists.
- Realtime missingReview vehicle data, connector setup, and the realtime page before assuming the public endpoint is broken.
- Validator unavailableAn administrator may need to install or configure allowlisted validator tooling.
- Public URL wrongA deployment owner should check reverse proxy, hostname, public base URL, and feed metadata.
- Ready to shareConfirm license, contact metadata, agency authorization, and deployment ownership before sharing URLs outside the local environment.
Where To Go Next
Need a scheduleImport a schedule.
Need vehicle dataConnect vehicle data.
Need deployment reviewReview the self-hosted path.
Limits
A local feed row or validator result helps with troubleshooting. It is not consumer acceptance, compliance approval, public launch proof, production readiness, SLA coverage, or ETA-quality proof.