Ir al contenido

Monitor e incidentes

El monitor responde dos preguntas: ¿cómo va cada caso? y ¿qué necesita a alguien? En la capacidad Flujos del menú, la página Casos muestra todos los casos con su avance, Incidentes reúne los que se detuvieron por un error, agrupados para atenderlos de una vez, y Monitoreo te dice cómo les va a tus flujos. Las páginas se actualizan solas mientras las miras.

En Centro › Flujos › Casos ves cada caso con su flujo, su estado, cuándo empezó, su Duración y su última actividad.

EstadoQué significa
En cursoEl caso está avanzando.
En esperaEspera algo: un robot, la decisión de una persona, un reintento programado, un tiempo o un evento de un paso de espera. Mientras solo tiene esperas abiertas, no ocupa robots ni workers.
Con incidenteUn paso falló y necesita que alguien decida.
CompletadoLlegó a un fin (o una persona lo dio por terminado).
CanceladoSe canceló a mano o por el sistema.

Filtra por Flujo, Estado, Clave de negocio (por ejemplo, el número de la factura) y fechas Desde y Hasta.

La Duración te dice cuánto lleva o cuánto tomó cada caso, sin hacer cuentas:

  • Caso terminado: el tiempo desde que empezó hasta que terminó, por ejemplo «45 s», «4 min 13 s», «2 h 5 min» o «3 d 4 h».
  • Caso abierto (en curso, en espera o con incidente): «En curso · …», contado hasta este momento. El reloj avanza solo mientras miras la página.

Cada paso también muestra su tiempo: lleva X mientras está abierto (el tiempo en su estado actual) y duró X cuando terminó. En el panel del paso ves, por ejemplo, «duró 3 min · terminó hace 2 h»; al pasar el cursor por un paso del diagrama, su estado y cuánto duró. Los pasos de menos de un segundo (inicio, fin, compuertas) no muestran tiempo.

Al abrir un caso ves su nombre (el título o la clave de negocio), el flujo y la versión con la que corre, y sus datos generales: Inicio, Duración, Última actividad, Pasos y Clave de negocio. Si el caso terminó en un fin con nombre, la cabecera lo dice (por ejemplo, «Completado «Registrada»»).

  • Diagrama. El proceso de esa versión, coloreado según el estado de cada paso: verde, completado; azul, en marcha; ámbar, esperando a un robot, una persona o un reintento, o con un error de negocio; rojo, con error; gris, saltado, cancelado o sin pasar. Las conexiones por donde pasó el caso se resaltan, y la ruta de error de negocio que tomó se ve en ámbar. Si algo necesita atención, un aviso arriba te lleva al paso.
  • Panel del paso. Al elegir un paso ves su estado, desde cuándo está así o cuánto duró, el número de intento y, si falló, qué pasó y en qué actividad del robot. Desde ahí abres Ver la ejecución del robot o Ver la tarea. Con permiso para ver datos, también los Datos de entrada, la Salida, el Resultado y, si llegó, el Resultado tardío.
  • Variables. Los datos del caso en este momento. Las marcadas con un candado son protegidas: guardan la decisión de una persona.
  • Registro del caso. Todo lo que pasó, en una sola línea de tiempo (ver abajo).
  • Eventos del motor. Plegado por defecto: el historial técnico del motor, incluidos los cambios de variables con su valor Antes y Después.

Desde el caso saltas a lo relacionado en otras capacidades: Ver el proceso en Robots, Ver la credencial en Conexiones, Ver la base de conocimiento, Ver la integración en Conexiones o Ver el disparador en Robots. Solo aparecen los enlaces que puedes abrir.

Los pasos de espera se ven en ámbar mientras esperan, y su panel dice qué esperan y hasta cuándo:

  • Esperar: «Esperando hasta fecha y hora». Al cumplirse, el paso queda completado con la hora en que venció y la hora en que siguió.
  • Esperar evento: «Esperando el evento «nombre»» y, si tiene tiempo máximo, hasta cuándo («vence fecha y hora»). Desde ahí, quien tenga permiso usa Enviar señal. Al recibirla, el paso muestra de dónde llegó (portal, API o robot), cuándo y qué variables llenó; si venció, que siguió por la salida Vencida.

