# Observability with LGTM on Compose

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

Containerized TraderX runtime (state 006) with an LGTM observability layer for local learning.

*   Generated from: `system/architecture.model.json`
*   Canonical flows: `system/end-to-end-flows.md`

## Architecture Diagram

Diagram source

```mermaid
flowchart LR
  developer["Developer"]
  app_runtime["TraderX App Runtime (State 006)"]
  obs_runtime["Observability Runtime"]
  ingress["NGINX Ingress"]
  core_services["Core Services"]
  prometheus["Prometheus"]
  blackbox["Blackbox Exporter"]
  loki["Loki"]
  promtail["Promtail"]
  tempo["Tempo"]
  otel["OpenTelemetry Collector"]
  grafana["Grafana"]
  developer -->|"Uses TraderX"| ingress
  ingress -->|"Routes API/UI traffic"| core_services
  blackbox -->|"HTTP probes"| core_services
  prometheus -->|"Scrapes probe metrics"| blackbox
  promtail -->|"Ships logs"| loki
  otel -->|"Exports traces"| tempo
  developer -->|"Views observability dashboards"| grafana
  grafana -->|"Queries metrics"| prometheus
  grafana -->|"Queries logs"| loki
  grafana -->|"Queries traces"| tempo
```

## Node Catalog

| Node | Kind | Label | Notes |
| --- | --- | --- | --- |
| `developer` | actor | Developer | Local developer using this state. |
| `app_runtime` | boundary | TraderX App Runtime (State 006) | Baseline containerized TraderX services. |
| `obs_runtime` | boundary | Observability Runtime | LGTM + OTel stack for metrics/logs/traces. |
| `ingress` | service | NGINX Ingress | Edge entrypoint for UI and service proxy. |
| `core_services` | service | Core Services | Account, position, trade, processor, people, reference-data, nats-broker, database, UI. |
| `prometheus` | service | Prometheus | Scrapes probe and collector metrics. |
| `blackbox` | service | Blackbox Exporter | HTTP probe exporter for service availability/latency. |
| `loki` | service | Loki | Log aggregation backend. |
| `promtail` | service | Promtail | Docker log collector to Loki. |
| `tempo` | service | Tempo | Trace backend. |
| `otel` | service | OpenTelemetry Collector | OTLP ingest and telemetry routing. |
| `grafana` | service | Grafana | Unified dashboards for metrics, logs, traces. |