Estados y ciclo de vida

Una ejecución es cada vez que se ejecuta un proceso en un agente. Desde que se crea hasta que termina, recorre una serie de estados bien definidos. Conocerlos te permite saber, de un vistazo, qué está pasando y por qué.

El ciclo de vida

stateDiagram-v2
  [*] --> queued
  queued --> running
  queued --> cancelled: cancelada antes de empezar
  running --> completed: terminó bien
  running --> failed: terminó con error
  running --> cancelled: cancelada en ejecución
  completed --> [*]
  failed --> [*]
  cancelled --> [*]

Estado	Descripción	Cómo se llega
`queued`	En cola, esperando a que el agente seleccionado la reciba	Al crear la ejecución (manual o por trigger)
`running`	El agente está ejecutando el proceso	El agente recibe la orden y empieza
`completed`	Finalizó con éxito (código de salida 0)	El playbook terminó sin errores
`failed`	Finalizó con error	Error en el playbook, código de salida ≠ 0, o desconexión del agente
`cancelled`	Cancelada manualmente antes de terminar	Un usuario la canceló desde el portal

Cada estado en detalle

`queued`

La ejecución existe pero el agente seleccionado aún no la ha recibido. Normalmente dura segundos. Si se queda aquí, ese agente suele estar offline o busy. Ver Monitoreo de agentes.

`running`

El agente descargó el paquete y está ejecutando el playbook. Aquí ves los logs en tiempo real. El estado del agente que la ejecuta aparece como busy.

`completed`

El playbook llegó al final sin lanzar un error y devolvió código de salida 0. Es el resultado esperado de una ejecución sana.

`failed`

Algo impidió completar la ejecución. Las causas típicas:

Una actividad lanzó un error no controlado (un selector que no aparece, un archivo que no existe, una credencial que no resuelve).
El playbook terminó con un código de salida distinto de 0.
El agente se desconectó durante la ejecución y no reconectó dentro del período de gracia.

Revisa siempre los logs para ver la causa exacta.

`cancelled`

Un usuario detuvo la ejecución manualmente desde el portal antes de que terminara. Útil para cortar un proceso que se quedó colgado o que se lanzó por error.

Reintentos

Desconexión del agente

Si el agente que está procesando una ejecución pierde la conexión con Nexus y no reconecta dentro de un período de gracia (~3 minutos), la ejecución se marca como failed automáticamente. Esto evita que una ejecución quede “colgada” indefinidamente si la máquina se apaga o se cae la red.

Es un tiempo distinto al que tarda el agente en mostrarse offline (~2 minutos sin heartbeat). Uno vigila la salud del agente; el otro, el destino de una ejecución concreta.

Tiempo de ejecución

La plataforma no impone un límite de duración: un proceso puede tardar segundos u horas según lo que haga. El detalle de la ejecución muestra su duración total una vez terminada.

Siguientes pasos

Logs de ejecución — diagnosticar qué ocurrió.
Ejecutar manualmente — reintentar tras un fallo.
Monitoreo de agentes — por qué algo se queda en queued.