docs/runbooks/logging.md
App logs go to /tmp/flutter-run.log. Use print() (not Logger.debug) for logs that must appear there. Grep with [TagName] prefixes:
grep -E "\[AgentChat\]|\[HomePage\]" /tmp/flutter-run.log | tail -20
gcloud logging read 'resource.type="cloud_run_revision" AND resource.labels.service_name="backend-listen"' --project=based-hardware --limit=30 --freshness=5m --format=json
prod-omi-backend)kubectl logs -n prod-omi-backend -l app=agent-proxy --timestamps --since=10m | grep "<uid>"
gcloud compute ssh omi-agent-<id> --zone=us-central1-a --project=based-hardware \
--command="journalctl -u omi-agent --no-pager --since '10 minutes ago' | grep -E 'Client|Query|Prewarm|session|disconnect|error|Persistent'"
For end-to-end debugging of the mobile agent chat pipeline (phone → agent-proxy → VM), see the ai-chat-debug skill.