Skip to main content

State 007: Observability Baseline with LGTM

State 007-observability-lgtm-compose adds a reusable observability baseline on top of the architecture chain (005 PostgreSQL + 006 NATS).

The goal was to make diagnostics first-class without changing business behavior. We wanted consistent local visibility across logs, metrics, traces, and service health for every generated runtime that inherits this state.

What Was Added​

  • LGTM stack in compose runtime: Grafana, Loki, Tempo, Prometheus.
  • OpenTelemetry collector wiring for cross-service telemetry flow.
  • Baseline probes and health checks for observability services.
  • Default dashboards and smoke checks so observability is verifiable, not aspirational.

Why This Matters​

  • Functional states can now be developed with immediate telemetry feedback.
  • Regressions are easier to detect and isolate across services.
  • Later states (008, 009, and convergence states) inherit the same baseline by default.

Decision Record​

The state-scoped rationale is captured in:

Spec + Code Links​