docs: reword reports/events union without old/new framing
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user