Task: Show the services in system health

Table of Contents

This page documents a task in the Record service lifecycle events and surface them in system health story. It captures the goal, current status, acceptance, and any notes or results.

1. Goal

The system administrator's home answers "is the installation healthy" in one place. Its System health panel counts tenants alone today: in service, on evaluation, setting up, and those that need attention (the home.system keys in ores.web). The panel splits into sections, one per kind of thing that can be unhealthy: Tenants, as now, and Services, from the services roster. The services section states how many expected instances are running, and names the ones that are lost or missing, with a link to the services screen. Further sections, such as the compute grid or the message bus, can join the same shape later.

2. Status

Field Value
State BACKLOG
Parent story Record service lifecycle events and surface them in system health
Now Not yet started.
Waiting on Nothing.
Next Begin implementation.
Last touched 2026-10-06

3. Acceptance

  • System health on the system administrator's home has a Tenants section and a Services section, each with its own summary line and its own attention list.
  • The services section reads telemetry.v1.services.roster through a BFF route, states running instances against expected ones (for example 20 of 21 running), and lists each lost or missing service by its display name, with a link to the services screen.
  • When the roster cannot be read, the section says so, and the tenants section still renders.
  • Every new string is in each locale the web client carries, and the home page tests cover both sections, including an unreadable roster.

4. Plan

(Implementation strategy. Written when work starts; key decisions are distilled into the parent story's * Decisions at close, but the plan itself stays — it is the historical record of what we did.)

5. Measurements

Every number this task claims about a tree, with the command that produced it and the commit it was measured at. A number without both is not a measurement, because a clean-up record describes a tree and trunk moves under a branch: a consumer count, a gate's component count and a suite's size all change with no code changing, and the reader of a bare number cannot tell which tree it came from. Where the raw output matters, put it in an evidence/ file beside the task and name that file in the Command column.

What Value Command Commit
       

6. Notes

Raised by the operator on 2026-10-06. It reads the roster that Serve the services roster serves, and its states grow when Record service starts and stops adds a graceful stop. The full roster stays on the services screen (Build the operations screens in ores.web); the home shows the summary and the exceptions.

7. Test Scenarios

Manual QA scenarios (scaffolded via compass add test_scenario) that verify this task. Link new ones here as they're created; the scenario doc itself links back via its "Verifies task" field.

Scenario State Notes
     

8. PRs

PR Title
   

9. Review

Comment summary File Decision Notes
       

10. Result

Emacs 29.3 (Org mode 9.6.15)