uip maestro bpmn job

Syntax and options for `uip maestro bpmn job`, which streams execution traces and fetches detailed status for individual Maestro BPMN jobs.

uip maestro bpmn job inspects an individual Maestro job — one execution attempt of a process instance — by streaming its traces or fetching its detailed status. It's registered under the bpmn branch.

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

Sinopsis

uip maestro bpmn job traces <job-key>
                       [-f, --folder-key <key>] [--poll-interval <ms>]
                       [--traces-service <name>] [--pretty]
                       [--login-validity <minutes>]

uip maestro bpmn job status <job-key>
                       --folder-key <key> [--detailed]
                       [--login-validity <minutes>]

uip maestro bpmn job traces

Transmite eventos de seguimiento de ejecución para un trabajo en ejecución o completado recientemente.

Argumentos

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

Opciones

Opción	Predeterminado	Descripción
-f, --folder-key <key>	—	Folder key (GUID). Optional — used only to scope the trace request.
--poll-interval <ms>	2000	Intervalo de sondeo. Debe ser un número positivo.
--traces-service <name>	llmopstenant_	Nombre del servicio de seguimiento.
--pretty	Desactivado	Eventos de seguimiento de impresión bonita. Sin él, cada evento se emite como una sola línea JSON.
--login-validity <minutes>	10	Umbral de actualización del token.

Comportamiento

• Escribe una línea de encabezado: 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> completed with state <finalState> (<durationMs>ms).
• Código de salida: 0 si result.success, 1 de lo contrario.

Ejemplos

# Raw JSON lines
uip maestro bpmn job traces b2c3d4e5-… | jq -c 'select(.level=="error")'

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

# Slower polling
uip maestro bpmn job traces b2c3d4e5-… --poll-interval 5000

# Scope the trace request to a folder
uip maestro bpmn job traces b2c3d4e5-… --folder-key <folder-key>

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

uip maestro bpmn job status

Obtener el estado de un trabajo de Maestro. 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	Obligatorio	Predeterminado	Descripción
--folder-key <key>	Sí	—	Folder key (GUID, from process list). No default — every call must pass it explicitly.
--detailed	No	Desactivado	Devuelve la respuesta completa en lugar del resumen de 14 campos.
--login-validity <minutes>	No	10	Umbral de actualización del token.

Forma de datos (resumen predeterminado)

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

Con --detailed, Data es el objeto de trabajo completo de Orchestrator.

Ejemplos

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

# Summary once done
uip maestro bpmn job status "$JOB_KEY" --folder-key "<folder-key>"

# Full response
uip maestro bpmn job status "$JOB_KEY" --folder-key "<folder-key>" --detailed

Ver también

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