En el Registro del caso quedan las líneas de cada espera: cuándo empezó a esperar, cuándo venció, qué señal llegó y quién la envió (la persona, la cuenta de servicio o la ejecución del robot), o que el tiempo máximo venció sin señal.

Si un robot avisa que el caso no se puede procesar (un proveedor bloqueado, una factura duplicada) y el paso tiene una ruta de error de negocio, el caso no se detiene: sigue por esa ruta. En el detalle lo ves de un vistazo:

  • Un aviso arriba: «Paso» reportó un error de negocio → siguió por la ruta de error «nombre» hacia «paso siguiente», con el mensaje del robot y el botón Ver el paso.
  • El paso del robot queda como Error de negocio (ámbar), no como completado, y el punto de error muestra Ruta de error tomada.

Si el paso no tiene ruta de error, el caso queda Con incidente y la acción sugerida es Decidir: saltar o reintentar.

El Registro del caso junta en una sola línea de tiempo, lo más reciente primero, todo lo que le pasó al caso. Así entiendes un caso sin abrir cinco pantallas:

  • Lo que hizo el flujo y lo que hicieron las personas que lo operan (reintentos, pasos saltados, variables corregidas).
  • Los logs de cada ejecución de robot, con la actividad donde ocurrió cada cosa.
  • La vida de cada tarea: «Tarea creada para X», quién la tomó, qué decidió o si venció sin respuesta.
  • Cada llamada a la IA o a una API, con su duración y, en la IA, el modelo, los tokens, el costo y las Fuentes que citó de tus bases de conocimiento.

Cada entrada muestra de dónde viene, su nivel, la hora, el paso y el intento. Al hacer clic en una, el diagrama marca su paso. Con permiso para ver datos, puedes desplegar Lo que se envió y la Respuesta, y abrir Ver la ejecución o Ver la tarea. Mientras un robot corre, el registro muestra En vivo; Ver anteriores trae lo más antiguo.

Con Filtrar te quedas con lo que buscas: un Paso, un Nivel (Información, Aviso o Error), Solo errores o un Origen (Flujo, Robot, Persona, IA, Integración u Operador). Quitar filtros vuelve a mostrarlo todo.

Cuando un paso falla, el caso queda Con incidente y espera a que alguien elija qué hacer. Elige el paso en el diagrama: las acciones aparecen en su panel.

AcciónCuándo usarla
ReintentarEl problema ya se resolvió (el sistema volvió, corregiste un dato) y el paso se puede repetir.
Aplicar resultado tardíoEl robot terminó después de que el paso se diera por fallido. Aplicar su resultado hace que el caso siga como si hubiera llegado a tiempo.
SaltarEl caso debe seguir sin este paso, o debe terminar aquí.
Detener lo que sigue en cursoEl robot o la tarea del paso siguen vivos (por ejemplo, el robot no respondió a tiempo). Se detienen para poder reintentar sin que haya dos a la vez.
Editar variablesFalta un dato o está mal. Corrígelo y luego reintenta.
Cancelar casoEl caso no debe seguir.

Antes de repetir un paso, Zoan Cloud se pregunta si el paso pudo haberse ejecutado. Si es seguro que no (no llegó a enviarse), lo reintenta directamente. Si pudo haberse ejecutado (el robot terminó con error, se desconectó a mitad o una API no respondió), el aviso Reintentar: posible duplicado te pide revisar el sistema destino antes de confirmar con Reintentar de todas formas. Por ejemplo, si el robot alcanzó a registrar la factura en el ERP antes de fallar, repetirlo la registraría dos veces.

Si el robot o la tarea del paso siguen en curso, primero hay que detenerlos con Detener lo que sigue en curso.

Para que un robot se pueda repetir sin miedo, usa su clave de idempotencia. Ver Robots dentro de un flujo.

En Saltar «paso» eliges ¿Por qué salida sigue? cuando el paso tiene varias, o marcas Terminar el caso aquí y darlo por completado, que cierra los demás pasos abiertos. Si el paso debía dejar datos en las variables, edítalas antes para que lo que sigue tenga lo que necesita.

Al saltar una tarea de persona, elegir una decisión es decidir en nombre de la persona: solo puede hacerlo quien sea destinatario de la tarea, y la decisión queda guardada y protegida.

