Troubleshooting
Product: v0.19.0 · Ingestion SSOT: Ingestion cancel & fairness
Guides for diagnosing and resolving common EdgeQuake issues.
Guides
Section titled “Guides”- Common Issues — Solutions to frequently encountered errors: upload format mistakes, server startup, PDF extraction, query failures, and database issues.
Pipeline reliability (v0.19)
Section titled “Pipeline reliability (v0.19)”Ingestion cancel, lease, and multi-replica behavior are documented in depth in the ops runbook. The troubleshooting guide covers the operator-facing symptoms:
| Topic | Where |
|---|---|
Cancel SSOT (cancel ≠ Failed, display_status, Stopping…) |
Ingestion cancel & fairness |
| Interrupted → Reprocess after restart or lease expiry | Common Issues §3.1 |
| Lease stuck in Processing | Common Issues §3.2 |
EDGEQUAKE_REPLICAS>1 boot fail |
Common Issues §3.4 |
| Queue pressure & compensation quarantine | Observability — queue metrics |
Related
Section titled “Related”- Configuration — env vars including lease, replicas, and queue thresholds
- Monitoring — Prometheus and health endpoints
- SQLx offline mode — build without DB + migration checksum adjacency