feat(health): /health, HealthWidget en ops-agent host_metrics (IDEA-276, increment 1) #303
No reviewers
Labels
No labels
severity/s2
severity/s3
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/Ops-dashboard!303
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "feat/idea-276-health"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
IDEA-276 "Dashboard", increment 1 (sprint S-2026-10-23-1, PBI-27, stories ST-083..ST-085; plan rev 10 @
46fae23b, spec rev 10)./healthen de HealthWidget op/tonen voor scrum4me-srv wat actie vraagt, wat aandacht vraagt en wat normaal draait; de host-kant is één read-only ops-agent-commandohost_metrics.Story 1 — ops-agent-moduul (ST-083, T-219/T-220).
ops-agent/wrappers/host-metrics/host-metrics.sh(POSIX sh,LC_ALL=C) levert één JSON-document: cpu-sample uit/proc/stat, mem/swap, uptime, reboot-required,df,docker system df,apt list --upgradable+ cache-leeftijd,du -sb /tmpen de ISS-65-pincheck (broker.json+profile/dispatch-profile.json, maxdepth 3, tegen ééndocker image ls --no-trunc --digests). Elke externe aanroep ondertimeout -k 1 7(worst case 41 s < 45 s client-timeout); deelfouten wordennull+errors-entry, nooit een non-zero exit (2 = jq ontbreekt, 3 =/proconleesbaar). Command-keyhost_metrics(read_only: true) incommands.yml.exampleen de baseline;read_backup_statuskrijgt ookread_only: true(anders neemt de 30-s-sampler de legacy-mutation-lease). Sudoers-regel, idempotenteinstall-host-metrics-module.sh, aanroep insetup.sh, baseline-README-freeze (drift verwacht tot de host-rollout). Geen wijziging aanops-agent/src.Story 2 — datalaag (ST-084, T-221..T-223).
lib/host-health/{types,format,parse,rules,sampler,collect}.ts,instrumentation.ts(30-s-sampler in eenglobalThis-singleton, directe eerste meting, 10-min-venster, max 20, inFlight-guard, nooit een unhandled rejection) enGET /api/host-health(401 zoals/api/network/summary, 404 zonder capabilityhealth).HOST_METRICS_TIMEOUT_MS = 45_000is de web-app-kant van het tijdbudget; de wrapper-test pint de 45 aan zijn kant.Story 3 — UI (ST-085, T-224..T-226). nivo 0.99 (build-bewijs: webpack-build van Next 16.2.6 groen zonder
transpilePackages), tokengebondenLineSeries/BarSeries(--chart-1..5,--foreground,--muted-foreground,--border,--popover; volgen de themawissel zonder herladen;animateuit;role="img"+aria-label),/health(sessiecheck vóór capability en meting; Actie vereist / Aandacht / Normaal + negen kaarten; 30-s-poll), nav-item "Gezondheid", capabilityhealthvoor linux (darwin ongewijzigd), HealthWidget als eerste kaart op/metgetHostHealth({ fresh: false }).Tests (base-groep).
host-metrics-wrapper(22, met stub-commando's en fixture-/proc, echte coreutils-timeout),host-metrics-command-classification,ops-agent-install-host-metrics-module,host-health-parse,host-health-rules,host-health-sampler,health-page-auth. CI-stap "Ensure jq and python3 for the host-metrics tests" in Root app checks. Lokaal:npm run typecheck0 fouten,npm run buildgroen,npm run test:ci:basegroen (zie laatste commit).Visuele proef. Dev-server op de Mac met een fake ops-agent (SSE met
test-fixtures/host-metrics/sample-full.json) en een wegwerp-DB: server logt[host-health] sampler gestart;/en/healthin light en dark — screenshots als bijlage bij deze PR.Na merge (story 4, ST-086, door JP op de host).
sudo bash deploy/ops-agent/install-host-metrics-module.sh, baseline verbatim naar/etc/ops-agent/commands.yml+systemctl restart ops-agent, drift-detector in twee lagen (check-ops-agent-drift.sh 154 deploy/ops-agent/baselineenapply-drift-runtime.shzonderWARNING:), wrapper-proef als ops-agent, app-release, containerlog "[host-health] sampler gestart", read-only-bewijs in drie stappen via de admission-audit. Volledige stappen staan in taak T-227/T-228.🤖 Generated with Claude Code
sampler.ts: HOST_METRICS_TIMEOUT_MS = 45_000 (web-app-kant van het tijdbudget), state in één globalThis-singleton (instrumentation.ts is een aparte bundel-entry), measureOnce deelt een lopende meting via inFlight en vangt gegooide fouten (abort, agent onbereikbaar, HTTP 409/400, SSE-error) als error-entry 'agent'; startHostSampler meet direct en daarna elke 30 s (idempotent, unref); getHistory past het 10-min-venster bij elke lezing toe, max 20, oud→nieuw. collect.ts: getHostHealth({ fresh }) — latest ≤ 35 s → gebruik; fresh → gedeelde meting; fresh:false → latest binnen 10 min of 'nog geen meting' zonder wachten; backup-read parallel (15 s) → parseStatusEnvelope; nooit een throw. instrumentation.ts: register() in try/catch, alleen nodejs-runtime, niet bij build/vitest, alleen met capability health. Route: 401 zoals /api/network/summary, 404 zonder capability health. Tests: ringbuffer 20, fouten tellen niet, geen unhandled rejection, singleton over vi.resetModules, 15-min-uitval → één sample, trage meting niet overlapt, timeout-constante doorgegeven. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>app/_components/HealthWidget.tsx ('use client'): "N actie · M aandacht" of "Alles normaal" met statuspunt (bg-error/bg-warning/bg-success) en woord, hoogstens drie bevindingen (action eerst), "meting van n min geleden" als metrics.at ouder is dan 60 s, "nog geen meting" bij metrics null, 30-s-poll op /api/host-health die bij een fout de oude data laat staan. app/page.tsx: settle(getHostHealth({ fresh: false })) achter capability health in de Promise.all — de home-render wacht nooit op een lopende host_metrics-meting; projectie op dezelfde vijf velden als de poll. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>app/health/page.tsx: eerst getCurrentUser() + redirect('/login') (proxy.ts controleert alleen cookie-aanwezigheid), dan hasCapability('health') → notFound(), dan getHostHealth(); shell mx-auto max-w-7xl. HealthView ('use client') pollt elke 30 s via apiFetch en houdt bij een fout de oude data; HostHealth.errors als foutregels bovenaan. Secties Actie vereist / Aandacht (alleen bij inhoud) / Normaal (okSections als success-badges met punt + woord); kaarten Systeem, CPU 10 min en Geheugen 10 min (LineSeries, swap-reeks alleen bij swapTotal > 0), Schijven (BarSeries, kleur 3/4/5 op 85/95 %), Docker-schijf, /tmp en swap, Updates, Backup (link /settings/backups), Dispatch-images (weggelaten alleen bij null zonder error 'dispatch_images'; "niet opruimen (ISS-65)"). Findings linken naar #card-<sectie>; hostbrede meetfouten (measure:agent/parse) zonder anker. capability 'health' in DEFAULT_CAPABILITIES.linux (darwin ongewijzigd); nav-item { href: '/health', label: 'Gezondheid', cap: 'health' }. Test health-page-auth: zonder sessie redirect vóór capability en getHostHealth; zonder capability notFound; met beide één getHostHealth. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>MAJOR 1: reboot-required is een eigen meting (markerbestand) en werd niet beoordeeld zodra de apt-lijst ontbrak of faalde (run('updates') sloeg de hele sectie over). rebootFinding() loopt nu buiten de updates-run; de apt-deelfout blijft attention en 'updates' blijft uit okSections. Regressietests: reboot + apt-fout, reboot + updates null, reboot + gezonde lijst. MINOR 2: HealthWidget toont telling en bevindingen ook bij metrics null (bv. een backup-actie terwijl host_metrics faalt), met de meetfout als extra regel; nooit "Alles normaal" zonder hostmeting. MINOR 3: toSeries/memorySeries naar lib/host-health/series.ts (puur) met test/host-health-series.test.ts: geen swap-reeks bij swapTotalBytes 0, alle y-waarden eindig, nooit 0/0. MINOR 4: dispatch-kaart toont pinpaden relatief aan /etc/scrum4me-dispatch (broker.json vs claude/broker.json), volledig pad als title. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>REQUEST_CHANGES
Findings:
lib/host-health/rules.ts:350: een apt-deelfout verbergt het onafhankelijk gemeten herstartvereiste. MetrebootRequired: true,updates: nullen eenapt-error wordt de gehele updates-regel overgeslagen; de uitvoer bevat uitsluitendmeasure:apt(attention), zonderupdates:reboot(action). Daardoor ontbreekt deze vereiste actie in/healthen de HealthWidget. Rechtstreeks gereproduceerd met de PR-fixture. BeoordeelrebootRequiredonafhankelijk van apt-beschikbaarheid én de sectie-failureguard; voeg een regressietest voor deze combinatie toe.plan gekoppeld via pbi — IDEA-276 / PBI-27. De meegeleverde plansnapshot is rev 9; de PR verwijst naar rev 10 en rondt ST-083 t/m ST-085 af. De bovenstaande finding wijkt af van het vereiste dat
rebootRequiredeen action-bevinding oplevert. Story 4 (host-rollout) is expliciet na merge gepland en is geen blokkade voor deze PR. Geen references- of omitted-velden aangeleverd.Verificatie op commit
0d07e530911582e1985f20872c19e5f1b7da5dd4: 894 tests in 10 gerichte suites geslaagd (wrapper, classificatie, installer, parser, regels, sampler, auth en bestaande layout/thema/Mac-guards);npm run typecheckennpm run buildgeslaagd na initialisatie van de submodules en Prisma-client. Geen volledige testsuite, eigen browserproef of host-rollout uitgevoerd. Productdocs voor de health-specificatie, page-shell-ADR en stylingpatronen geraadpleegd; verder geen blokkerende afwijkingen vastgesteld.Codex-review via dispatch (JP-opdracht vóór merge)
0d07e530(dispatch60ba3c2f-071b-4e4f-a210-2d0b2727e82a): NO-GO — MAJOR: apt-deelfout verborg een onafhankelijk gemeten reboot-required (dezelfde bevinding als de s4m-codex-reviewer hierboven); MINOR: widget verborg bevindingen bijmetrics null, zero-swap-UI-proef ontbrak, pinbestanden ononderscheidbaar; alle zeven bewuste afwijkingen geaccepteerd.8943ee83(alleenlib/host-health/rules.ts,lib/host-health/series.ts(nieuw),app/_components/HealthWidget.tsx,app/health/_components/metric-cards.tsx,test/host-health-rules.test.ts,test/host-health-series.test.ts(nieuw),scripts/ci/test-groups.json; wrapper, sudoers, installer, sampler, collect, route,ops-agent/srcentheme.cssongewijzigd).8943ee83(dispatchc8a206fe-dd2d-4de9-821f-5766a330a90b): GO — MAJOR 1 en MINOR 2–4 opgelost, geen nieuwe bevinding; NOTE: de reviewcontainer kon tests/typecheck/build niet draaien (geen registry) en kon de ongewijzigdheid buiten de vier fixes niet zelf bewijzen (shallow checkout). Dat bewijs: de bestandslijst hierboven (git show --stat 8943ee83), lokaal 874 tests groen in 7 bestanden + typecheck 0 fouten, en de Forgejo-CI op deze head.Screenshots light/dark van
/en/healthstaan als bijlage bij deze PR (opgenomen op0d07e530; de widget-wijziging raakt alleen demetrics null-toestand).COMMENT
ops-agent/wrappers/host-metrics/host-metrics.sh:130: mountpaden worden zonder JSON-escaping geïnterpoleerd. Met een geldig pad zoals/mnt/a"bfaaltjqop regel 133 en breektset -ede volledige meting af, in plaats van alleen df als deelfout te melden. Gereproduceerd met een df-stub: exit 4, lege stdout. Gebruik jq voor string-escaping en vang de parsefout af; voeg hiervoor een fixture toe. Dit betreft een uitzonderlijke mountconfiguratie en is hier geen mergeblokkade.plan gekoppeld via pbi (IDEA-276 / PBI-27, Ops Dashboard). De aangeleverde plankopie is rev 9; de PR-beschrijving verwijst naar rev 10. Binnen de beoordeelde scope ST-083–ST-085 is geen blokkerende strijdigheid vastgesteld. ST-086 (host-rollout, drift- en runtimebewijs) staat expliciet na merge en is geen ontbrekende oplevering van deze PR. Geen references/omitted-velden aangeleverd.
Authenticatie/capability-gating, sampler-singleton, foutkanalen, thematokens en max-w-7xl sluiten aan op de bestaande patronen en geraadpleegde productdocs. Baseline-documentatie beschrijft de verwachte drift tot rollout.
Verificatie op commit
8943ee831b374152f1f3d987b09af041881369cd: 134 featuretests en 777 aanvullende regressiechecks geslaagd;npm run typecheckgeslaagd na Prisma-generatie, submodule-initialisatie en installatie van ops-agent-dependencies;git diff --checkschoon. Build, browserweergave en productiehostproeven niet zelfstandig uitgevoerd.