# Runtime Topology: 007-observability-lgtm-compose

> For the complete documentation index, see [llms.txt](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/llms.txt).

Parent state: `006-messaging-nats-replacement`

Describe runtime topology and network/data flow changes introduced by this state.

## Entrypoints

*   App ingress: `http://localhost:8080`
*   Grafana: `http://localhost:3001`
*   Grafana through ingress: `http://localhost:8080/grafana/`
*   Prometheus: `http://localhost:9090`
*   Loki: `http://localhost:3100`
*   Tempo: `http://localhost:3200`
*   OTel Collector health: `http://localhost:13133`

## Components

*   Baseline application components from state `006`.
*   Added observability components:
    *   `grafana`
    *   `prometheus`
    *   `loki`
    *   `tempo`
    *   `otel-collector`
    *   `blackbox-exporter`
    *   `promtail`

## Networking

*   Prometheus probes application endpoints through the compose network via blackbox exporter.
*   Prometheus also scrapes Spring Boot actuator metrics (`/actuator/prometheus`) for all compatible services in this state.
*   Promtail discovers Docker containers and pushes logs to Loki.
*   Promtail receives `TRADERX_PROMTAIL_DOCKER_API_VERSION` from the generated runtime harness; by default the harness detects the local Docker daemon API version.
*   Grafana queries Prometheus, Loki, and Tempo datasources.
*   Grafana ingress runs from `/grafana/` with anonymous Viewer access enabled and non-`admin/admin` state-scoped administrator defaults.
*   OTel Collector exposes OTLP receivers for future app instrumentation.

## Startup / Health Order

1.  Start baseline app services from state `006`.
2.  Start observability backends (`loki`, `tempo`, `otel-collector`, `blackbox-exporter`, `prometheus`).
3.  Start Grafana after datasources are reachable.
4.  Validate baseline app flow and observability endpoint health.