Skip to content

Ingestor Service

The Ingestor is a dedicated Go service that handles high-volume telemetry uploads from Edge appliances. It is intentionally separate from the Cloud Backend API to allow independent scaling of the ingestion pipeline.

Purpose

Edge appliances collect continuous telemetry (network traffic, logs, security events, discovery data, backup events) and batch-upload it to the Ingestor. The Ingestor validates, authenticates, and persists the data to Azure SQL.

Tech stack

Component	Technology
Language	Go
Database	Azure SQL Server (same RLS mechanism as Cloud)
Deployment	Azure App Service
Production URL	`https://ingest.cloud.monozu.io`

Single endpoint

The entire Ingestor surface is one endpoint:

POST /v1/ingest
X-Device-Key: <device_key>
Content-Type: application/json

[
  { "kind": "telemetry", ... },
  { "kind": "log", ... },
  { "kind": "security_alert", ... }
]

Authentication: X-Device-Key header contains the device-specific key assigned during device registration on the Cloud Backend (POST /api/v1/devices/register).