Depuración de Node-RED

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

aviso

Seguridad Primero: Siempre notifique a producción antes de realizar cambios en 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	Verifique que el hardware esté OK
2	Acceda a OV10i Node-RED: http://camera-ip/recipes/<recipe-number>/ioblock	1 min	Confirme que el editor sea accesible
3	Busque indicadores de error en triángulo rojo	1 min	Identifique nodos que fallan
4	Haga clic en el botón Deploy (Despliegue Completo)	30 seg	Restablezca todos los flujos
5	Pruebe el disparador de inspección básico	2 min	Verifique que el sistema esté operativo

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

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

1. Cicle la alimentación de la cámara (desenchufe la alimentación durante 10 segundos)
2. Espere el arranque completo (los 4 LEDs estables - 2-3 minutos)
3. Acceda a la receta activa de Node-RED a través de 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 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?	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	Ciclo de alimentación de 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á disparando la inspección?	Verifique las salidas de nodos individuales	Verifique las entradas de disparo

nota

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

Paso 2: Habilitar Monitoreo de Depuración

Agregar Nodos de Depuración para Solución de Problemas

1. Coloque nodos de Depuración en puntos clave de flujos problemáticos:
   • Después de las entradas de disparo
   • Antes y después de los nodos lógicos
   • En las salidas finales
2. Configure los 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 (por ejemplo, "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

Acceder a la Barra Lateral de Depuración:

• Haga clic en la pestaña de Depuración (icono de insecto) en el panel derecho
• Borre mensajes antiguos usando el icono de papelera
• Filtre mensajes si hay demasiados nodos activos

Interpretación de Mensajes de Depuración:

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

Paso 3: Rastrear la Ejecución del Flujo

Seguir la Ruta del Mensaje

1. Comenzar desde la fuente del disparador (inyección, temporizador, entrada externa)
2. Verificar que cada nodo reciba la entrada esperada
3. Comprobar las transformaciones de mensajes en cada paso
4. Identificar 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	Verificar alineación de ROI, reentrenar modelo
Nodo de Cambio	Lógica de condición incorrecta	Verificar reglas de cambio y propiedades del mensaje
Nodo de Unión	Esperando un conjunto de mensajes incompleto	Comprobar el conteo de partes del mensaje
Nodo de Función	Errores de JavaScript	Verificar la consola del navegador en busca de errores
Solicitud HTTP	Conectividad de red	Probar el endpoint manualmente

Problemas Comunes de Node-RED y Soluciones

Problemas de Ejecución del Flujo

Problema: Flujo No se Dispara

Síntomas:

• No hay mensajes en la barra lateral de Depuración
• El sistema parece inactivo
• Disparadores externos no funcionan

Pasos de Diagnóstico:

1. Verificar la fuente del disparador: Inyección manual, temporizador, entrada externa
2. Verificar cableado: Asegurarse de las conexiones entre nodos
3. Probar disparador manual: Usar el nodo Inyectar para forzar el inicio del flujo

Soluciones:

Causa	Solución	Prevención
Flujos deshabilitados	Haga clic en Desplegar → Despliegue Completo	Despliegue regular después de cambios
Conexiones rotas	Reconectar nodos correctamente	Inspección visual durante ediciones
Configuración incorrecta del temporizador	Verificar la configuración de tiempo del nodo inyectar	Documentar requisitos de tiempo
Fallo en el disparador externo	Verificar cableado y señales de I/O	Pruebas regulares de I/O

Problema: Flujos en Ejecución Pero Resultados Incorrectos

Síntomas:

• Mensajes fluyendo pero clasificaciones incorrectas
• Lógica de pasar/fallar no funciona correctamente
• Resultados inconsistentes

Proceso de Diagnóstico:

1. Agregar nodos de Depuración antes y después de los nodos sospechosos
2. Comparar contenido de mensaje esperado vs real
3. Verificar configuraciones de nodos para parámetros correctos

Soluciones:

Área de Problema	Verificar	Corregir
Lógica de Clasificación	Alineación de ROI, entrenamiento del modelo	Reentrenar o ajustar ROI
Condiciones de Cambio	Nombres y valores de propiedades	Corregir lógica de cambio
Propiedades del Mensaje	Tipos de datos y formatos	Usar nodo Cambiar para corregir formato
Variables de Contexto	Valores almacenados y alcance	Limpiar/restablecer almacenamiento de contexto

Problemas de Rendimiento

Problema: Ejecución Lenta del Flujo

Síntomas:

• Retrasos entre el disparador y la salida
• Tiempos de espera en la inspección
• Retraso en el sistema

Diagnósticos de Rendimiento:

1. Verificar marcas de tiempo de Depuración para identificar nodos lentos
2. Monitorear uso de CPU en el sistema de cámaras
3. Contar nodos de Depuración activos (deshabilitar los no utilizados)

Acciones de Optimización:

Problema de Rendimiento	Solución	Mejora Esperada
Demasiados nodos de Depuración	Deshabilitar/eliminar nodos de Depuración no utilizados	Aumento de velocidad del 10-20%
Nodos de Función complejos	Optimizar código JavaScript	Mejora variable
Disparadores de alta frecuencia	Agregar retraso/límite de tasa	Prevenir sobrecarga del sistema
Objetos de mensaje grandes	Reducir el tamaño de la carga del 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. Confirmar que las conexiones de flujo estén intactas
4. Revisar mensajes de Debug recientes en busca de anomalías

Prueba de Ejecución del Flujo (10 minutos)

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

Tareas de Mantenimiento Mensuales

Revisión de Rendimiento (15 minutos)

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

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

Validación de Configuración (20 minutos)

1. Comparar flujos actuales con estándares documentados
2. Verificar que todos los caminos críticos tengan manejo de errores apropiado
3. Probar escenarios de recuperación de errores
4. Actualizar la documentación por 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 de Función complejos

Pruebas de Copia de Seguridad y Recuperación (30 minutos)

1. Crear exportación completa del flujo
2. Probar 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

Características 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 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	Hacer 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

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 de Datos de Contexto (barra lateral derecha)
• Ver valores de contexto de Nodo/Flujo/Global

Depuración de Contexto:

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

Pruebas de Comunicación de Red

Validación de Solicitudes HTTP:

1. Usar 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 Comunicación PLC:

1. Usar software de programación de PLC para verificar conectividad
2. Probar acceso a registros de datos de forma independiente
3. Validar conversiones de formatos 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 del OV10i no carga flujos
• Los flujos aparecen vacíos después del reinicio de la cámara
• La implementación falla repetidamente

Pasos de Recuperación:

1. Cicle de energía de la cámara OV10i:
   • Desconecte la alimentación durante 10 segundos
   • Espere a que complete el arranque (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 la copia de seguridad
3. Restaure desde la copia de seguridad:
   • Utilice 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. Desactive los nodos de depuración no esenciales en Node-RED del OV10i
2. Elimine los disparadores de temporizador de alta frecuencia
3. Simplifique los nodos de Función complejos
4. Cicle de energía de la cámara para reiniciar todos los servicios

Soluciones a Largo Plazo:

• Optimice el diseño del flujo para el hardware del OV10i
• Implemente limitación de tasa
• Reduzca los tamaños de carga útil de los mensajes
• Programe ventanas de mantenimiento

Listas de Verificación para Solución de Problemas

Lista de Verificación Pre-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 copia de seguridad

Validación Post-Mantenimiento

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

Lista de Verificación de Respuesta a Emergencias

• Impacto del 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

🔗 Ver También

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

---

tip

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