Depuración de Node-RED

Esta guía proporciona procedimientos completos de solución de problemas para Node-RED en el sistema de cámaras OV10i. Úsela para reparación en campo, depuración de problemas de producción y 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 flujos.

Procedimientos de Solución Rápida de Emergencia

Sistema Crítico Caído - Acciones Inmediatas

Paso	Acción	Tiempo	Resultado
1	Verifique el estado del LED de alimentación de la cámara	30 seg	Verificar que el hardware esté OK
2	Acceda a Node-RED del OV10i: http://camera-ip/recipes/<recipe-number>/ioblock	1 min	Confirmar que el editor sea accesible
3	Busque indicadores de error de triángulo rojo	1 min	Identificar nodos que fallan
4	Haga clic en el botón Deploy (Full Deploy)	30 seg	Reiniciar todos los flujos
5	Pruebe el activador de inspección básica	2 min	Verificar que el sistema esté operativo

Recuperación del Sistema (Si el Editor No Carga)

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

1. Apague y encienda la cámara (desconecte la alimentación por 10 segundos)
2. Espere el arranque completo (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 realice las correcciones necesarias
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 Sistemático de Depuración

Paso 1: Identificar el Alcance del Problema

Preguntas de Evaluación Rápida

Pregunta	Si SÍ	Si NO
¿Puede acceder a la interfaz de Node-RED del OV10i?	Continúe al Paso 2	Verifique el estado de la red/cámara
¿Son visibles los flujos en el editor?	Continúe al Paso 2	Reinicie la cámara y vuelva a intentar
¿Ve triángulos de error en los nodos?	Concéntrese primero en esos nodos	Verifique la ejecución del flujo
¿Se está activando la inspección?	Verifique las salidas individuales de los nodos	Verifique las entradas del activador

nota

URL de acceso: Use 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 de Depuración para Solución de Problemas

1. Coloque nodos Debug en puntos clave de los flujos problemáticos:
   • Después de las entradas del activador
   • Antes y después de los nodos lógicos
   • En las salidas finales
2. Configure los nodos Debug para obtener la máxima información:
   • Output: Objeto de mensaje completo
   • To: Barra lateral de depuración
   • Name: Nombres descriptivos (por ejemplo, "After Classification Logic")
3. Habilite todos los nodos Debug haciendo clic en sus botones en el editor

Gestión de la Barra Lateral de Depuración

Acceder a la Barra Lateral de Depuración:

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

Interpretación de Mensajes de Depuración:

• Timestamp muestra cuándo ocurrió el mensaje
• Node name muestra qué nodo generó el mensaje
• Message content muestra la estructura de datos y los valores

Paso 3: Rastrear la Ejecución del Flujo

Seguir la Ruta del Mensaje

1. Comience desde la fuente del disparador (inyección, temporizador, entrada externa)
2. Verifique que cada nodo reciba la entrada esperada
3. Revise las transformaciones del mensaje en cada paso
4. Identifique dónde se detiene el flujo 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 cumple el umbral de confianza	Revisar alineación de ROI, reentrenar el modelo
Nodo Switch	Lógica de condición incorrecta	Verificar reglas del switch y propiedades del mensaje
Nodo Join	Esperando un conjunto de mensajes incompleto	Revisar el conteo de partes del mensaje
Nodo Function	Errores de JavaScript	Revisar la consola del navegador en busca de errores
HTTP Request	Conectividad de red	Probar el endpoint manualmente

Problemas y Soluciones Comunes en Node-RED

Problemas de Ejecución del Flujo

Problema: El Flujo No se Activa

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. Revisar la fuente del disparador: inyección manual, temporizador, entrada externa
2. Verificar el cableado: Asegurar las conexiones entre nodos
3. Probar disparador manual: Usar el nodo Inject para forzar el inicio del flujo

Soluciones:

Causa	Solución	Prevención
Flujos deshabilitados	Hacer clic en Deploy → Full Deploy	Despliegue regular después de los cambios
Conexiones rotas	Reconectar los nodos correctamente	Inspección visual durante las ediciones
Configuración incorrecta del temporizador	Revisar la configuración de tiempo del nodo inject	Documentar los requisitos de tiempo
Falla del disparador externo	Verificar el cableado y las señales de I/O	Pruebas regulares de I/O

Problema: Los Flujos se Ejecutan Pero los Resultados son Incorrectos

Síntomas:

• Los mensajes fluyen pero las clasificaciones son incorrectas
• La lógica de aprobado/rechazado 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 esperado vs. el real del mensaje
3. Revisar las configuraciones de los nodos para verificar los 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 el ROI
Condiciones del Switch	Nombres y valores de las propiedades	Corregir la lógica del switch
Propiedades del Mensaje	Tipos y formatos de datos	Usar el nodo Change para corregir el formato
Variables de Contexto	Valores almacenados y alcance	Limpiar/restablecer el almacenamiento de contexto

Problemas de Rendimiento

Problema: Ejecución Lenta del Flujo

Síntomas:

• Retrasos entre el disparador y la salida
• Tiempos de espera de inspección agotados
• Lentitud del sistema

Diagnóstico de Rendimiento:

1. Revisar 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 los nodos Debug activos (deshabilitar los que no se usan)

Acciones de Optimización:

Problema de Rendimiento	Solución	Mejora Esperada
Demasiados nodos Debug	Deshabilitar/eliminar los nodos Debug no utilizados	Aumento de velocidad del 10-20%
Nodos Function complejos	Optimizar el código JavaScript	Mejora variable
Disparadores de alta frecuencia	Agregar limitación de retraso/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 Diarias de Estado

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 mensajes recientes de Debug en busca de anomalías

Prueba de Ejecución del Flujo (10 minutos)

1. Prueba de activación manual usando nodos Inject
2. Verificar las salidas esperadas en la barra lateral de Debug
3. Probar la lógica de aprobado/rechazado con piezas buenas/malas conocidas
4. Confirmar las comunicaciones externas (PLC, bases de datos)

Tareas de Mantenimiento Mensuales

Revisión de Rendimiento (15 minutos)

Lista de Verificación de Optimización del Flujo:

Tarea	Acción	Notas
Limpieza de Nodos Debug	Desactivar nodos Debug no utilizados	Mantener solo la depuración esencial
Revisión del Almacenamiento de Contexto	Borrar valores almacenados innecesarios	Prevenir acumulación de memoria
Revisión del Registro de Errores	Verificar errores en la consola del navegador	Documentar problemas recurrentes
Creación de Respaldo	Exportar flujos a un archivo de respaldo	Almacenar con información de fecha/versión

Validación de la Configuración (20 minutos)

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

Mantenimiento Profundo Mensual

Análisis Integral del Flujo (45 minutos)

Recopilación de Métricas de Rendimiento:

• Tiempos de ejecución del flujo
• Análisis de frecuencia de errores
• Patrones de uso de recursos
• Confiabilidad de las comunicaciones

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 una exportación completa del flujo
2. Probar el procedimiento de importación en un sistema de respaldo
3. Verificar que la restauración del respaldo 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

Función	Caso de Uso	Método de Acceso
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 el origen del mensaje de Debug	Hacer 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:

• Abra la interfaz de Node-RED de OV10i (http://<camera-ip>/recipes/<recipe-number>/ioblock)
• Vaya a la pestaña Context Data (barra lateral derecha)
• Vea los valores de contexto Node/Flow/Global

Depuración de Contexto:

• Node Context: Verifique el estado individual del nodo
• Flow Context: Verifique las variables compartidas del flujo
• Global Context: Revise las configuraciones a nivel del sistema

Pruebas de Comunicación de Red

Validación de Solicitudes HTTP:

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

Verificación de Comunicación con PLC:

1. Use el software de programación del PLC para verificar la conectividad
2. Pruebe el acceso a los registros de datos de forma independiente
3. Valide las conversiones de formato de datos

Procedimientos de Recuperación de Emergencia

Recuperación por Corrupción de Flujos

Síntomas de Corrupción:

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

Pasos de Recuperación:

1. Reinicie el ciclo de energía de la cámara OV10i:
   • Desconecte la alimentación durante 10 segundos
   • Espere el arranque completo (los 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 una copia de seguridad
3. Restaurar desde copia de seguridad:
   • Use la función de importación de recetas del OV10i
   • Importe el archivo de copia de seguridad más reciente
   • Verifique que todas las conexiones estén intactas
4. Valide la restauración:
   • Pruebe todos los flujos críticos
   • Verifique las comunicaciones externas
   • Actualice cualquier cambio de configuración

Problemas de Recursos del Sistema

Sobrecarga de Memoria/CPU

Acciones Inmediatas:

1. Deshabilite los nodos Debug no esenciales en Node-RED del OV10i
2. Elimine disparadores de temporizador de alta frecuencia
3. Simplifique los nodos Function complejos
4. Reinicie el ciclo de energía de la cámara para reiniciar todos los servicios

Soluciones a Largo Plazo:

• Optimice el diseño de flujos para el hardware del OV10i
• Implemente limitación de velocidad
• Reduzca el tamaño de las cargas útiles de los mensajes
• Programe ventanas de mantenimiento

Listas de Verificación para Solución de Problemas

Lista de Verificación Previa al Mantenimiento

• Notificar a producción sobre 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 de la copia de seguridad

Validación Posterior al Mantenimiento

• Todos los flujos se implementan correctamente
• 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 de Emergencia

• Impacto en el sistema evaluado
• Producción notificada
• Solución rápida intentada
• 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/hora del mantenimiento
• Problemas identificados y resueltos
• Cambios de configuración realizados
• Mejoras de rendimiento logradas
• Recomendaciones futuras

🔗 Ver También

• Conceptos Básicos de Node-RED
• Creando Su Primera Receta
• Arquitectura de Comunicación de la Cámara
• Solución de Problemas de Energía
• Arquitectura de Node-RED en el OV10i

---

tip

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