Editar variables está disponible cuando el caso tiene un incidente. Solo se guardan los campos que cambies; para borrar un valor, marca Quitar el valor. Queda registrado el valor anterior y el nuevo. Las variables protegidas (decisiones de personas) solo las cambia quien tenga el permiso de anulación. Después de guardar, reintenta el paso con error.

Cancelar caso detiene los pasos abiertos, incluidos los robots y las tareas en curso, y el caso queda cancelado. No se puede deshacer. Si el caso venía de una cola, su ítem queda fallido.

En Centro › Flujos › Incidentes están todos los casos detenidos por un error, agrupados por flujo, paso y motivo. Cada grupo muestra cuántos casos tiene, desde cuándo y una acción sugerida:

SugerenciaQué significa
ReintentarEl paso no llegó a ejecutarse: es seguro volver a intentarlo.
Revisar y reintentarEl paso pudo haberse ejecutado. Revisa en el sistema destino antes de repetirlo para no duplicar.
Aplicar resultado tardíoEl resultado llegó después del error: revísalo y aplícalo para seguir.
Corregir y reintentarFalta un dato o una configuración: corrígelo (variables o diagrama) y vuelve a intentar.
Decidir: saltar o reintentarEs un error de negocio: decide si el caso sigue sin este paso o si lo repites cuando esté resuelto.
Detener y reintentarEl robot sigue en curso o no respondió: detenlo primero y luego reintenta.
Actualizar la sesión de robotWindows rechazó la cuenta de la sesión de robot (contraseña, cuenta bloqueada o vencida). El robot no llegó a correr: corrige la sesión con Ir a Sesiones y reintenta sin miedo a duplicar.
IncidenteQué pasóQué hacer
timer_invalidEsperar, o el tiempo máximo de Esperar evento, toma la fecha de una variable que no tiene valor o no es una fecha válida.Corrige la variable con Editar variables y reintenta el paso.
timer_too_farLa fecha de Esperar cae a más de un año (366 días).Corrige la fecha o la variable y reintenta, o salta el paso.
message_expiredEsperar evento llegó a su tiempo máximo sin señal y el paso no tiene salida Vencida.Si el aviso ya llegó por otro medio, salta el paso dando las variables; si no, decide si el caso sigue o se cancela. Para que la próxima vez siga solo, agrega la salida Vencida y publica.

Desde cada grupo puedes Abrir el caso más antiguo o Ver todos los casos con incidente de ese flujo.

Cuando muchos casos fallaron por lo mismo (por ejemplo, el ERP estuvo caído una hora), los reintentas de una vez:

  1. Marca los grupos que quieres reintentar, o Elegir todos.
  2. Pulsa Reintentar lo elegido. Se reintentan hasta 100 pasos por vez; el resto queda para una segunda vez.
  3. En Resultado del reintento ves, paso por paso, cuáles se reintentaron y cuáles no, con el motivo.

Los pasos que pudieron haberse ejecutado no se repiten en el lote: quedan aparte para que los confirmes con Revisar y confirmar si aceptas un posible duplicado.

Centro › Flujos › Monitoreo te dice cómo les va a tus flujos para decidir dónde mejorar: cuántos casos entran, cuántos terminan bien, cuánto tardan y dónde se atascan. Se cuentan los casos que iniciaron en el período, con su estado de hoy.

  • Filtros: Período (7, 30 o 90 días, o Fechas con Desde y Hasta), Flujo y Agrupar (automático, por día o por semana).
  • Resumen: Casos iniciados, Terminaron bien, Duración típica de un caso (y en cuánto terminan 95 de cada 100), Detenidos por un error, Espera por personas y Costo por caso.
  • Detalle: los casos que entran por día o semana, cómo terminan, ¿Dónde se va el tiempo?, una tabla de pasos con su duración típica, el peor caso, la espera, los fallos y los Errores de negocio, ¿Qué falla más?, cuánto tardan las personas en decidir y, por flujo, el resultado y el costo de IA y de robot por caso.

Desde ahí saltas a Ver los casos o Ver incidentes.

  • Ejecuciones. Las ejecuciones de robot que lanzó un caso indican Lanzada por el flujo, con un enlace al caso.
  • Tareas. Las tareas que crea un caso indican Del flujo «nombre», con enlace al caso para quien puede verla.
  • Colas. Los ítems de una cola dedicada muestran el estado de su caso.