jcoffey-dev
bcb9a01cd6
The demo had 75k generic records across eight host-0N/service pairs, one dashboard, one alert rule, and -- because nothing ever called AgentControl.CheckIn -- a completely empty Agents page. /hack/demo-simulator replaces the generic data with a fictional but coherent fleet: 14 hosts running nginx, an API tier, workers, Postgres, Redis, mail, Linux journals and Windows event logs, whose messages and attributes look like what those services actually write. It backfills a week (~370k records, ~20s) and then keeps running. Running continuously is the point, not an implementation detail. Three things the demo has to show are only true if data keeps arriving: the Agents page marks a host stale once check-ins stop, alert rules evaluate over trailing windows and would freeze in one state against a static dataset, and any "last 15 minutes" view is empty on data that stopped growing overnight. It also emits metrics/heartbeats and answers CheckIn faithfully enough that the remote-config editor's pending -> applied transition works end to end. Seeded incidents give the data something to find: an api-02 outage with matching slow queries on db-01, 5xx at the edge and cascading job failures; an SSH probe burst; a spam wave; a disk filling up; and one decommissioned host left deliberately stale. /hack/demo-seed holds the rest of the deployment -- the nightly reset, eight dashboards (64 panels, every viz type but line), eleven alert rules across three notification targets, and the systemd unit. Rule thresholds are calibrated against what the simulator actually produces: the first pass had four rules whose thresholds the traffic could never reach and one that fired during normal operation. No line charts: dashboard panels reject the raw-SQL escape hatch, and the pipe language has no time-bucketing, so a real time axis isn't expressible today. Noted in demo-seed/README.md rather than papered over.
31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
# hack
|
|
|
|
Local developer tooling that isn't part of any shipped component — scripts
|
|
you run against your own machine/dev stack, not code that ends up in a
|
|
container image (except `dev-certs`' *output*, which mounts into the
|
|
ingest container).
|
|
|
|
Not one of the top-level directories in the original monorepo scaffold —
|
|
added because dev-only mTLS cert generation didn't have a natural home in
|
|
`/deploy` (real deployment manifests), `/transport`, or any other existing
|
|
component. `/hack` is the conventional name for this in a lot of larger Go
|
|
monorepos (Kubernetes among them).
|
|
|
|
- `dev-certs/` — generates a throwaway CA + server/client cert pair for
|
|
local mTLS between the agent and ingest. See `/docs/phase-0-runbook.md`
|
|
for when to run it.
|
|
- `windows-fixture/` — sends synthetic Windows Event Log-shaped records
|
|
directly to `ingest`, bypassing the real Windows agent. Tests whether
|
|
the pipeline handles Windows-shaped data; doesn't test the real
|
|
`EvtSubscribe`/ETW integration, which needs actual Windows. See
|
|
`/docs/phase-1-runbook.md`.
|
|
- `demo-simulator/` — the public demo's synthetic world: a fictional
|
|
fleet whose agents check in, report CPU/memory/disk, and ship
|
|
realistically shaped logs for eight services. Backfills a window of
|
|
history, then keeps generating in real time. Distinct from
|
|
`benchmark-fixture/` (volume, for the Phase 2 latency benchmark) and
|
|
`windows-fixture/` (correctness, for the Windows ingest path).
|
|
- `demo-seed/` — the rest of the demo deployment: its reset script,
|
|
dashboards, alert rules, and the systemd unit that runs
|
|
`demo-simulator`.
|