docs: reword reports/events union without old/new framing
ci/woodpecker/pr/build Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/pr/pre-commit Pipeline was successful

This commit is contained in:
2026-09-05 11:56:50 +10:00
parent ec82155437
commit c20c6fa836
+6 -6
View File
@@ -54,12 +54,12 @@ unknown fields survive untouched.
- A node present in only one backend always appears (falls back to whichever
backend actually returned facts for it).
- **`/reports`, `/events`** — **union**, not a per-node winner. Reports are
immutable history, so a node that moved between PuppetDBs legitimately has
reports in both and both belong in the merged view. Reports dedupe
on `hash`; events, which carry no id of their own, dedupe on the verbatim
record (a node briefly reporting to both PuppetDBs stores identical records in
each). Records the merge cannot key — `extract`/`group_by` aggregate rows — are
never deduped, so every backend's rows pass through even when byte-identical;
immutable history, so a node's reports can legitimately exist in more than one
backend and all of them belong in the merged view. Reports dedupe on `hash`;
events, which carry no id of their own, dedupe on the verbatim record (a node
reporting to more than one backend stores identical records in each). Records
the merge cannot key — `extract`/`group_by` aggregate rows — are never
deduped, so every backend's rows pass through even when byte-identical;
summing those aggregates across backends is not implemented yet.
### Paging and ordering on the merged endpoints