Skip to content

Service Status

Ed Mozley edited this page May 13, 2026 · 1 revision

Service Status

Folder: service-status/ Colour: Emerald #10b981

Service health dashboard with incident-driven status tracking. Each service's current status is derived from the worst open incident affecting it.

Dashboard (index.php)

  • Grid view of all active services, each card showing the worst current impact from open incidents
  • Status levels: Operational (green), Degraded (amber), Partial outage (orange), Major outage (red), Maintenance (blue)
  • Active and recently resolved incidents listed below the grid
  • Create / edit incidents via modal with a multi-service impact selector — one incident can affect multiple services, each with its own impact level

Status Derivation

A service's current status = the worst-impact open incident affecting it. When all incidents affecting a service are resolved, the service returns to Operational automatically. No manual "flip this service back to green" step.

Settings (settings/)

Manage the list of services:

  • Name
  • Description
  • Display order (drag-and-drop)
  • Active flag

Self-Service Portal Integration

The Self-Service Portal dashboard pulls a live system-status panel from this module so end users can see at a glance whether their issue might already be a known outage.

Watchtower Integration

The Watchtower attention card surfaces active incidents and degraded services.

Help

Interactive guide at service-status/help.php with left-pane navigation, scroll-spy, and 6 sections covering the status dashboard, status levels, managing services and incidents, incident history, settings, communication tips.

Key Tables

Table Purpose
services Service definitions
incidents Incident records
incident_services Many-to-many — which services each incident affects, with per-service impact level
incident_updates Update timeline per incident

Clone this wiki locally