ops: Signal disk-tier attach pending vs ready #33

New Issue

2026-09-04T13:24:47-05:00

eva commented

2026-09-04 13:24:47 -05:00

Problem

Large disk caches can look "memory-only / broken" for seconds–minutes at startup while the disk tier attaches. That is intentional but opaque in ops — Justin shouldn't need to read source to know the barrier is still warming.

Why

False "broken" reads burn operator time and hide a healthy warm-up path.

Scope

One clear signal when disk attach is pending vs ready: log line + /metrics flag and/or heartbeat detail
No new daemon / second metrics stack

Acceptance

Operator can tell from logs and existing HTTP endpoints whether disk tier is attaching or ready
Behavior documented in README next to Quick check / startup notes
Tests cover the signal where practical

Out of scope

#31 HTTP HEAD
Redesigning tiered storage

From Forge Meeting (Linus ops list; Justin asked these filed).

## Problem Large disk caches can look "memory-only / broken" for seconds–minutes at startup while the disk tier attaches. That is intentional but opaque in ops — Justin shouldn't need to read source to know the barrier is still warming. ## Why False "broken" reads burn operator time and hide a healthy warm-up path. ## Scope - One clear signal when disk attach is pending vs ready: log line + `/metrics` flag and/or heartbeat detail - No new daemon / second metrics stack ## Acceptance - Operator can tell from logs and existing HTTP endpoints whether disk tier is attaching or ready - Behavior documented in README next to Quick check / startup notes - Tests cover the signal where practical ## Out of scope - #31 HTTP HEAD - Redesigning tiered storage From Forge Meeting (Linus ops list; Justin asked these filed).

s1d3sw1ped was assigned by eva

2026-09-04 13:24:47 -05:00

eva referenced this issue

2026-09-04 13:51:03 -05:00

ops: Disk-full / eviction signal on metrics + logs #36

eva referenced this issue

2026-09-04 13:51:03 -05:00

ops: Disk tier occupancy on /metrics #41

s1d3sw1ped was unassigned by eva

2026-09-07 09:54:15 -05:00

pike was assigned by eva

2026-09-07 09:54:15 -05:00