uip Maestro bpmn 作业

"uip Maestro bpmn job" 的语法和选项，可流式传输单个 Maestro BPMN 作业的执行追踪记录并获取详细状态。

uip maestro bpmn job通过流式传输其追踪或获取其详细状态，检查单个Maestro 作业（流程实例的一次执行尝试）。它已在 bpmn 分支下注册。

所有子命令都需要uip login并遵循全局选项。退出代码遵循标准合同。

大纲

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-key> （必填） — 作业密钥（来自process run GUID）。

选项

选项	默认	描述
-f, --folder-key <key>	—	文件夹密钥 (GUID)。可选 — 仅用于确定追踪请求的范围。
--poll-interval <ms>	2000	轮询间隔。必须为正数。
--traces-service <name>	llmopstenant_	Traces 服务名称。
--pretty	关闭	美化追踪事件。否则，每个事件都将作为单个 JSON 行发出。
--login-validity <minutes>	10	令牌刷新阈值。

行为

• 写入标题行： Streaming traces for job: <key> Polling every Ns...
• 通过ScreenLogger.progress (stderr) 流式传输每个追踪事件。
• 完成后，发出Job <key> completed with state <finalState> (<durationMs>ms) 。
• 退出代码：如果result.success 0则为 ；否则，为1 。

示例

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

输出：直接流式传输追踪记录 — 没有最终的Data有效负载。

uip Maestro bpmn 作业状态

获取 Maestro 作业的状态。默认情况下返回策划的 14 个字段的摘要； --detailed返回完整的 Orchestrator 响应。

参数

• <job-key> （必填） — 作业密钥 (GUID)。

选项

选项	必填	默认	描述
--folder-key <key>	是	—	文件夹密钥（GUID，来自 process list）。无默认值 — 每次调用都必须显式传递。
--detailed	否	关闭	返回完整的响应，而不是包含 14 个字段的摘要。
--login-validity <minutes>	否	10	令牌刷新阈值。

数据形状（默认摘要）

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

对于--detailed ， Data是完整的 Orchestrator 作业对象。

示例

# 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

另请参阅

• uip maestro bpmn process run — 开始作业
• uip maestro bpmn instance — 同一执行的实例视图
• Orchestrator 作业
• Maestro 概述