admin/felhom.eu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

hub v0.48.0 CHANGELOG + logging-conventions: TRACE level + ring sizing/spill (controller fix-3/fix-6, CAMPAIGN-3 closed)

Browse Source 
🤖 Generated with [Claude Code](https://claude.com/claude-code)

https://claude.ai/code/session_017CDMFpFx84pfviCTVuGGhf
This commit is contained in:
authentik Default Admin
2026-07-12 10:31:26 +02:00
parent 9095981d0c
commit d02a216d0f
2 changed files with 14 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/runbooks/logging-conventions.md
+7 -3
View File
@@ -8,6 +8,7 @@
| Level | Meaning | Examples |
|---|---|---|
| **TRACE** (controller, v0.120.0) | A **periodic job's ROUTINE success** — "nothing happened, again". Dropped from the debug ring at write-time (fix-6, CAMPAIGN-3) so it never eats the finite post-incident window. NEVER used for a failure or a state change. | `[TRACE] [scheduler] job status-refresh: finished in 2ms`, `[TRACE] [stacks] refreshStatusLocked: stack "radarr" → state=running` |
| **DEBUG** | Flow detail: phase steps, per-call traces, parsed values, verdicts with their inputs | `netverify: /proc/mounts verdict mounted=false`, `[agentapi] GET /storage -> 200 (12ms)` |
| **INFO** | State changes and operations **with durations** ("X done in Yms") | `network storage added + verified: … in 4200ms`, `operator log pull served` |
| **WARN** | Degraded-but-continuing | `journal unavailable — degraded classification`, `status persist failed` |
@@ -33,9 +34,12 @@ messages derived FROM log categories are mapped to Hungarian at the UI layer, ne
## Capture layers (how DEBUG reaches the operator)
- **Controller**: the 1000-entry `LogBuffer` ring ALWAYS exists; stdout respects `logging.level`
via `LevelFilterWriter`. New leveled lines use `internal/logx` (`Debugf/Infof/Warnf/Errorf`).
Legacy `isDebug()`-gated call sites are grandfathered — their DEBUG does not exist at `info`.
- **Controller**: the **5000-entry** `LogBuffer` ring ALWAYS exists (raised from 1000 in v0.120.0 —
fix-6); stdout respects `logging.level` via `LevelFilterWriter`. New leveled lines use `internal/logx`
(`Debugf/Infof/Warnf/Errorf`). Legacy `isDebug()`-gated call sites are grandfathered. **TRACE** lines
are dropped from the ring (periodic-noise policy). The ring **spills** to `<DataDir>/debug-ring.log`
(SSD state dir, atomic JSON-lines) every 30 s + on shutdown and loads back on boot, so a restart /
container recreation preserves the pre-restart window — the campaign's exact evidence-loss gap.
- **Agent**: `applog.New` fans out — stderr/journald at the configured level, the `applog.Ring`
fixed at DEBUG. Served by `GET /debug/logs` (local API) and the heartbeat log pull.
- **Hub**: plain leveled Printf; the hub is directly operable, no ring needed.
hub/CHANGELOG.md
+7
View File
@@ -1,5 +1,12 @@
# Felhom Hub — Changelog
## v0.48.0 — accept the app_start_failed event (controller fix-3, CAMPAIGN-3) (2026-07-12)
- `app_start_failed` added to `allowedEventTypes` (`internal/api/handler.go`) + `customerMessages`
(`internal/notify/templates.go`). Without the allowlist entry the controller's fix-3 event (a
DEPLOYED app found not running — controller v0.120.0) would 400 at ingest and never reach the
operator. No other hub change; pairs with controller v0.120.0 which closes the CAMPAIGN-3 finding set.
## v0.47.0 — UI reorganization: customer tabs, Host tab, stale-host removal, offsite multi-endpoint UI, button contrast (2026-07-11)
Five hub-side deliverables; no agent/controller/protocol changes. Baseline `8e1a3f0`