flyemoji
096d59716e
Retroactively author 15 grouped detail docs covering the backend functional (feat/fix) commits made before the change ledger was established (fad48ff), closing the ledger's detail-doc axis for the pre-convention history. Each doc groups a feature's constituent commits, lists their SHAs with subjects, and carries a backfill note stating it was reconstructed from git history on 2026-07-07 and not independently re-verified (current tree green at9911b8c). Add a Detail docs section to INDEX.md linking every detail doc (the 6 existing + 15 backfill) to the commit(s) it covers, so a doc is findable from the index without a column on the auto-generated ledger table. Catch the table up with the missing9911b8crow. Scope: backend (Go/Java/K8s) only, per the ledger's stated convention that frontend/panel commits are the collaborator's UI work; non-functional commits (docs/style/chore/refactor) keep their table row without a dedicated detail doc.
26 lines
1.2 KiB
Markdown
26 lines
1.2 KiB
Markdown
# felis_* Prometheus metrics (§23) (ledger backfill)
|
|
|
|
- **Type:** feature — retroactive ledger entry
|
|
- **Date:** 2026-06-30
|
|
- **Area:** `internal/metrics` + the emit sites in build, platform/fleet, and the start lifecycle
|
|
- **Commits:**
|
|
- `75642d9` feat(metrics): named `felis_*` Prometheus collectors
|
|
- `2a93a9e` feat(metrics): record `felis_image_build_failures_total` on failed builds
|
|
- `79eae7f` feat(metrics): publish `felis_servers_total` from a fleet snapshot
|
|
- `8ac5e64` feat(metrics): observe `felis_start_duration_seconds` across the start lifecycle
|
|
- **Tasks:** #17 (§23 felis_* metrics decision)
|
|
|
|
## What it did
|
|
|
|
Added the named `felis_*` collector set and wired the three emit points that make it
|
|
non-empty: a counter incremented on image-build failure, a gauge published from a fleet
|
|
snapshot, and a histogram observed across the server start lifecycle.
|
|
|
|
## Why
|
|
|
|
§23 calls for first-class operational metrics under a stable `felis_` namespace rather than
|
|
ad-hoc logging, so an operator can alert on build failures, fleet size, and start latency.
|
|
|
|
> **Backfill note.** Reconstructed 2026-07-07 from the commit history. Not independently
|
|
> re-verified for this doc; current tree green at `9911b8c` (WSL oracle, go1.26.4).
|