]> git.hungrycats.org Git - bees/commitdiff
docs: document the plan_snap_extra event counter
authorZygo Blaxell <bees@furryterror.org>
Wed, 5 Aug 2026 16:38:50 +0000 (12:38 -0400)
committerZygo Blaxell <bees@furryterror.org>
Sat, 10 Oct 2026 19:00:05 +0000 (15:00 -0400)
Commit 6dc9fb00061e3b864805056b9e86675c2fbcb046
("scan_next: price snapshot metadata unsharing in the space debt")
added the counter without an entry in docs/event-counters.md.

Assisted-by: Claude-Code:claude-opus-5-5
docs/event-counters.md

index fed19efe61d70133776b709e9f21f4226d9c4ae7..e6d00433d0c177ccb54519adaa233e9cb16a8604 100644 (file)
@@ -333,6 +333,7 @@ The `plan` event group consists of events within the `scan_next` planner: choosi
  * `plan_reject_dedupe_max`: A composed plan was rejected because its dedupe operation count exceeded `dedupe-max`.
  * `plan_reject_hole_max`: A composed plan was rejected because its hole-punch operation count exceeded `hole-max`.
  * `plan_reject_total_max`: A composed plan was rejected because its total operation count exceeded `total-max`.
+ * `plan_snap_extra`: A dst plan's space debt included extra reference cost for unsharing snapshot metadata, because the dst has references in a multi-member snapshot family (`rewrite.snapshot-sharing`).
  * `plan_src_gone`: A dst plan was abandoned before executing because a planned source window had no covering ref at all — the ref vanished from the refetched refs list (file range overwritten, file or snapshot deleted) between planning and execution.  Expected filesystem churn; the extent is rescanned in a later cycle.
  * `plan_src_open_fail`: A dst plan was abandoned before executing because every ref covering a planned source window failed to open (deleted files or snapshots lingering in the refs list).  Expected filesystem churn; the extent is rescanned in a later cycle.
  * `plan_start`: A planner pass over one start extent began.