geointel/docs/OBSERVABILITY_PLAN.md

Observability Plan

Doel

GeoIntel moet tijdens lange AI/GIS-jobs duidelijk tonen wat er gebeurt.

Logcategorieën

• Application logs: API requests, validatiefouten, service lifecycle.
• Geospatial logs: raster metadata, CRS-detectie, clip/reproject/tiling, geometrievalidatie.
• AI logs: model load, tile inference, merge, polygonization, filtering.
• Job logs: queued, started, progress, completed, failed.

Correlation IDs

Elke job en API-call die een job start krijgt een correlation_id.

Minimale job events

queued, started, metadata_extracted, preprocessing_completed, inference_started, inference_completed, postprocessing_completed, persisted, completed, failed.

Frontend observability

De UI toont status, progress, laatste logregel, link naar details en foutmelding met herstelactie.