Depuración de Node-RED

Esta guía proporciona procedimientos de solución de problemas exhaustivos para problemas de Node-RED en el sistema de cámaras OV80i. Úsela para reparación en campo, depurar problemas de producción y realizar mantenimiento preventivo de flujos de inspección.

aviso

Seguridad primero: Notifique siempre a producción antes de realizar cambios en los sistemas de inspección activos. Cree copias de seguridad antes de modificar los flujos.

Procedimientos de corrección rápida ante emergencias

Caída crítica del sistema: Acciones inmediatas

Paso	Acción	Tiempo	Resultados
1	Verifique el estado del LED de alimentación de la cámara	30 seg	Verificar correcto funcionamiento del hardware
2	Acceda a OV80i Node-RED: http://camera-ip/recipes/<recipe-number>/ioblock	1 min	Verifique que el editor esté accesible
3	Busque indicadores de error en triángulos rojos	1 min	Identifique los nodos que están fallando
4	Haga clic en el botón Deploy (Full Deploy)	30 seg	Restablecer todos los flujos
5	Pruebe el disparador básico de inspección	2 min	Verifique que el sistema esté operativo

Recuperación del sistema (si el editor no se carga)

Las cámaras OV80i no tienen modo seguro; reinicio es el método de recuperación principal:

1. Realice un ciclo de alimentación de la cámara (desconecte la alimentación durante 10 segundos)
2. Espere a que complete el arranque (los 4 LEDs estables - 2-3 minutos)
3. Acceda al Node-RED de la receta activa mediante la URL específica de la receta
4. Verifique la integridad del flujo y aplique las correcciones necesarias
5. Despliegue los cambios para restablecer la operación normal

nota

Formato de URL: http://<camera-ip>/recipes/<recipe-number>/ioblock

Ejemplos:

• http://192.168.0.101/recipes/20/ioblock
• http://192.168.0.105/recipes/1/ioblock

Proceso de depuración sistemática

Paso 1: Identificar el alcance del problema

Preguntas de evaluación rápida

Pregunta	Si SÍ	Si NO
¿Puede acceder a la interfaz de OV80i Node-RED?	Continuar al Paso 2	Verifique la red/estado de la cámara
¿Se ven los flujos en el editor?	Continuar al Paso 2	Realice un ciclo de alimentación de la cámara y vuelva a intentarlo
¿Ve triángulos rojos de error en los nodos?	Concentre primero en esos nodos	Verifique la ejecución del flujo
¿Se está activando la inspección?	Verifique las salidas de los nodos individuales	Verifique las entradas del disparador

nota

Acceso URL: Utilice el formato de URL específico de la receta: http://<camera-ip>/recipes/<recipe-number>/ioblock

Paso 2: Habilitar el monitoreo de depuración

Agregar nodos Debug para resolución de problemas

1. Coloque nodos Debug en puntos clave de los flujos problemáticos:
   • Después de las entradas de disparo
   • Antes y después de los nodos de lógica
   • En salidas finales
2. Configure nodos Debug para obtener la mayor cantidad de información:
   • Salida (Output): El objeto de mensaje completo
   • Destino (To): Panel lateral de Depuración
   • Nombre (Name): Nombres descriptivos (p. ej., "Después de la Lógica de Clasificación")
3. Habilite todos los nodos Debug haciendo clic en sus botones en el editor

Gestión de la barra lateral de Depuración

Acceso a la barra lateral de Depuración:

• Haga clic en la pestaña Debug (ícono de error) en el panel derecho
• Borre mensajes antiguos usando el ícono de basurero
• Filtre mensajes si hay demasiados nodos activos

Interpretación de mensajes de depuración:

• Marca de tiempo indica cuándo ocurrió el mensaje
• Nombre del nodo indica qué nodo generó el mensaje
• Contenido del mensaje muestra la estructura de datos y los valores

Paso 3: Ejecución de Flujo

Seguir la ruta del mensaje

1. Inicio desde la fuente de disparo (inyección, temporizador, entrada externa)
2. Verifique que cada nodo reciba la entrada esperada
3. Verifique las transformaciones de mensajes en cada paso
4. Identifique dónde el flujo se detiene o produce una salida incorrecta

Puntos Comunes de Interrupción del Flujo

Tipo de Nodo	Problemas Comunes	Verificación Rápida
Lógica de Clasificación	No se alcanzó el umbral de confianza	Verifique la alineación de ROI, reentrene el modelo
Nodo Switch	Lógica de condición incorrecta	Verifique las reglas del Switch y las propiedades del mensaje
Nodo Join	Esperando un conjunto de mensajes incompleto	Verifique la cantidad de partes del mensaje
Nodo Function	Errores de JavaScript	Verifique la consola del navegador para ver errores
Solicitud HTTP	Conectividad de red	Pruebe manualmente el endpoint

Problemas Comunes de Node-RED y Soluciones

