Depuración de Node-RED

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

aviso

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

Procedimientos de solución rápida ante emergencias

Sistema crítico caído: acciones inmediatas

Paso	Acción	Tiempo	Resultado
1	Verificar el estado del LED de alimentación de la cámara	30 s	Verificar que el hardware está OK
2	Acceda a OV10i Node-RED: http://camera-ip/recipes/<recipe-number>/ioblock	1 min	Confirmar que el editor es accesible
3	Busque indicadores de error en triángulos rojos	1 min	Identificar nodos fallidos
4	Haga clic en el botón Deploy (Despliegue completo)	30 seg	Reiniciar todos los flujos
5	Pruebe el disparador de inspección básico	2 min	Verificar que el sistema está operativo

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

Las cámaras OV10i no disponen de modo seguro; reiniciar es el método principal de recuperación:

1. Ciclo de alimentación de la cámara (desconecte la alimentación durante 10 segundos)
2. Espere el arranque completo (los 4 LEDs estables - 2-3 minutos)
3. Acceda a Node-RED de la receta activa mediante la URL específica de la receta
4. Verifique la integridad del flujo y realice los arreglos necesarios
5. Despliegue los cambios para restaurar 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 OV10i Node-RED?	Continuar al Paso 2	Verifique la red/estado de la cámara
¿Los flujos se pueden ver en el editor?	Continuar al Paso 2	Reinicie la cámara y vuelva a intentarlo
¿Ve triángulos rojos de error en los nodos?	Concéntrese primero en esos nodos	Verifique la ejecución del flujo
¿Se dispara la inspección?	Verifique las salidas de los nodos individuales	Verifique las entradas del disparador

nota

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

Paso 2: Habilitar la monitorización de depuración

Añada nodos de depuración para solución de problemas

1. Coloque nodos de depuración en puntos clave de los flujos problemáticos:
   • Después de las entradas del disparador
   • Antes y después de los nodos de lógica
   • En las salidas finales
2. Configure nodos de depuración para obtener la máxima información:
   • Salida: Objeto de mensaje completo
   • A: Barra lateral de Depuración
   • Nombre: Nombres descriptivos (p. ej., "Después de la Lógica de Clasificación")
3. Habilite todos los nodos de depuración haciendo clic en sus botones en el editor

Gestión de la barra lateral de depuración

Acceda a la barra lateral de Depuración:

• Haga clic en la pestaña Debug (ícono de error) en el panel derecho
• Limpiar mensajes antiguos usando el icono de la papelera
• Filtrar 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 valores

Paso 3: Rastreo de la ejecución del flujo

Siga la ruta del mensaje

1. Comience 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 se detiene el flujo o produce una salida incorrecta

Puntos comunes de interrupción del flujo

Node Type	Common Issues	Quick Check
Lógica de Clasificación	No se alcanza el umbral de confianza	Verifique la alineación 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 en busca de errores
HTTP Request	Conectividad de red	Pruebe el endpoint manualmente

Problemas comunes de Node-RED y soluciones

Problemas de ejecución de flujo

Problema: El flujo no se dispara

Síntomas:

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

Pasos de diagnóstico:

1. Comprobar la fuente de disparo: inyección manual, temporizador, entrada externa
2. Verificar el cableado: asegúrese de las conexiones entre nodos
3. Probar disparador 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	Reconectar nodos correctamente	Inspección visual durante la edición
Mala configuración del temporizador	Verifique la configuración de temporización del nodo de inyección	Documente los requisitos de temporización
Fallo del disparador externo	Verifique el cableado I/O y las señales	Pruebas de I/O periódicas

Problema: Los flujos se ejecutan pero con resultados incorrectos

Síntomas:

• Los mensajes fluyen pero las clasificaciones son incorrectas
• La lógica de aprobado/reprobado no funciona correctamente
• Resultados inconsistentes

Proceso de diagnóstico:

1. Agregar nodos Debug antes y después de los nodos sospechosos
2. Comparar el contenido del mensaje esperado con el real
3. Verificar configuraciones de los nodos para los parámetros correctos

Soluciones:

Área problemática	Verificación	Arreglo
Lógica de Clasificación	alineación ROI, entrenamiento del modelo	Reentrenar o ajustar ROI
Condiciones de Switch	nombres y valores de propiedades	Lógica de switch correcta
Propiedades del Mensaje	tipos de datos y formatos	Usar nodo Change para corregir el formato
Variables de Contexto	valores almacenados y alcance	Borrar/restablecer el almacenamiento de contexto

Problemas de rendimiento

Problema: Ejecución lenta del flujo

Síntomas:

• Retrasos entre el disparo y la salida
• Tiempos de espera de inspección
• Retraso del sistema

Diagnóstico de rendimiento:

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

Acciones de optimización:

