uip maestro flow job

Syntax and options for `uip maestro flow job`, which streams execution traces and fetches detailed status for individual Flow jobs.

uip maestro flow job un trabajo de flujo individual (un intento de ejecución de una instancia de proceso) transmitiendo sus seguimientos u obteniendo su estado detallado.

Todos los subcomandos requieren uip login y respetan las opciones globales. Los códigos de salida siguen el contrato estándar.

Sinopsis

uip maestro flow job traces <job-key>
                    [-t, --tenant <name>] [--poll-interval <ms>]
                    [--traces-service <name>] [--pretty]
                    [--login-validity <minutes>]

uip maestro flow job status <job-key>
                    [-t, --tenant <name>] [--folder-key <key>] [--detailed]
                    [--login-validity <minutes>]

uip maestro flow job traces

Transmite eventos de seguimiento de ejecución para un trabajo en ejecución o completado recientemente. Las líneas se transmiten a stderr a medida que llegan; el estado final y la duración también se transmiten.

Argumentos

• <job-key> (obligatorio) : clave de trabajo (GUID de process run).

Opciones

Opción	Predeterminado	Descripción
-t, --tenant <name>	tenant autenticado	Nombre del tenant.
--poll-interval <ms>	2000	Intervalo de sondeo. Debe ser un número positivo.
--traces-service <name>	llmopstenant_	Nombre del servicio de seguimiento (avanzado; anular solo cuando se le indique).
--pretty	Desactivado	Eventos de seguimiento de impresión bonita. Sin él, cada evento se emite como una sola línea JSON, fácil de canalizar a jq.
--login-validity <minutes>	10	Umbral de actualización del token.

Comportamiento

• Escribe una línea de encabezado en stderr: Streaming traces for job: <key> Polling every Ns...
• Transmite cada evento de seguimiento a través de ScreenLogger.progress (stderr).
• Al finalizar, emite Job <key>: <finalState> (<durationMs>ms).
• Código de salida: 0 si el trabajo se realizó correctamente, 1 de lo contrario (según result.success).

Ejemplos

# Raw JSON lines — best for piping
uip maestro flow job traces b2c3d4e5-… | jq -c 'select(.level=="error")'

# Human-readable
uip maestro flow job traces b2c3d4e5-… --pretty

# Slower polling for quiet jobs
uip maestro flow job traces b2c3d4e5-… --poll-interval 5000

Salida: los seguimientos se transmiten directamente, sin carga útil final Data .

uip maestro flow job status

Obtener el estado de un trabajo de flujo. Devuelve un resumen seleccionado de 14 campos de forma predeterminada; --detailed devuelve la respuesta completa de Orchestrator.

Argumentos

• <job-key> obligatorio) : clave de trabajo (GUID).

Opciones

Opción	Predeterminado	Descripción
-t, --tenant <name>	tenant autenticado	Nombre del tenant.
--folder-key <key>	carpeta autenticada	Clave de carpeta (GUID).
--detailed	Desactivado	Devuelve la respuesta completa en lugar del resumen de 14 campos.
--login-validity <minutes>	10	Umbral de actualización del token.

Forma de datos (resumen predeterminado)

{
  "Code": "FlowJobStatus",
  "Data": {
    "key":             "b2c3d4e5-…",
    "state":           "Successful",
    "runtimeType":     "…",
    "processType":     "Flow",
    "startTime":       "2025-04-15T10:30:00Z",
    "endTime":         "2025-04-15T10:32:11Z",
    "creationTime":    "2025-04-15T10:29:58Z",
    "inputArguments":  "{}",
    "outputArguments": "{}",
    "info":            "",
    "releaseName":     "InvoiceFlow",
    "processKey":      "a1b2c3d4-…",
    "robotName":       "…",
    "hostMachineName": "…"
  }
}

Con --detailed, Data es el objeto de trabajo de Orchestrator completo (todos los campos, sin aplanar).

Nota:

La forma de respuesta detallada completa es lo que devuelve Orchestrator y no está estrictamente tipada por la CLI. La presencia de campo puede variar entre versiones de Orchestrator: para scripts que analizan campos específicos, consulta de forma defensiva y fija @uipath/cli en CI.

Ejemplos

# Start a job, capture the key, stream traces to completion
JOB_KEY=$(uip maestro flow process run "InvoiceFlow.flow.Flow:1.0.0" "<folder-key>" \
           --inputs '{}' --output-filter "jobKey" --output plain)
uip maestro flow job traces "$JOB_KEY" --pretty

# Get the summary once the job is done
uip maestro flow job status "$JOB_KEY" --folder-key "<folder-key>"

# Full response
uip maestro flow job status "$JOB_KEY" --detailed

Ver también

• uip maestro flow process run — iniciar un trabajo
• uip maestro flow instance : la vista de instancia de la misma ejecución
• Trabajos de Orchestrator
• Descripción general del flujo