> ## Documentation Index
> Fetch the complete documentation index at: https://ayuda.daia.cl/llms.txt
> Use this file to discover all available pages before exploring further.

# Diagnóstico

> Revisar las conexiones de la línea, probar los pulsadores y marcar el estado de las piezas en terreno

La pestaña **Diagnóstico** de **Configuración** revisa la red, el Sizer, el PLC, las impresoras y los escáneres, y muestra qué está fallando y qué hacer. También tiene el **Layout de la línea**: un plano de las salidas con el pulsador y la impresora de cada una, donde se pintan los problemas.

El diagnóstico no cambia la configuración y corre solo cuando lo pides.

> [!WARNING]
>
> Haz el diagnóstico solo cuando la línea no esté en producción. Las pruebas consultan las impresoras y el worker de impresión, que comparten la cola con las etiquetas reales: pueden retrasar impresiones o disparar alarmas en las pantallas.

> [!NOTE]
>
> Para ejecutar el diagnóstico, probar los pulsadores y marcar el estado de las piezas basta el nivel **Lectura** en el permiso **Configuración**. Crear o modificar el layout requiere nivel **Editor**: sin él, los botones aparecen bloqueados con el texto "Requiere permiso de administrador en Configuración".

## Ejecutar el diagnóstico

![Resultado del diagnóstico con el veredicto, el layout de la línea con las piezas pintadas por estado y los problemas encontrados](https://mintcdn.com/daiasystems/U9C00eaS-eL-I-Fq/images/daia-agent/configuracion/diagnostico-resultado.png?fit=max\&auto=format\&n=U9C00eaS-eL-I-Fq\&q=85\&s=5e2532af36725eaf7ee625c1ecff7c99)

Resultado del diagnóstico

**1. Ejecutar**

Haz clic en **Ejecutar diagnóstico**. Mientras corre aparece **Diagnosticando la línea…** con el avance ("N de M pruebas"), una ficha por grupo y los últimos resultados.

**2. Leer el resultado**

Al terminar queda una barra con el veredicto ("Todo en orden: la línea no tiene problemas", "La línea tiene N problemas críticos" o "N avisos para revisar"), los conteos por estado y "Último diagnóstico hace X · usuario".

**3. Revisar los problemas**

Revisa **Problemas encontrados**, a la derecha del plano.

En la barra del resultado:

| Botón | Qué hace |
| - | - |
| **Repetir diagnóstico** | Vuelve a ejecutarlo |
| **Copiar reporte** | Copia al portapapeles los problemas y el resultado de cada prueba, para enviarlo a soporte |
| **Ver detalle técnico** | Muestra cada equipo por grupo, con el resultado de cada capa: **Red**, **Puerto**, **Protocolo**, **Worker** |

El último diagnóstico queda guardado: si otra persona lo ejecutó, lo ves al abrir la pestaña.

### Qué revisa

| Grupo | Pruebas |
| - | - |
| **Infraestructura** | Base de datos, Redis y el worker de impresión |
| **Sizer** | Que responda en la red y en su puerto, que su API conteste y que el agente Tomra esté iniciado |
| **PLC** | Según el protocolo: el agente de pulsadores, la lectura Modbus del PLC (solo lectura, nunca escribe) o los eventos de Tomra, y la última pulsación |
| **Impresoras** | Las impresoras habilitadas: red, puerto y estado de la impresora (sin papel, en pausa, cabezal abierto, sin cinta, temperatura, memoria llena). Además, que el worker de impresión llegue a cada impresora |
| **Escáneres** | Los escáneres habilitados, si el protocolo los usa: red, lecturas correctas y fallidas, y la última pulsación |

Si una prueba falla, las siguientes de ese equipo no se ejecutan y quedan como "No se revisó (falló una prueba anterior)".

> [!NOTE]
>
> Si el worker no llega a una impresora, DAIA Agent puede mostrar además la alarma de error de conexión de la impresora, igual que cuando falla una etiqueta.

## Problemas encontrados

Los problemas se agrupan por causa y se ordenan por gravedad. Cada tarjeta muestra:

* El grupo y, si afecta a toda la línea, la marca **crítico**.
* Los equipos afectados. Una impresora sin salidas asignadas lleva la marca **sin uso**: sus fallas bajan a aviso porque no detienen la línea.
* **Qué hacer**: la acción sugerida.
* A qué salidas afecta ("Afecta a toda la línea", "Afecta a las salidas …").
* **También explica**: otros problemas que son consecuencia de este.
* **Ver en el plano**: resalta en el plano las salidas afectadas.
* **Ir a …**: abre la pestaña donde se corrige (Línea de producción, Pulsadores, Escáneres o Impresoras).

Si un equipo ya está marcado con falla en terreno (ver más abajo), su problema aparece como **conocido** y no cuenta para el veredicto.

## Layout de la línea

El plano está disponible cuando la línea está conectada con el agente Tomra. Muestra las vías del calibrador, la entrada de fruta y las salidas arriba y abajo, agrupadas. Cada salida muestra su pulsador y su impresora, el estado de cada pieza, y, después de un diagnóstico, su color: **Sin problemas**, **Aviso**, **Falla** o **Sin probar**. Los problemas que afectan a toda la línea se dibujan sobre el cuerpo de la línea como **Línea detenida** o **Revisar**.

* **Solo con problemas** deja a la vista solo las salidas con avisos o fallas.
* **Ver tabla** muestra el layout en una tabla (salida, ubicación, pulsador, IP de la impresora, estado y notas de terreno). **Exportar CSV** la descarga.
* Haz clic en una salida para abrir su panel lateral: el estado de sus piezas y la **Cadena de la salida** (Pulsador / escáner → Agente de pulsadores → Cola de impresión → Impresora), con qué hacer en cada eslabón que falla.

### Crear o modificar el layout

![Editor del layout de la línea con las salidas asignadas a los espacios del plano y la lista de salidas disponibles](https://mintcdn.com/daiasystems/U9C00eaS-eL-I-Fq/images/daia-agent/configuracion/diagnostico-layout-editor.png?fit=max\&auto=format\&n=U9C00eaS-eL-I-Fq\&q=85\&s=0b10388333eca4ddd6b14bc20bece978)

Editar asignaciones del layout

**1. Abrir el editor**

Haz clic en **Crear layout**. Si ya existe, haz clic en **Administrar layout** y luego en **Editar asignaciones**.

**2. Estructura**

Define **Vías del calibrador**, el lado de la **Entrada de fruta / operador** (**Izquierda** o **Derecha**) y los grupos de **Salidas arriba** y **Salidas abajo**, desde la entrada hacia el final de la línea, cada uno con **Nombre del grupo** y cantidad de **Espacios**. Usa **Agregar grupo** para separar, por ejemplo, exportación y mercado interno. Haz clic en **Siguiente: asignar salidas**.

**3. Asignar salidas**

Arrastra cada salida de **Salidas disponibles** a un espacio. Arrastrar entre espacios las intercambia; arrastrar a la lista la quita del layout. **Asignar en orden** llena los espacios vacíos con las salidas disponibles, en orden (primero arriba, luego abajo), y **Vaciar espacios** los deja todos vacíos.

**4. Guardar**

Haz clic en **Guardar**. Al abrir **Administrar layout** se ve "Guardado el … por …".

Las salidas que aparecen son las de [Salidas](https://ayuda.daia.cl/daia-agent/configuracion/salidas.md). Para cambiar vías o grupos de un layout ya guardado, usa **Modificar estructura** en el paso de asignación.

### Marcar el estado de una pieza en terreno

El sistema propone el estado de cada pieza (pulsador, impresora y escáner) con la configuración, las pulsaciones vistas y el último diagnóstico. Si ves algo que el sistema no detecta, como una impresora que responde pero está descompuesta, márcalo:

![Panel lateral de una salida con el estado en terreno del pulsador y la impresora y la cadena de pruebas de la salida](https://mintcdn.com/daiasystems/U9C00eaS-eL-I-Fq/images/daia-agent/configuracion/diagnostico-salida.png?fit=max\&auto=format\&n=U9C00eaS-eL-I-Fq\&q=85\&s=5697e99706cb284d0f8340c663293cc3)

Panel lateral de una salida

**1. Abrir la salida**

Haz clic en la salida en el plano. En **Estado en terreno** aparece una ficha por pieza con su estado **Automático**.

**2. Marcar**

Haz clic en **Marcar estado**, elige el estado, agrega una **Nota (opcional)** y haz clic en **Guardar**.

| Pieza | Estados que puedes marcar |
| - | - |
| Pulsador | Funciona, No funciona, No mapeado, Dañado |
| Impresora | Funciona, Sin conexión, Descompuesta, En reparación |
| Escáner | Funciona, Sin conexión, Descompuesta, En reparación |

* La marca de una impresora o un escáner aplica a todas las salidas que usan ese equipo. La del pulsador es solo de esa salida.
* **Funciona** no está disponible si a la pieza le falta configuración en la app.
* **Volver a automático** quita la marca.
* Arriba del plano, el contador "N de M verificadas" cuenta las salidas con todas sus piezas marcadas **Funciona**.

Las marcas vencen solas cuando la evidencia las contradice:

| Marca | Vence |
| - | - |
| Funciona | Cuando un diagnóstico o la configuración muestran una falla |
| Pulsador con falla | Al verse una pulsación de esa salida |
| Sin conexión | Con el próximo diagnóstico que lo vea funcionando |
| Descompuesta o En reparación | Con un diagnóstico que lo vea funcionando, 24 h después de marcarla |

## Probar los pulsadores

La prueba de pulsadores sirve para recorrer la línea presionando cada pulsador y confirmar, en una pasada, que todos responden y que cada uno está asignado a su salida. Es independiente del diagnóstico de conexiones.

El botón **Probar pulsadores** aparece junto al título **Layout de la línea** cuando el protocolo de [Pulsadores](https://ayuda.daia.cl/daia-agent/configuracion/plc-pulsadores.md) es **Standard (ARM/WAIT)**, **Polling** o **Server TCP** con **Habilitar Modbus TCP** marcado.

> [!WARNING]
>
> Durante la prueba, cada pulsación imprime la etiqueta y crea la caja como siempre. Hazla sin producción.

![Panel de la prueba de pulsadores con el avance 8 de 13, los pulsadores que faltan y el plano de la línea con círculos verdes en los pulsadores presionados](https://mintcdn.com/daiasystems/h8SWwBPLr6e6CZZ1/images/daia-agent/configuracion/diagnostico-prueba-pulsadores.png?fit=max\&auto=format\&n=h8SWwBPLr6e6CZZ1\&q=85\&s=50048e5cb792c7467bcffa8076226d2f)

Prueba de pulsadores en curso

**1. Iniciar la prueba**

Haz clic en **Probar pulsadores**. Aparece "Prueba de pulsadores en curso: presiona cada pulsador de la línea" y el resto del diagnóstico se atenúa.

**2. Presionar cada pulsador**

Recorre la línea y presiona cada pulsador. En el plano, cada salida muestra un círculo por pulsador: gris hueco es **Pendiente**, verde es **Presionado** y naranjo es **Deshabilitado**. La salida destella al recibir la pulsación.

**3. Revisar lo que falta**

El panel muestra el avance (presionados de los esperados, por ejemplo **8/13**) y "Faltan N pulsadores" con el índice PLC y el código de cada pendiente. Cuando responden todos, dice "Todos los pulsadores de la línea respondieron.".

**4. Terminar**

Haz clic en **Terminar prueba**. El resumen queda en pantalla con quién la inició; **Repetir** la vuelve a empezar y **Cerrar** la oculta.

La prueba se cierra sola tras 15 minutos sin pulsaciones ("Prueba de pulsadores cerrada por inactividad"); el panel muestra el tiempo que queda. Mientras corre, **Ejecutar diagnóstico** queda deshabilitado.

Se esperan los pulsadores habilitados que tienen índice PLC. Los que no lo tienen se listan como "Sin índice PLC (no se pueden probar)". Durante la prueba, el panel avisa:

| Aviso | Qué significa |
| - | - |
| Se presionó el índice PLC N y no está asignado a ningún pulsador | Hay un pulsador físico que no corresponde a ninguno configurado. Revisa el **Index PLC** en [Etiquetado](https://ayuda.daia.cl/daia-agent/etiquetado/agregar-pulsadores.md) |
| Se presionó el pulsador X (índice PLC N), que está deshabilitado | El pulsador funciona, pero está inactivo en la app |
| Respondió el pulsador X de la salida Y, que no está en el layout | El pulsador funciona, pero su salida no está en el plano. Cuenta como presionado |
| El índice PLC N está asignado a más de un pulsador | Aparece al iniciar. Al presionarlo se marcan todos los pulsadores con ese índice |

## Solución de problemas

Cada problema trae su propio **Qué hacer**. Los más comunes:

> **No hay worker de impresión activo / Redis no responde**
>
> Las etiquetas no se imprimen. Revisa en el equipo de DAIA Agent que Docker y sus contenedores (Redis y el worker de impresión) estén en marcha.

> **Agente de pulsadores detenido**
>
> Los pulsadores no imprimen. Inicia el agente en [Pulsadores](https://ayuda.daia.cl/daia-agent/configuracion/plc-pulsadores.md).

> **Agente Tomra detenido**
>
> Inicia la conexión con el Sizer en [Línea de producción](https://ayuda.daia.cl/daia-agent/configuracion/linea-produccion.md).

> **No responde en la red**
>
> Revisa que el equipo esté encendido, el cable de red y que la IP sea correcta.

> **No responde a ping, pero el puerto está abierto**
>
> Puede ser un firewall que bloquea el ping. Si el equipo funciona, no requiere acción.

> **Puerto cerrado o no disponible**
>
> El equipo responde pero no acepta conexiones: revisa su configuración de red o si otro equipo lo tiene ocupado.

> **El worker no respondió a la prueba**
>
> El worker está ocupado o tiene una versión anterior. Repite el diagnóstico más tarde; si persiste, contacta a soporte DAIA para actualizarlo.

> **El layout de la línea está disponible cuando la línea de producción está conectada con el agente Tomra**
>
> El plano solo existe con la línea configurada con Tomra en [Línea de producción](https://ayuda.daia.cl/daia-agent/configuracion/linea-produccion.md). El diagnóstico igual funciona.

> **La prueba de pulsadores aplica a los protocolos PLC estándar, MLS4 y TCP con Modbus.**
>
> El protocolo de [Pulsadores](https://ayuda.daia.cl/daia-agent/configuracion/plc-pulsadores.md) no tiene pulsadores por Modbus. Con **Server TCP**, marca **Habilitar Modbus TCP** para sumar pulsadores.

> **El agente PLC está detenido: inícialo para probar los pulsadores.**
>
> Conecta el PLC en [Pulsadores](https://ayuda.daia.cl/daia-agent/configuracion/plc-pulsadores.md) y vuelve a iniciar la prueba.

> **No se pudo leer la configuración de pulsadores. Revisa la conexión a la base de datos.**
>
> Ejecuta el diagnóstico para revisar la base de datos y vuelve a intentarlo. Si persiste, contacta a soporte DAIA.

> **La salida X ya no existe. Quítala del layout.**
>
> Se eliminó una salida que estaba en el plano. Abre el editor y quítala de su espacio.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.