Runbook

Owner: Operations
Reviewers: DevOps, Engineering
Status: Draft
Version: 0.1
Last Updated: 2026-09-16
Review Cycle: Per operational change

Common Checks

Check Command/Location
Backend health GET /api/health
Local stack docker compose ps
IoT local stack docker compose -f docker-compose.iot.yml ps
VM services docker compose -f docker-compose.yml ps in the VM deploy directory
VM API logs docker compose -f docker-compose.yml logs --tail=200 <api-service-name>
K8s pods, optional kubectl get pods -n aquax-dev or aquax-prod
K8s ingress, optional kubectl get ingress -n aquax-dev or aquax-prod
API docs /api/docs

Escalation

Named escalation owners are TBD. Use project RACI until named owners are assigned.