# 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:
```json
{
  "api": "ok",
  "database": "ok",
  "postgis": "ok",
  "storage": "ok",
  "redis": "unconfigured",
  "models": "unconfigured"
}
```