1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
//! Fleet-scale metric storage on Apache Iceberg.
//!
//! # This is storage the operator runs, not telemetry this crate sends
//!
//! Read this before anything else here, because the distinction decides whether
//! the module is allowed to exist at all.
//!
//! [`crate::consent`] states, in its module header and on three `ironmon
//! privacy` screens, that *"IronMonitor collects and transmits nothing"* — and
//! it is guarded: `granting_every_scope_still_collects_nothing` grants all five
//! consent scopes and then asserts that every one still reports it collects
//! nothing. That test exists to force the documentation and the CLI screens to
//! be rewritten in the same change as any real collector.
//!
//! **This module does not trip it, and the reason is the direction of the
//! data.** What `consent` forbids is IronMonitor gathering facts about a user's
//! machine and sending them somewhere the *vendor* chose; it says so plainly —
//! "There is no endpoint." What this module does is write a machine's own
//! metrics to a table the *operator* configured and points at, which is the same
//! category as [`crate::tsdb`] writing a local time-series file and
//! [`crate::prometheus`] exposing metrics for the operator's own scraper. Both
//! of those already persist and publish metrics, and neither trips the tripwire,
//! because neither is telemetry in the sense that matters.
//!
//! That said, `consent`'s wording is broad enough to be read the other way —
//! "no code in this crate collects, aggregates or transmits telemetry" is a
//! wider sentence than the endpoint claim underneath it. A reader who finds this
//! module first and that sentence second is entitled to feel misled. **If this
//! feature ships, that paragraph should be narrowed to say what it means: no
//! vendor endpoint, no collection the operator did not configure.** Leaving the
//! sentence as it stands and relying on this one to explain it is how a
//! guarantee becomes folklore.
//!
//! Three properties keep the distinction honest, and each is enforced rather
//! than promised:
//!
//! - **Off unless compiled in.** The `fleet-store` feature is not in `full` and
//! not in `default`. A stock build has no Iceberg in its dependency graph.
//! - **Off unless configured.** There is no default catalog, no default
//! endpoint and no fallback location. Nothing is written until an operator
//! names a table.
//! - **No hardware identifiers.** The join key is a locally generated random
//! value, not a board UUID or a MAC. See [`host_id`], which exists entirely
//! for this reason.
//!
//! # Why Iceberg rather than the existing store
//!
//! [`crate::tsdb`] is a single-machine append-only file with a bincode row
//! format and size-triggered rotation. It is a good fit for what it does and a
//! poor one for a fleet: there is no host column in its rows at all, so every
//! file is implicitly one machine, and answering "which card in which host ran
//! hottest last week" means opening every file in sequence and decoding every
//! record to reach four columns.
//!
//! Iceberg gives the three things that gap needs — a columnar layout so a query
//! touching four columns reads four columns, snapshot isolation so appends from
//! many hosts do not race, and a catalog so the table is discoverable by the
//! engines an operator already runs. It costs a ~50-crate dependency graph and,
//! more sharply, **a Rust floor of 1.94 against this crate's previous 1.89**;
//! `Cargo.toml` records that trade in full.
pub use ;
pub use HostId;
pub use ;
pub use ;
pub use ;
pub use FleetStore;