Files
Felis/docs/changes/2026-06-30-felis-metrics.md
T
flyemoji 096d59716e docs(changes): backfill detail docs for pre-ledger functional commits
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 at 9911b8c).

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 missing 9911b8c row.

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.
2026-07-07 20:55:51 +09:00

1.2 KiB

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).