Edge Gateway

Registro de gateways, gestion de flota, heartbeat, asignacion de fuentes, firmware y modo offline.

¿Qué es un edge gateway?

Un edge gateway es un dispositivo físico que se instala en tu planta para conectar tus sensores y PLCs con la plataforma Rela AI. Funciona como un puente: recopila datos de tus equipos usando protocolos industriales (Modbus, OPC-UA, MQTT) y los envía a la nube. Si pierde conexión a internet, almacena datos localmente hasta que se restablezca la comunicación.

Registrar un Gateway

Los edge gateways conectan dispositivos de campo con la plataforma. Se registran via POST /api/v1/integrations/gateways:

{
  "name": "Gateway Planta Norte",
  "model": "RG-2000",
  "firmware_version": "3.1.0",
  "location": { "building": "A", "floor": 2, "zone": "production" },
  "protocols": ["modbus", "opcua", "mqtt"]
}

Al registrarse, el gateway recibe un gateway_id y un token de autenticacion unico para comunicarse con la API.

Gestion de Flota

La vista de flota muestra todos los gateways del tenant con su estado:

Estado	Descripcion
`online`	Heartbeat recibido en los ultimos 5 min
`degraded`	Heartbeat recibido hace 5-15 min
`offline`	Sin heartbeat por mas de 15 min
`provisioning`	Registrado pero sin primer heartbeat

Consulta la flota via GET /api/v1/integrations/gateways?status=online&skip=0&limit=50.

Heartbeat

Cada gateway envia un heartbeat periodico con metricas del sistema:

POST /api/v1/integrations/gateways/{gateway_id}/heartbeat
{
  "cpu_usage": 45.2,
  "memory_usage": 62.8,
  "disk_usage": 31.5,
  "uptime_seconds": 864000,
  "active_connections": 12,
  "firmware_version": "3.1.0"
}

El heartbeat se espera cada 60 segundos. Si no se recibe en 5 minutos, el gateway pasa a estado degraded. Tras 15 minutos, pasa a offline.

Un gateway offline por mas de 24 horas genera una alerta critica al equipo de operaciones.

Asignacion de Fuentes de Datos

Los gateways se asocian a fuentes de datos (sensores, PLCs, medidores):

POST /api/v1/integrations/gateways/{gateway_id}/sources
{
  "source_id": "sensor_temp_001",
  "protocol": "modbus",
  "address": "40001",
  "poll_interval_seconds": 30,
  "data_type": "float32"
}

Campo	Descripcion
`source_id`	Identificador unico de la fuente
`protocol`	Protocolo de comunicacion
`address`	Direccion del registro o topico
`poll_interval_seconds`	Intervalo de lectura en segundos
`data_type`	Tipo de dato esperado

Un gateway puede tener hasta 500 fuentes asignadas segun el plan.

Actualizacion de Firmware

Las actualizaciones de firmware se despliegan de forma controlada:

POST /api/v1/integrations/gateways/{gateway_id}/firmware
{
  "target_version": "3.2.0",
  "schedule": "2026-04-01T02:00:00Z",
  "rollback_on_failure": true
}

El proceso:

Se valida la compatibilidad de la version objetivo
Se programa la actualizacion en la ventana indicada
El gateway descarga el firmware y lo verifica (checksum SHA-256)
Se aplica la actualizacion y el gateway reinicia
Se verifica el heartbeat post-actualizacion

Si el heartbeat no llega en 10 minutos tras la actualizacion y rollback_on_failure esta activo, se revierte automaticamente a la version anterior.

Modo Offline

Los gateways almacenan datos localmente cuando pierden conexion:

Buffer local — Hasta 72 horas de datos en almacenamiento interno
Sincronizacion — Al recuperar conexion, los datos se envian en orden cronologico
Deduplicacion — El servidor descarta datos duplicados por timestamp + source_id
Compresion — Los datos en buffer se comprimen para maximizar la capacidad

El estado de sincronizacion se muestra en el dashboard de flota.