Skip to content

docs: the metric families are populated now - #11

Merged
oreofeolurin merged 1 commit into
mainfrom
docs/44-real-metrics
Aug 30, 2026
Merged

docs: the metric families are populated now#11
oreofeolurin merged 1 commit into
mainfrom
docs/44-real-metrics

Conversation

@oreofeolurin

Copy link
Copy Markdown
Contributor

Follow-up to floruntime/flo#44, which asked for this note to be removed once the families were populated.

Half of it is now false and half still holds, so it is rewritten rather than deleted.

Removed — this is no longer true:

Nothing records the per-shard or per-stream counters on the write paths, so flo_shard_* and the per-stream totals currently export as 0.

Stream, queue, per-shard, workflow, processing, KV and tiered-log counters are all wired to their write paths now (floruntime/flo#64, #67, #69).

Kept — still true, and worth keeping people off them:

flo_cluster_nodes, flo_raft_leader_elections_total and flo_gossip_members are not implemented.

Added — one honest zero that would otherwise read as a bug:

flo_tiered_log_cold_hits_total is always 0. The read path consults the hot ring and the warm store only, so a cold read is never counted there. Saying so beats leaving someone to wonder whether the counter is unwired.

npx markline export passes.

The caveat said flo_shard_* and the per-stream totals export as 0 because
nothing recorded them on the write paths. That is no longer true — stream,
queue, per-shard, workflow, processing, KV and tiered-log counters are all
wired to their write paths now.

The other half of the note still holds and stays: flo_cluster_nodes,
flo_raft_leader_elections_total and flo_gossip_members are not implemented, so
nobody should build a scrape config on them.

Added the one remaining honest zero: flo_tiered_log_cold_hits_total is always
0 because the read path consults the hot ring and warm store only, never cold.
Better stated than left for someone to interpret as a broken counter.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant