[session 1] docs: four operational traps (journal amounts, core.version pin, log levels, OOM ordering) #45

2026-07-19T13:13:09-04:00

hiveiq commented

2026-07-19 13:13:09 -04:00

Refs #44

Session: 1

Four traps that had each already bitten, two of them twice, none written down where the next person would look. Surfaced by auditing sessions 1-3 merged PRs against Guide coverage.

Verified against source, not from the audit summaries:

JournalParser.java:38-54 - mask covers leading digits; DISPENSED matched separately and wins; whitelist excludes BALANCE/ATM OWNER FEE/SUBTRACT
hiveops-agent/pom.xml:44 - hiveops.agent.core.version is a separate property from <version>
compose/aria.yml:14-16 - carries an inline comment confirming root-logger override, measured on hiveiq-journal
compose/journal.yml (+500 x11), infrastructure.yml (-900), agent-proxy.yml (-900)

Deliberate choices: the journal section flags an unresolved question (whether pre-fix rows are 0 or absent) rather than guessing, since it affects figures quoted to customers. The devops.prod section gives a grep for live heap values instead of copying numbers that would drift.

Left as Refs rather than Closes so the issue stays open until the rendered pages are eyeballed.

Refs #44 Session: 1 Four traps that had each already bitten, two of them twice, none written down where the next person would look. Surfaced by auditing sessions 1-3 merged PRs against Guide coverage. **Verified against source, not from the audit summaries:** - `JournalParser.java:38-54` - mask covers leading digits; DISPENSED matched separately and wins; whitelist excludes BALANCE/ATM OWNER FEE/SUBTRACT - `hiveops-agent/pom.xml:44` - `hiveops.agent.core.version` is a separate property from `<version>` - `compose/aria.yml:14-16` - carries an inline comment confirming root-logger override, measured on hiveiq-journal - `compose/journal.yml` (+500 x11), `infrastructure.yml` (-900), `agent-proxy.yml` (-900) **Deliberate choices:** the journal section flags an unresolved question (whether pre-fix rows are 0 or absent) rather than guessing, since it affects figures quoted to customers. The devops.prod section gives a grep for live heap values instead of copying numbers that would drift. Left as Refs rather than Closes so the issue stays open until the rendered pages are eyeballed.

hiveiq added 1 commit 2026-07-19 13:13:10 -04:00

docs: four operational traps that each cost real time 158f0acb21

Surfaced by auditing sessions 1-3's merged work against the Guide. Each
of these had already bitten at least once, two of them twice, and none
were written down where the next person would look.

- technical.journal — recycler ATMs mask the record Amount field on the
  LEADING digits, so amounts come from labelled JPR receipt lines with
  DISPENSED taking precedence. Includes the not-backfilled caveat for
  rows parsed before journal#48.
- processes.release — mvn versions:set does not touch
  hiveops.agent.core.version, so a release ships green while silently
  omitting every core fix (agent#91, then #92/#93 in one cycle).
- platform.gotchas — LOGGING_LEVEL_ROOT=INFO does not silence DEBUG;
  package-level loggers override root.
- devops.prod — oom_score_adj set via /proc is lost on container
  recreate; it has to be in compose.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

johannes approved these changes 2026-07-19 13:13:24 -04:00

hiveiq merged commit b5de1a1107 into develop

2026-07-19 13:14:11 -04:00

hiveiq deleted branch docs/four-operational-traps

2026-07-19 13:14:11 -04:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: hiveiq-src/hiveops-guide#45