Problemas de Ejecución de Flujo

Problema: El flujo no se activa

Síntomas:

• Sin mensajes en la barra lateral de Debug
• El sistema parece inactivo
• Los disparadores externos no funcionan

Pasos de diagnóstico:

1. Verifique la fuente de disparo: inyección manual, temporizador, entrada externa
2. Verifique el cableado: Asegúrese de las conexiones entre nodos
3. Prueba de disparo manual: Use el nodo Inject para forzar el inicio del flujo

Soluciones:

Causa	Solución	Prevención
Flujos deshabilitados	Haga clic en Deploy → Full Deploy	Despliegue regular después de cambios
Conexiones rotas	Vuelva a cablear los nodos correctamente	Inspección visual durante las ediciones
Mala configuración del temporizador	Verifique la configuración de temporización del nodo Inject	Documentar los requisitos de temporización
Fallo del disparador externo	Verifique el cableado y las señales de I/O	Pruebas de I/O regulares

Problema: Flujos en ejecución pero resultados incorrectos

Síntomas:

• Mensajes fluyen pero clasificaciones incorrectas
• La lógica de aprobación/rechazo no funciona correctamente
• Resultados inconsistentes

Proceso de diagnóstico:

1. Agregar nodos Debug antes y después de los nodos sospechosos
2. Comparar lo esperado frente a lo real en el contenido del mensaje
3. Verifique las configuraciones de los nodos para parámetros correctos

Soluciones:

Área del problema	Verificación	Solución
Lógica de Clasificación	Alineación de ROI, entrenamiento del modelo	Reentrenar o ajustar ROI
Condiciones del Switch	Nombres y valores de las propiedades	Lógica del Switch correcta
Propiedades del mensaje	Tipos de datos y formatos	Usar nodo Change para corregir formato
Variables de Contexto	Valores almacenados y alcance	Borrar/restablecer el almacenamiento de contexto

Problemas de Rendimiento

Problema: Ejecución de Flujo Lenta

Síntomas:

• Retrasos entre el disparo y la salida
• Time-outs de inspección
• Lentitud del sistema

Diagnóstico de Rendimiento:

1. Verifique las marcas de tiempo de Debug para identificar nodos lentos
2. Monitorear el uso de CPU en el sistema de la cámara
3. Contar nodos Debug activos (deshabilite los nodos Debug no utilizados)

Acciones de Optimización:

Problema de Rendimiento	Solución	Mejora Esperada
Demasiados nodos Debug	Deshabilitar/eliminar nodos Debug no utilizados	Incremento de 10-20%
Nodos Function complejos	Optimizar el código JavaScript	Mejora variable
Disparos de alta frecuencia	Añadir retardo / limitación de tasa	Prevenir sobrecarga del sistema
Objetos de mensaje grandes	Reducir el tamaño de la carga útil del mensaje	Procesamiento más rápido

Procedimientos de Mantenimiento

Verificaciones de Salud Diarias

Inspección Visual del Flujo (5 minutos)

1. Acceda al editor de Node-RED
2. Verifique indicadores de error (triángulos rojos)
3. Verifique que las conexiones del flujo estén intactas
4. Revise los mensajes de Debug recientes para detectar anomalías

Prueba de Ejecución del Flujo (10 minutos)

1. Prueba de disparo manual usando nodos Inject
2. Verifique las salidas esperadas en el Debug sidebar
3. Pruebe la lógica de pase/fallo con piezas buenas/malas conocidas
4. Confirme las comunicaciones externas (PLC, bases de datos)

Tareas de Mantenimiento Mensual

Revisión de Desempeño (15 minutos)

Checklist de Optimización de Flujo:

Tarea	Acción	Notas
Debug Node Cleanup	Desactivar nodos Debug no utilizados	Mantener solo el depurado esencial
Context Storage Review	Eliminar valores almacenados innecesarios	Prevenir la acumulación de memoria
Error Log Review	Verificar la consola del navegador para errores	Documentar problemas recurrentes
Backup Creation	Exportar flujos a un archivo de respaldo	Almacenar con información de fecha/versión

Validación de Configuración (20 minutos)

1. Comparar los flujos actuales con estándares documentados
2. Verificar que todos los caminos críticos tengan manejo de errores adecuado
3. Probar escenarios de recuperación ante errores
4. Actualizar la documentación para cualquier cambio

Mantenimiento Profundo Mensual

Análisis Exhaustivo del Flujo (45 minutos)

Recolección de Métricas de Rendimiento:

• Tiempos de ejecución del flujo
• Análisis de la frecuencia de errores
• Patrones de uso de recursos
• Fiabilidad de la comunicación

Revisión de la Estructura del Flujo:

• Eliminar nodos redundantes
• Consolidar lógica duplicada
• Actualizar configuraciones obsoletas
• Optimizar nodos Function complejos

Pruebas de Respaldo y Recuperación (30 minutos)

