Edge Gateway

¿Para qué sirve?

• Gestionar una flota de edge gateways que Rela usa como puente a redes industriales aisladas.
• Monitorear el heartbeat de cada gateway para detectar un gateway caído antes que se pierdan datos.
• Hacer registro, revocación y rotación de claves del gateway desde el dashboard.

¿Cómo funciona?

Un edge gateway es un dispositivo que Rela registra con una clave única. El gateway envía heartbeat cada ~60 s con estado y métricas. Si el heartbeat se pierde por más de 5 minutos, el gateway queda marcado como offline y Rela notifica al administrador. La revocación de clave bloquea el gateway instantáneamente.

¿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 autenticación único para comunicarse con la API.

Gestión de Flota

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

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

Heartbeat

Cada gateway envia un heartbeat periódico 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.

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"
}

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:

1. Se valida la compatibilidad de la version objetivo
2. Se programa la actualizacion en la ventana indicada
3. El gateway descarga el firmware y lo verifica (checksum SHA-256)
4. Se aplica la actualizacion y el gateway reinicia
5. 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 automáticamente 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.

Beneficios clave

• Flota de gateways gestionable desde el dashboard, sin SSH a cada uno.
• Heartbeat automático detecta gateways caídos en minutos.
• Revocación instantánea de credenciales si un gateway fue comprometido.
• Métricas per-gateway (mensajes enviados, uptime, versión de firmware).
• Mismo modelo para 1 gateway o 1000 — escala horizontalmente.