coreci/inboxos-v1
18
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases 3 Wiki Activity

docs(runbook §5): add ERROR-NN catalog table (REQ-INB-46)

Browse Source 
---ci---
project: inboxos
phase: 1
milestone: v1.4
status: execute
wave: 1
task: T2
---/ci---
This commit is contained in:
cloudinit-bot
2026-06-09 13:59:52 +00:00
parent 61790706d0
commit 0d5b4ee4b1
1 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/operations-runbook.md
+17
View File
@@ -300,6 +300,23 @@ want to measure pure LLM latency without the wrapper overhead.
## 5. Common failure modes and recovery
### ERROR-NN catalog
A one-page lookup table for the on-call operator. If you are reading this from a pager, the table below tells you which §5.X subsection to jump to for the full recovery procedure.
| ERROR-NN | Symptom | See §X.Y |
|-----------|------------------------------------------------------|----------|
| ERROR-01 | Runner stuck / OOM (> 60 min in `in_progress`) | §5.1 |
| ERROR-02 | Live cron emitted no new MIDs for > 30 min | §5.2 |
| ERROR-03 | NocoDB 4xx on upsert (wrong table_id) | §5.3 |
| ERROR-04 | NocoDB 4xx "field is required" (schema drift) | §5.3 |
| ERROR-05 | IMAP connection refused / auth failure | §5.4 |
| ERROR-06 | Ollama connection refused / model OOM | §5.5 |
| ERROR-07 | SeaweedFS connection refused / auth failure | §5.6 |
| ERROR-08 | Papra `dry_run` unexpectedly flipped to `false` | §5.7 |
| ERROR-09 | State file corrupted / offset regression | §5.8 |
| ERROR-10 | Backup tar fails (NocoDB / SeaweedFS / Gitea) | §5.9 |
### 5.1 Runner stuck / OOM (> 60 minutes in `in_progress`)
A single stuck job can block the live cron (live jobs have `cancel-in-progress: false`). Diagnosis and recovery: