Skip to content

Observability

The platform provides comprehensive observability through logging, metrics, tracing, and monitoring.

Logging

Structured Logging:

  • All components emit structured logs (JSON)
  • Correlation IDs trace requests across services
  • Log levels: Trace, Debug, Info, Warning, Error, Critical

Sinks:

  • Console (local development)
  • Elasticsearch (production)
  • Azure Application Insights (optional)

Metrics

Elastic APM tracks:

  • API request duration and throughput
  • Database query performance
  • Function execution times
  • Error rates

Tracing

OpenTelemetry provides distributed tracing:

  • End-to-end request tracing (client > API > DB > Function)
  • Dependency mapping
  • Bottleneck identification

Monitoring

Health Checks:

  • API readiness and liveness endpoints
  • Database connectivity checks
  • Elasticsearch cluster health
  • Service Bus connection status

Alerts (planned):

  • Gateway offline > 5 minutes
  • High error rates
  • Database connection failures
  • Telemetry ingestion backlog