geointel/docs/18-ultra-prep/OBSERVABILITY_PLAN.md

Observability Plan

Required Logs

• request start/end with trace id;
• dataset upload registration;
• metadata extraction status;
• job lifecycle transitions;
• model adapter selection;
• inference start/end;
• QA/QC matching summary;
• export creation.

Required Health Checks

• API health;
• database connection;
• PostGIS extension availability;
• storage write check;
• optional Redis check;
• optional model registry check.

Diagnostics Endpoint

GET /system/diagnostics

Should return safe non-secret status:

{
  "api": "ok",
  "database": "ok",
  "postgis": "ok",
  "storage": "ok",
  "redis": "unconfigured",
  "models": "unconfigured"
}