Trabalho de bpmn do uip Maestro

Sintaxe e opções para o trabalho "uip Maestro bpmn job", que transmite traces de execução e busca o status detalhado para trabalhos BPMN individuais do Maestro.

uip maestro bpmn job inspeciona um trabalho individual do Maestro — uma tentativa de execução de uma instância de processo — transmitindo seus traces ou buscando seu status detalhado. Ele está registrado na ramificação bpmn.

Todos os subcomandos exigem uip login e honram as opções globais. Os códigos de saída seguem o contrato padrão.

Resumo

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>]

rastreamentos de trabalho bpmn do uip Maestro

Eventos de trace de execução de transmissão para um trabalho em execução ou concluído recentemente.

Argumentos

• <job-key> (necessário) — chave do trabalho (GUID de process run).

Opções

Opção	Padrão	Description
-f, --folder-key <key>	—	Chave da pasta (GUID). Opcional — usado apenas para delimitar a solicitação de trace.
--poll-interval <ms>	2000	Intervalo de pesquisa. Deve ser um número positivo.
--traces-service <name>	llmopstenant_	Nome do serviço de traces.
--pretty	desativada	Eventos de trace de impressão virtual. Sem ele, cada evento é emitido como uma única linha JSON.
--login-validity <minutes>	10	Limite de atualização do token.

Comportamento

• Escreve uma linha de cabeçalho: Streaming traces for job: <key> Polling every Ns...
• Transmite cada evento de trace por meio de ScreenLogger.progress (stderr).
• Na conclusão, emite Job <key> completed with state <finalState> (<durationMs>ms).
• Código de saída: 0 se result.success, caso contrário, 1 .

Exemplos

# 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>

Saída: os traces são transmitidos diretamente — sem carga Data .

status do trabalho bpmn do uip Maestro

Obtenha o status de um trabalho do Maestro. Retorna um resumo de 14 campos selecionado por padrão; --detailed retorna a resposta completa do Orchestrator.

Argumentos

• <job-key> necessário) — chave do trabalho (GUID).

Opções

Opção	Required	Padrão	Description
--folder-key <key>	sim	—	Chave da pasta (GUID, de process list). Nenhum padrão — cada chamada deve passá-lo explicitamente.
--detailed	não	desativada	Retornar a resposta completa em vez do resumo de 14 campos.
--login-validity <minutes>	não	10	Limite de atualização do token.

Formato dos dados (resumo padrão)

{
  "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": "…"
  }
}

Com --detailed, Data é o objeto de trabalho completo do Orchestrator.

Exemplos

# 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

Veja também

• uip maestro bpmn process run — iniciar um trabalho
• uip maestro bpmn instance — a visualização de instância da mesma execução
• Trabalhos do Orchestrator
• Visão geral do Maestro