Operate CALIBER
Operator troubleshooting
The first-pass diagnosis path for degraded CALIBER deployments before a failure escalates into full runbook recovery.
Use this page for first-pass diagnosis. If the failure is already severe or indeterminate, jump straight to the Operations runbook.
At a glance
| Symptom | First thing to check | Escalate to |
|---|---|---|
| UI loads but product behavior is degraded | readiness, dependency posture | Health and readiness |
| Workflow runs are not draining | event backend and worker state | Operations runbook |
| File upload or extraction fails | object-store and workflow-storage config | Storage and state |
| Local stack will not boot cleanly | port and dependency configuration | Configuration and provider setup |
| Auth works in the browser but not automation | token, project scope, or CSRF model | Developer troubleshooting |
1. Start with the smallest reliable signal
Before changing configuration, confirm:
- whether the process is alive
- whether readiness is degraded
- which dependency boundary is failing
That avoids masking the real issue with unrelated restarts.
2. Known local bring-up issues
The local launcher already guards one common failure mode: host-port collisions around MLFLOW_PORT, CALIBER_PORT, and MLFLOW_GATEWAY_PORT.
If the stack still fails to start cleanly, check:
- port ownership
deploy/.envand.env- provider and storage settings
3. When to leave troubleshooting and use the runbook
If the failure affects release safety, queue settlement, rollback semantics, or indeterminate external effects, use the runbook immediately.