ArquitecturaEntradas de datos
Entradas de datos
Todas las formas en que llegan datos a INDUXA, de un vistazo.
Todo lo que llega a INDUXA termina en el mismo flujo: Kafka → normalizador → base de datos (ver Flujo de datos). Lo que cambia es por dónde entra y cómo se autentica.
| Entrada | Protocolo | Autenticación | Qué trae | Frecuencia |
|---|---|---|---|---|
| MQTT de equipos | MQTT sobre TLS (8883) | Usuario y contraseña por equipo | Lecturas, posiciones, eventos, confirmación de comandos | Lo que mande el equipo |
| Ingesta HTTPS | HTTPS (443) | Credencial del equipo (Basic) | Lecturas y posiciones, uno o en lote de hasta 1000 | Lo que mande el sistema |
| Gateway Agro | LoRa 433 MHz → MQTT | Clave por nodo + credencial del gateway | Trampas UV-A, láser, estaciones, fotos y video | Cada nodo; telemetría del gateway cada 5 min |
| Gateway industrial | Modbus TCP/RTU y OPC UA → MQTT | Credencial del gateway | Tags de PLC, medidores y variadores | Cada 1 s o más, por fuente |
| Agente Desk | MQTT + HTTPS | Código de alta y credencial por PC | Salud, inventario, actividad, USB, mesa de ayuda | Salud cada 5 min; inventario diario |
| John Deere | API de John Deere (OAuth 2.0) | Cuenta de Operations Center de la empresa | Horómetro, combustible, horas de motor, posición | Cada hora o «Traer ahora» |
| WebSCADA | HTTPS en lotes | Credencial del registrador | Registradores de datos de redes de agua | Con unas horas de atraso |
| App Agro Campo | HTTPS (API) | Correo y código de 6 números | Parcelas, fotos de plantas, preguntas, labores | Cuando el agricultor lo usa |
| Otras | MQTT o HTTPS | Credencial del equipo | GPS, Node-RED, Ignition, n8n, sistemas propios, cálculos internos | Variable |
Reglas comunes
- Cada equipo tiene su credencial. Nadie publica a nombre de otro, salvo un gateway por sus propios nodos o fuentes PLC.
- Un solo contrato de mensaje (versión 1) para lecturas, por MQTT o por HTTPS.
- Tags automáticos: cada clave nueva aparece como tag «por confirmar» y sus datos se guardan desde el inicio.
- Sin pérdidas: gateways, agente y app guardan en cola cuando no hay señal y envían al volver la red.
- Archivos aparte: fotos y capturas van directo al almacén con un enlace firmado, nunca dentro del mensaje.
- Solo lectura en planta: el gateway industrial no escribe en los PLC.