UIP-Maestro-Auftrag

uip maestro job überprüft einen einzelnen Maestro-Auftrag – einen Ausführungsversuch einer Prozessinstanz –, indem seine Traces streamen oder seinen detaillierten Status abrufen.

Alle Unterbefehle erfordern uip login und berücksichtigen globale Optionen. Austrittscodes folgen dem Standardvertrag.

Zusammenfassung

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

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

uip Maestro-Auftragsablaufverfolgungen

Streamen Sie Ausführungs-Trace-Ereignisse für einen laufenden oder kürzlich abgeschlossenen Auftrag.

Argumente

• <job-key> (erforderlich) – Auftragsschlüssel (GUID von process run).

Optionen

Option	Standard	Beschreibung
-t, --tenant <name>	authentifizierten Mandanten	Mandantenname.
--poll-interval <ms>	2000	Abrufintervall. Muss eine positive Zahl sein.
--traces-service <name>	llmopstenant_	Ablaufverfolgungendienstname.
--pretty	aus	Zitierte Trace-Ereignisse. Ohne diese wird jedes Ereignis als einzelne JSON-Zeile ausgegeben.
--login-validity <minutes>	10	Schwellenwert für die Tokenaktualisierung.

Verhalten

• Schreibt eine Überschrift: Streaming traces for job: <key> Polling every Ns...
• Streams jedes Trace-Ereignis über ScreenLogger.progress (stderr).
• Nach Abschluss wird Job <key>: <finalState> (<durationMs>ms) ausgegeben.
• Exitcode: 0 bei result.success, andernfalls 1 .

Beispiele

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

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

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

Ausgabe: Ablaufverfolgungen werden direkt gestreamt – keine endgültige Data -Nutzlast.

uip Maestro-Auftragsstatus

Rufen Sie den Status eines Maestro-Auftrags ab. Gibt standardmäßig eine kuratierte 14-Felder-Zusammenfassung zurück; --detailed gibt die vollständige Orchestrator-Antwort zurück.

Argumente

• <job-key> (erforderlich) – Auftragsschlüssel (GUID).

Optionen

Option	Standard	Beschreibung
-t, --tenant <name>	authentifizierten Mandanten	Mandantenname.
--folder-key <key>	authentifizierten Ordner	Ordnerschlüssel (GUID).
--detailed	aus	Gibt die vollständige Antwort anstelle der 14-Felder-Zusammenfassung zurück.
--login-validity <minutes>	10	Schwellenwert für die Tokenaktualisierung.

Data shape (default summary)

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

Mit --detailed ist Data das vollständige Orchestrator-Auftragsobjekt.

Beispiele

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

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

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

Siehe auch

• uip maestro process run – Einen Auftrag starten
• uip maestro instance – Die Instanzansicht derselben Ausführung
• Orchestrator-Aufträge
• Maestro-Übersicht