How mryria/iot-telemetry-engine works
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 Compose services · detector-telemetry.cpp Detector receiver · generator-telemetry.cpp Telemetry generator · init.sql Anomaly schema
Components 15
Telemetry simulation
- Telemetry generator
code/generator-telemetry.cpp - Machine simulation
code/generator-telemetry.cpp - UDP datagrams
Detection and persistence
- Detector receiver
code/detector-telemetry.cpp - Anomaly rules
code/detector-telemetry.cpp - Anomaly queue
code/detector-telemetry.cpp - Batch DB writer
code/detector-telemetry.cpp
Storage and analytics
- PostgreSQL
- Anomaly schema
postgres/init.sql - Grafana dashboard
- Analytics query 1
postgres/grafana sql queries/q1.sql - Analytics query 2
postgres/grafana sql queries/q2.sql - Analytics query 3
postgres/grafana sql queries/q3.sql
Service deployment
- Compose services
docker-compose.yml
Other components
- Operator
Connections 18
- Operator → Compose services: launches
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
code/generator-telemetry.cpp - Telemetry generator → UDP datagrams: sends packets
code/generator-telemetry.cpp - UDP datagrams → Detector receiver: delivers packets
readme.md - Detector receiver → Anomaly rules: checks readings
code/detector-telemetry.cpp - Detector receiver → Anomaly queue: enqueues anomalies
code/detector-telemetry.cpp - Batch DB writer → Anomaly queue: drains batches
code/detector-telemetry.cpp - Batch DB writer → PostgreSQL: inserts batches
code/detector-telemetry.cpp - Anomaly schema → PostgreSQL: defines schema
- Grafana dashboard → PostgreSQL: queries data
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
readme.md