Skip to content

Data Plane and Message Broker

Jump to bottom
GiZano edited this page Aug 5, 2026 · 2 revisions

Data Plane & Message Broker (MQTT)

With v1.1.0, QuakeGuard migrated its Data Plane from HTTP/local MQTT to a robust cloud infrastructure.

HiveMQ Cloud Infrastructure

  • Encrypted Transport: Telemetry is transmitted over port 8883 using strict TLS.
  • Authentication: Requires explicit MQTT_USERNAME and MQTT_PASSWORD.
  • Topic Topology: Anomalies are published to quakeguard/telemetry.

Internal MQTT Bridge Service

The backend securely ingests data via mqtt_subscriber.py.

  • Uses paho.mqtt.client with secure TLS settings (client.tls_set).
  • Forwards payloads to the internal FastAPI ingestion endpoint (/readings/) via HTTP POST.
  • Injects the X-API-Key header, acting as a trusted proxy.

Clone this wiki locally