# mryria/iot-telemetry-engine architecture

> Architecture diagram of the GitHub repository mryria/iot-telemetry-engine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mryria/iot-telemetry-engine
- Repository: https://github.com/mryria/iot-telemetry-engine

## Overview

This repository is a Dockerized IoT telemetry simulator and anomaly-detection service. Its main workflow simulates machine readings, sends binary UDP packets to a detector, checks thresholds, queues detected anomalies for batched PostgreSQL writes, and presents database-backed monitoring in Grafana. The sampled C++ shows the generator and detector internals; schema, dashboard wiring, and service configuration are represented from the README and tree, so those links are documented rather than source-verified.

Main entry points: [`docker-compose.yml`](https://github.com/mryria/iot-telemetry-engine/blob/main/docker-compose.yml) (Compose services), [`code/detector-telemetry.cpp`](https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp) (Detector receiver), [`code/generator-telemetry.cpp`](https://github.com/mryria/iot-telemetry-engine/blob/main/code/generator-telemetry.cpp) (Telemetry generator), [`postgres/init.sql`](https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/init.sql) (Anomaly schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Telemetry simulation"]
  node_generator["Telemetry generator"]
  node_machine_state["Machine simulation"]
  node_udp["UDP datagrams"]
end

subgraph group_detection["Detection and persistence"]
  node_detector["Detector receiver"]
  node_thresholds["Anomaly rules"]
  node_anomaly_queue["Anomaly queue"]
  node_writer["Batch DB writer"]
end

subgraph group_data["Storage and analytics"]
  node_postgres[("PostgreSQL")]
  node_schema["Anomaly schema<br/>[init.sql]"]
  node_grafana["Grafana dashboard"]
  node_query1["Analytics query 1<br/>[q1.sql]"]
  node_query2["Analytics query 2<br/>[q2.sql]"]
  node_query3["Analytics query 3<br/>[q3.sql]"]
end

subgraph group_operations["Service deployment"]
  node_compose["Compose services<br/>[docker-compose.yml]"]
end

node_operator(("Operator"))

node_operator -->|"launches"| node_compose
node_compose -.->|"runs"| node_generator
node_compose -.->|"runs"| node_detector
node_compose -.->|"runs"| node_postgres
node_compose -.->|"runs"| node_grafana
node_generator -->|"generates from"| node_machine_state
node_generator -->|"sends packets"| node_udp
node_udp -->|"delivers packets"| node_detector
node_detector -->|"checks readings"| node_thresholds
node_detector -->|"enqueues anomalies"| node_anomaly_queue
node_writer -->|"drains batches"| node_anomaly_queue
node_writer -->|"inserts batches"| node_postgres
node_schema -.->|"defines schema"| node_postgres
node_grafana -.->|"queries data"| node_postgres
node_grafana -.->|"uses query"| node_query1
node_grafana -.->|"uses query"| node_query2
node_grafana -.->|"uses query"| node_query3
node_operator -->|"views dashboard"| node_grafana

click node_generator "https://github.com/mryria/iot-telemetry-engine/blob/main/code/generator-telemetry.cpp"
click node_machine_state "https://github.com/mryria/iot-telemetry-engine/blob/main/code/generator-telemetry.cpp"
click node_detector "https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp"
click node_thresholds "https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp"
click node_anomaly_queue "https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp"
click node_writer "https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp"
click node_schema "https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/init.sql"
click node_query1 "https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/grafana%20sql%20queries/q1.sql"
click node_query2 "https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/grafana%20sql%20queries/q2.sql"
click node_query3 "https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/grafana%20sql%20queries/q3.sql"
click node_compose "https://github.com/mryria/iot-telemetry-engine/blob/main/docker-compose.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_generator,node_machine_state,node_udp toneBlue
class node_detector,node_thresholds,node_anomaly_queue,node_writer toneAmber
class node_postgres,node_schema,node_grafana,node_query1,node_query2,node_query3 toneMint
class node_compose toneRose
class node_operator toneIndigo
```

## Components

### Telemetry simulation

- [Telemetry generator](https://github.com/mryria/iot-telemetry-engine/blob/main/code/generator-telemetry.cpp): `code/generator-telemetry.cpp`
- [Machine simulation](https://github.com/mryria/iot-telemetry-engine/blob/main/code/generator-telemetry.cpp): `code/generator-telemetry.cpp`
- **UDP datagrams**

### Detection and persistence

- [Detector receiver](https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp): `code/detector-telemetry.cpp`
- [Anomaly rules](https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp): `code/detector-telemetry.cpp`
- [Anomaly queue](https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp): `code/detector-telemetry.cpp`
- [Batch DB writer](https://github.com/mryria/iot-telemetry-engine/blob/main/code/detector-telemetry.cpp): `code/detector-telemetry.cpp`

### Storage and analytics

- **PostgreSQL**
- [Anomaly schema](https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/init.sql): `postgres/init.sql`
- **Grafana dashboard**
- [Analytics query 1](https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/grafana%20sql%20queries/q1.sql): `postgres/grafana sql queries/q1.sql`
- [Analytics query 2](https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/grafana%20sql%20queries/q2.sql): `postgres/grafana sql queries/q2.sql`
- [Analytics query 3](https://github.com/mryria/iot-telemetry-engine/blob/main/postgres/grafana%20sql%20queries/q3.sql): `postgres/grafana sql queries/q3.sql`

### Service deployment

- [Compose services](https://github.com/mryria/iot-telemetry-engine/blob/main/docker-compose.yml): `docker-compose.yml`

### Other components

- **Operator**

## Connections

- Operator → Compose services: launches (evidence: `readme.md`)
- Compose services → Telemetry generator: runs
- Compose services → Detector receiver: runs
- Compose services → PostgreSQL: runs
- Compose services → Grafana dashboard: runs
- Telemetry generator → Machine simulation: generates from (evidence: `code/generator-telemetry.cpp`)
- Telemetry generator → UDP datagrams: sends packets (evidence: `code/generator-telemetry.cpp`)
- UDP datagrams → Detector receiver: delivers packets (evidence: `readme.md`)
- Detector receiver → Anomaly rules: checks readings (evidence: `code/detector-telemetry.cpp`)
- Detector receiver → Anomaly queue: enqueues anomalies (evidence: `code/detector-telemetry.cpp`)
- Batch DB writer → Anomaly queue: drains batches (evidence: `code/detector-telemetry.cpp`)
- Batch DB writer → PostgreSQL: inserts batches (evidence: `code/detector-telemetry.cpp`)
- Anomaly schema → PostgreSQL: defines schema
- Grafana dashboard → PostgreSQL: queries data (evidence: `readme.md`)
- Grafana dashboard → Analytics query 1: uses query
- Grafana dashboard → Analytics query 2: uses query
- Grafana dashboard → Analytics query 3: uses query
- Operator → Grafana dashboard: views dashboard (evidence: `readme.md`)