Problema de rendimiento	Solución	Mejora esperada
Demasiados nodos Debug	Desactive/elimine nodos Debug no utilizados	Incremento de 10-20 % en la velocidad
Nodos Function complejos	Optimizar el código JavaScript	Mejora variable
Disparos de alta frecuencia	Agregar retardo / limitación de tasa	Evitar sobrecarga del sistema
Objetos de mensaje grandes	Reducir el tamaño de la carga del mensaje	Procesamiento más rápido

Procedimientos de Mantenimiento

Verificaciones Diarias de Salud

Inspección Visual del Flujo (5 minutos)

1. Acceder al editor de Node-RED
2. Verificar indicadores de error (triángulos rojos)
3. Verificar que las conexiones del flujo estén intactas
4. Revisar los mensajes de Debug recientes en busca de anomalías

Prueba de Ejecución del Flujo (10 minutos)

1. Prueba de disparo manual usando nodos Inject
2. Verificar salidas esperadas en la barra lateral de Debug
3. Probar la lógica de éxito/fallo con piezas buenas y malas conocidas
4. Confirmar comunicaciones externas (PLC, bases de datos)

Tareas de Mantenimiento Mensual

Revisión de Rendimiento (15 minutos)

Lista de Verificación de Optimización de Flujos:

Task	Action	Notes
Limpieza de nodos Debug	Desactivar nodos Debug no utilizados	Mantener solo el debugging esencial
Revisión del Almacenamiento de Contexto	Borrar valores almacenados innecesarios	Prevenir la acumulación de memoria
Revisión del Registro de Errores	Verificar errores en la consola del navegador	Documentar problemas recurrentes
Creación de Copia de Seguridad	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 los 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 ante cualquier cambio

Mantenimiento Profundo Mensual

Análisis Exhaustivo de Flujos (45 minutos)

Recolección de Métricas de Rendimiento:

• Tiempos de ejecución de flujos
• Análisis de 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

Prueba de Copia de Seguridad 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 mantenga la funcionalidad
4. Documentar los procedimientos de recuperación

Herramientas y Técnicas de Diagnóstico

Herramientas Integradas de Node-RED

Funciones de la Barra Lateral de Debug

Feature	Use Case	Access Method
Filtrado de mensajes	Enfocarse en nodos específicos	Botón de filtro en la barra lateral
Historial de mensajes	Revisar los últimos 100 mensajes	Desplazarse en la barra lateral de Debug
Ubicación del nodo	Encontrar la fuente del mensaje de Debug	Haga clic en el nombre del nodo en el mensaje
Exportación de mensajes	Guardar datos de diagnóstico	Copiar el contenido del mensaje

Explorador de Datos de Contexto

Acceder al Almacenamiento de Contexto:

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

Depuración de Contexto:

• Contexto del Nodo: Verificar el estado individual del nodo
• Contexto de Flujo: Verificar variables de flujo compartidas
• Contexto Global: Revisar configuraciones a nivel del sistema

Pruebas de Comunicaciones de Red

Validación de Solicitudes HTTP:

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

Verificación de la Comunicación con PLC:

1. Utilice software de programación de PLC para verificar la conectividad
2. Probar el acceso al registro de datos de forma independiente
3. Validar las conversiones de formato de datos

Procedimientos de Recuperación de Emergencia

Recuperación de corrupción de flujos

Síntomas de corrupción:

• La interfaz de Node-RED de OV10i no carga los flujos
• Los flujos aparecen vacíos después de reiniciar la cámara
• El despliegue falla repetidamente

Pasos de recuperación:

1. Realizar un ciclo de energía de la cámara OV10i:
   • Desconecte la alimentación durante 10 segundos
   • Espere a que complete el arranque (las 4 LEDs estables)
2. Acceda a la interfaz de 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 OV10i
   • 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. Desactive nodos Debug no esenciales en OV10i Node-RED
2. Elimine disparadores de temporizador de alta frecuencia
3. Simplifique nodos Function complejos
4. Realice un ciclo de energía a la cámara para reiniciar todos los servicios

Soluciones a largo plazo:

• Optimizar el diseño de flujos para el hardware OV10i
• 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 previa al mantenimiento

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

Validación post-mantenimiento

• Todos los flujos se despliegan con éxito
• Las pruebas de activación manual se ejecutan correctamente
• Comunicaciones externas verificadas
• Indicadores de error limpiados
• 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 realizado
• Restauración de copia de seguridad si es necesario
• Causa raíz identificada
• Medidas preventivas implementadas

Documentación y Registro

Registros de mantenimiento

Documentación requerida:

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

🔗 Ver También

• Node-RED Basics
• Creating Your First Recipe
• Camera Communication Architecture
• Troubleshooting Power Issues
• Node-RED Architecture in OV10i

---

tip

Documente todos los cambios realizados durante las sesiones de depuración. Esto facilita futuras resoluciones de problemas y genera conocimiento institucional para su equipo.