Platform Architecture
High-level overview of the monitoring platform components, services, and deployment topology
DevelopersArchitectureUpdated 2026-03-09
Overview
The Cyviz monitoring platform (Project Green) is a distributed system for real-time monitoring, alerting, and management of AV/IT devices across enterprise installations.
Components
Edge (On-Site)
- Hub Agent — Headless .NET 8 service deployed at customer sites
- Plugin Hosts — Isolated OS processes per device-type plugin
- Local Outbox — FIFO queue for offline telemetry buffering
Cloud (Azure Kubernetes Service)
- Easy Server — Configuration, user management, multi-tenancy (REST + GraphQL API)
- Monitoring Server — Telemetry analytics, alert evaluation, historical data (GraphQL API)
- Telemetry Pipeline — Receiver + Processor for ingesting and normalizing device data
- Control Plane — Agent lifecycle management and command dispatch
- RabbitMQ — Message bus between services
- SQL Server — Persistent storage (separate DBs for Easy Server and Monitoring)
Presentation
- Project Green UI — Next.js + React web application
- GraphQL Client — Queries both Easy Server and Monitoring Server
Communication Protocols
| Protocol | Use |
|---|---|
| gRPC | Agent ↔ Cloud (push stream + polling) |
| GraphQL | Dashboard ↔ Cloud services |
| REST | Admin operations, webhook integrations |
| Telnet/Serial/TCP/Modbus | Agent ↔ Devices (local network) |
Deployment
Deployed via Helm chart (v0.13.1) to AKS. Each customer instance is isolated with dedicated databases, ingress, and TLS certificates.