┌─────────────┐     ┌─────────────────────────────────────┐     ┌─────────────┐
│  Collector  │────▶│  Aggregator + Gateway + Redis + TS  │────▶│    Edge     │────▶ Browser
│   (mcrn)    │gRPC │            (LOCAL)                  │ WS  │   (AWS)     │ WS
└─────────────┘     └─────────────────────────────────────┘     └─────────────┘
┌─────────────┐                    │
│  Collector  │────────────────────┘
│   (nfrt)    │gRPC
└─────────────┘

Collectors use gRPC to stream metrics to the local aggregator
Gateway forwards to edge via WebSocket (if EDGE_URL configured)
Edge (AWS) relays to browsers via WebSocket

Directory Structure

ctrl/
├── dev/          # Full stack for local development (docker-compose)
└── edge/         # Cloud dashboard for AWS deployment

Local Development

# From repo root
docker compose up

Runs: aggregator, gateway, collector, alerts, redis, timescaledb

Production Deployment

1. Deploy Edge to AWS

cd ctrl/edge
docker compose up -d

2. Run Full Stack Locally with Edge Forwarding

EDGE_URL=wss://sysmonstm.mcrn.ar/ws EDGE_API_KEY=xxx docker compose up

3. Run Collectors on Other Machines

docker run -d --name sysmonstm-collector --network host \
  -e AGGREGATOR_URL=<local-gateway-ip>:50051 \
  -e MACHINE_ID=$(hostname) \
  registry.mcrn.ar/sysmonstm/collector:latest

Environment Variables

Gateway (for edge forwarding)

EDGE_URL - WebSocket URL of edge (e.g., wss://sysmonstm.mcrn.ar/ws)
EDGE_API_KEY - Authentication key for edge

Edge

API_KEY - Key required from gateway

Collector

AGGREGATOR_URL - gRPC URL of aggregator (e.g., localhost:50051)
MACHINE_ID - Identifier for this machine