Troubleshooting Guide¶
This guide covers common issues in the current ROBIN stack.
Service Startup Issues¶
FIWARE services not starting¶
Check runtime state:
docker compose ps
docker compose logs orion-ld
docker compose logs mintaka
If needed:
docker compose down
docker compose up -d --build
Connection Issues¶
Cannot reach Orion or Mintaka¶
curl http://localhost:1026/version
curl 'http://localhost:9090/temporal/entities?limit=1'
Cannot reach Alert Engine¶
curl http://localhost:8001/health
docker compose logs alert-processor
Data Model Issues¶
Process entity not found¶
Verify process entities in Orion:
curl -H "NGSILD-Tenant: robin" \
"http://localhost:1026/ngsi-ld/v1/entities?type=urn:robin:Process"
Measurements missing in API¶
Check API endpoint:
curl "http://localhost:8001/process/ros_bridge/measurements?last=20"
If empty:
verify that telemetry is being published in ROS 2
verify DDS mapping in
config-dds.jsoncheck Orion and Mintaka logs
DDS Telemetry Issues¶
No data from ROS 2 to Orion¶
Confirm aggregator is running:
ros2 topic echo /robin/telemetry
Confirm mapping configuration:
DDS topic:
rt/robin/telemetryentity:
urn:ngsi-ld:Process:ros_bridgeattribute:
urn:robin:processTelemetry
Note: legacy HTTP NGSI bridge is not part of the current baseline.
Frontend Issues¶
UI not loading¶
curl http://localhost:5174
docker compose logs robin-dashboard
Wrong API target in UI¶
Set VITE_ROBIN_API_URL at build/run time and rebuild frontend if needed.
Domain wording in UI¶
Dashboard labels are loaded at runtime from the active profile YAML
(config/profiles/<name>.yaml). Switch profiles with
ROBIN_PROFILE=<name> docker compose up -d.
See Configuration Reference for details.
Performance Issues¶
Stack feels slow¶
docker stats
For high-rate rosbag playback, reduce playback rate and verify Mintaka/Timescale health.
Getting Help¶
If issues persist:
capture logs from Orion, Mintaka, and alert-processor
record the exact failing command/API call
include configuration snippets (without secrets) in your issue report