Runbooks

Login failures

Symptoms

• Errors while logging into EzyVet or downloading reports.

Checks

1. Verify {IDENTIFIER}_EZYVET_EMAIL and {IDENTIFIER}_EZYVET_PASSWORD secrets.
2. Confirm the clinic ezvet_base_url value in Spanner.
3. Inspect Playwright logs for timeout or auth errors.

Proxy failures

Symptoms

• Browser launch failures or network errors to EzyVet.

Checks

1. Verify EZYVET_PROXY_* secrets are present.
2. Confirm proxy endpoint reachability.

Spanner write errors

Symptoms

• Insert failures or schema errors during upsert.

Checks

1. Verify service account Spanner permissions.
2. Confirm Spanner schema compatibility with the transform output.

Missing clinic data

Symptoms

• Job logs indicate clinic not found or skipped.

Checks

1. Confirm clinic exists in Clinics and is marked scrape = true.
2. Ensure CLINIC_IDS list contains the clinic id.