Depuración de Node-RED

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

aviso

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

Procedimientos rápidos de solución de emergencias

Sistema crítico fuera de servicio - Acciones inmediatas

Paso	Acción	Tiempo	Resultado
1	Verificar el estado del LED de alimentación de la cámara	30 sec	Verificar que el hardware esté OK
2	Acceda a OV20i Node-RED: http://camera-ip/recipes/<recipe-number>/ioblock	1 min	Confirmar que el editor es accesible
3	Buscar indicadores de error en triángulos rojos	1 min	Identificar nodos que están fallando
4	Haga clic en el botón Deploy (Full Deploy)	30 sec	Restablecer todos los flujos
5	Probar disparador de inspección básico	2 min	Verificar que el sistema opere

Recuperación del sistema (Si el Editor no carga)

Las cámaras OV20i no disponen de un modo seguro: reiniciar 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 se complete el arranque (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 las correcciones necesarias
5. Deploy changes 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 OV20i Node-RED?	Continuar al Paso 2	Verificar estado de red/cámara
¿Se pueden ver los flujos en el editor?	Continuar al Paso 2	Reinicie la cámara y vuelva a intentarlo
¿Ve triángulos de error en los nodos?	Enfóquese primero en esos nodos	Verifique la ejecución del flujo
¿Se está disparando la inspección?	Verifique salidas de nodos individuales	Verifique las entradas del disparador

nota

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

Paso 2: Habilitar Monitorización de Debug

Agregar nodos Debug para resolución de problemas

1. Place Debug nodes en puntos clave de los flujos problemáticos:
   • Después de entradas de disparo
   • Antes y después de nodos de lógica
   • En las salidas finales
2. Configure Debug nodes para obtener la máxima información:
   • Output: Complete message object
   • To: Debug sidebar
   • Name: Descriptive names (p. ej., "After Classification Logic")
3. Enable all Debug nodes haciendo clic en sus botones en el editor

Gestión del Debug Sidebar

Acceso al Debug Sidebar:

• Haga clic en Debug tab (ícono de error) en el panel derecho
• Clear old messages usando el icono de la papelera
• Filter messages si hay demasiados nodos activos

Interpretación de mensajes de Debug:

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

Paso 3: Trazar la Ejecución del Flujo

Seguir la ruta del mensaje

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

Puntos de interrupción comunes del flujo

Tipo de Nodo	Problemas Comunes	Verificación Rápida
Lógica de Clasificación	No se cumple el umbral de confianza	Verifique la alineación de ROI y reentrene el modelo
Nodo Switch	Lógica de condición incorrecta	Verifique las reglas de 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 errores
Solicitud HTTP	Conectividad de red	Pruebe manualmente el endpoint

Problemas y Soluciones Comunes de Node-RED

Problemas de Ejecución del Flujo

Problema: El flujo no se activa

Síntomas:

• Sin mensajes en la barra lateral 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. Pruebe el disparo manual: use el nodo Inject para forzar el inicio del flujo

Soluciones:

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

Problema: Flujos en ejecución pero resultados incorrectos

Síntomas:

• Mensajes fluyendo pero clasificaciones incorrectas
• La lógica de pass/fail no funciona correctamente
• Resultados inconsistentes

Proceso de Diagnóstico:

1. Añada nodos Debug antes y después de los nodos sospechosos
2. Compare el contenido de los mensajes esperados frente a los reales
3. Verifique las configuraciones de los nodos para los parámetros correctos

Soluciones:

Área de Problema	Verificación	Corrección
Lógica de Clasificación	Alineación de ROI, entrenamiento del modelo	Reentrene o ajuste ROI
Condiciones del Switch	Nombres y valores de las propiedades	Lógica de switch correcta
Propiedades del Mensaje	Tipos de datos y formatos	Use Change para corregir formato
Variables de Contexto	Valores almacenados y alcance	Limpiar/reiniciar almacenamiento de contexto
Otros

Problemas de Rendimiento

Problema: Ejecución lenta del flujo

Síntomas:

• Retrasos entre el disparo y la salida
• Time-outs 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 cámara
3. Cuente los nodos Debug activos (desactive los que no se utilicen)

Acciones de Optimización:

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

Procedimientos de Mantenimiento

Chequeos de Salud Diarios

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 Debug recientes para detectar anomalías

Prueba de Ejecución del Flujo (10 minutos)

1. Prueba de disparo manual con nodos Inject
2. Verificar las salidas esperadas en la barra lateral de Debug
3. Probar la lógica de éxito/fallo con piezas buenas/malas conocidas
4. Confirmar las 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:

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	Limpiar 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 cuenten con manejo de errores adecuado
3. Probar escenarios de recuperación de errores
4. Actualizar la documentación ante 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 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 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 procedimientos de recuperación

Herramientas y Técnicas de Diagnóstico

Herramientas integradas de Node-RED

Funciones de la Barra Lateral de Debug

Característica	Caso de uso	Método de acceso
Filtrado de mensajes	Enfocarse en nodos específicos	Botón de filtrado 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 contenido del mensaje

Explorador de Datos de Contexto

Acceso al Almacenamiento de Contexto:

• Abrir la interfaz de Node-RED de OV20i (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:

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

Pruebas de Comunicación de Red

Validación de Solicitudes HTTP:

1. Utilizar herramientas externas (Postman, curl) para probar endpoints
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 Comunicación con PLC:

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

Procedimientos de Recuperación ante Emergencias

Recuperación ante Corrupción de Flujos

Síntomas de Corrupción:

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

Pasos de Recuperación:

1. Ciclo de alimentación de la cámara OV20i:
   • Desconecte la alimentación durante 10 segundos
   • Espere a que complete el arranque (las 4 LED estables)
2. Acceda 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 OV20i
   • 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 los nodos de depuración no esenciales en OV20i Node-RED
2. Elimine disparadores de temporizador de alta frecuencia
3. Simplifique nodos Function complejos
4. 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 OV20i
• Implementar limitación de tasa
• Reducir los tamaños 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

• Notificar a 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 posterior al mantenimiento

• Todos los flujos se despliegan con éxito
• Las pruebas de disparo manual pasan
• Verificar comunicaciones externas
• Indicadores de error limpiados
• Rendimiento dentro del rango aceptable
• Documentación actualizada

Lista de verificación de respuesta ante emergencias

• Impacto en el sistema evaluado
• Producción notificada
• Intento de solución rápida
• 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

🔗 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 OV20i

---

tip

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