1. Crear exportación completa del flujo
2. Probar el procedimiento de importación en el sistema de respaldo
3. Verificar que la restauración de la copia de seguridad mantiene la funcionalidad
4. Documentar procedimientos de recuperación

Herramientas y Técnicas de Diagnóstico

Herramientas integradas de Node-RED

Debug Sidebar Features

Feature	Use Case	Access Method
Message Filtering	Enfocarse en nodos específicos	Botón de filtro en la barra lateral
Message History	Revisar los últimos 100 mensajes	Desplazarse en Debug sidebar
Node Location	Encontrar la fuente del mensaje de Debug	Haga clic en el nombre del nodo en el mensaje
Message Export	Guardar datos de diagnóstico	Copiar contenido del mensaje

Context Data Explorer

Acceda al Context Storage:

• Abrir la interfaz de Node-RED de OV80i (http://<camera-ip>/recipes/<recipe-number>/ioblock)
• Ir a la pestaña Context Data (barra lateral derecha)
• Ver valores de contexto de Node/Flow/Global

Depuración de Contexto:

• Node Context: Verificar el estado de un nodo individual
• Flow Context: Verificar variables de flujo compartidas
• Global Context: Revisar configuraciones a nivel del sistema

Pruebas de Comunicación de Red

HTTP Request Validation:

1. Utilice herramientas externas (Postman, curl) para probar los endpoints
2. Verifique que los formatos de respuesta coincidan con los datos esperados
3. Probar condiciones de error (tiempos de espera, respuestas inválidas)

PLC Communication Verification:

1. Utilice software de programación de PLC para verificar la conectividad
2. Probar el acceso a registros de datos de forma independiente
3. Validar conversiones de formatos de datos

Procedimientos de Recuperación ante Emergencias

Recuperación ante Corrupción de Flujo

Síntomas de la Corrupción:

• La interfaz de Node-RED de OV80i no carga los flujos
• Los flujos aparecen vacíos tras reiniciar la cámara
• La implementación falla repetidamente

Pasos de Recuperación:

1. Realizar un ciclo de alimentación de la cámara OV80i:
   • Desconecte la alimentación durante 10 segundos
   • Espere a que complete el arranque (los 4 LEDs estén estables)
2. Acceder a la interfaz Node-RED de la receta:
   • Navegue a http://<camera-ip>/recipes/<recipe-number>/ioblock
   • Si los flujos están corruptos, importe desde la copia de seguridad
3. Restaurar desde la copia de seguridad:
   • Utilice la función de importación de recetas de OV80i
   • Importe el archivo de copia de seguridad más reciente
   • Verifique que todas las conexiones estén intactas
4. Validar la restauración:
   • Probar todos los flujos críticos
   • Verificar las comunicaciones externas
   • Actualizar cualquier cambio de configuración

Problemas de Recursos del Sistema

Sobrecarga de Memoria/CPU

Acciones Inmediatas:

1. Deshabilite nodos Debug no esenciales en OV80i Node-RED.
2. Eliminar disparadores de temporizador de alta frecuencia
3. Simplifique nodos Function complejos
4. Realizar un ciclo de alimentación de la cámara para reiniciar todos los servicios

Soluciones a Largo Plazo:

• Optimizar el diseño de flujos para el hardware OV80i
• Implementar limitación de tasa
• Reducir el tamaño de las cargas de mensajes
• Programar ventanas de mantenimiento

Listas de Verificación de Solución de Problemas

Lista de Verificación Pre-Mantenimiento

• Notificar a la producción de la ventana de mantenimiento
• Crear copia de seguridad del flujo actual
• Documentar el estado actual del sistema
• Preparar el procedimiento de reversión
• Probar el proceso de restauración de copias de seguridad

Validación Post-Mantenimiento

• Todos los flujos se implementan con éxito
• Las pruebas de disparo manual pasan
• Comunicaciones externas verificadas
• Indicadores de error eliminados
• Rendimiento dentro del rango aceptable
• Documentación actualizada

Lista de Verificación de Respuesta ante Emergencias

• Impacto del sistema evaluado
• Producción notificada
• Intento de solución rápida
• Restauración de copias de seguridad si es necesario
• Causa raíz identificada
• Medidas preventivas implementadas

Documentación y Registro

Registros de Mantenimiento

Documentación Requerida:

• Fecha/hora del mantenimiento
• Problemas identificados y resueltos
• Cambios de configuración realizados
• Mejoras de rendimiento logradas
• Recomendaciones futuras

🔗 Véase También

• Fundamentos de Node-RED
• Crear tu Primera Receta
• Arquitectura de Comunicación de la Cámara
• Solución de Problemas de Energía
• Arquitectura de Node-RED en OV80i

---

tip

Documente todos los cambios realizados durante las sesiones de depuración. Esto ayuda con la solución de problemas futuras y genera conocimiento institucional para su equipo.