Skip to Content
Welcome to the new Haccpy docs! đź‘‹
User GuideSystem Health

System Health

Overview

The System Health page (/{tenant}/system-health) shows the status of locations and devices (bridges, tablets) and highlights issues that need attention.

Page layout

  • Top (full width) — Page title (“System Health”), short description, and a Live indicator (e.g. green pill) to show data is live.
  • Two sections below:
    • Left — Stats cards and location cards (with devices).
    • Right — Alerts panel (fixed/sticky on large screens, with max height and scroll).

Stats cards (left)

Summary counts, often:

  • Total Locations — Number of locations.
  • Online — Locations with at least one healthy (or degraded) device.
  • Needs Attention — Locations with critical issues (e.g. unhealthy device, high CPU/RAM).

Values are derived from location and device health data.

Location cards (left)

Each location is shown as a card with:

  • Header — Location name, address (or display address), overall status (e.g. HEALTHY / DEGRADED / UNHEALTHY), and camera status indicators (e.g. dots).
  • Devices — An accordion section “Devices (n)” that expands to show devices in a 2-column grid.

Device card (per device)

Each device (bridge or tablet) shows:

  • Type — Bridge (router) or Tab (tablet); icon and label.
  • Identity — Manufacturer, model, platform, OS version.
  • Status — Online/offline indicator and health badge (e.g. HEALTHY, DEGRADED, UNHEALTHY).
  • Metrics — CPU %, RAM %, Uptime, Last seen.
  • Errors — If present, lastError or similar.

Devices are read from device assignments on the location.

Alerts panel (right)

  • Sticky/fixed on large screens so it stays visible when scrolling.
  • Max height with internal scroll for long lists.
  • Lists alerts such as:
    • Offline / Unhealthy — Device or location down or unhealthy.
    • High CPU — CPU usage above a threshold (e.g. ≥75%).
    • High Memory — Memory usage above a threshold (e.g. ≥75%).

Each alert entry shows location, type (e.g. Offline, High CPU), message, and timestamp. Tooltips on truncated text show the full location name or message.

If there are no alerts, the panel shows an “All systems normal” (or similar) state.

Empty state

If there are no locations, the left section shows an empty state message (e.g. “No locations found — Add locations and cameras in Settings to start monitoring”).

URL

  • System Health: /{tenant}/system-health

No required query params. Data is loaded for all locations and devices the user can access for the tenant.

Last updated on