How-to v2

You see a symptom (no new measurement data, an update keeps failing) and want to know which service of the edge is responsible.

Steps

  1. Top-right cog → Settings → Diagnosis in the sidebar.

  2. The list shows every edge service of your device (such as main-ui, datastore, postgres, update-service and — depending on the equipment — grafana, idea4sbridge, iolink-proxy, mosquitto, usb-service, flecs) — each with a status dot and an N messages drawer:

    Settings → Diagnosis with green status dots

  3. Read the status:

    • 🟢 green → no open messages, the service considers itself healthy.
    • 🟡 yellow → at least one warning. Service still runs, but something is off.
    • 🔴 red → at least one error. Service may be degraded or failed.
  4. For any non-green dot expand the N messages drawer — individual messages appear with their code and an explanation.

  5. Look the code up in the Diagnosis codes table — it explains the meaning and the typical action.

Common patterns

  • update-service red shortly after an update: the update was rolled back — the previous state is running again; see Diagnosis codes 2xxx.

If you’re stuck

Send the hotline the machine ID, the symptom and the codes shown, most easily as a screenshot of the diagnosis page.