UIP Insights-Aufträge

Syntax und Optionen für „UIP Insights Jobs“, die voreingestellte Insights-Dashboards als Befehle bereitstellen, die nach Zeitbereich und Ordner gefiltert werden können.

uip insights jobs macht die voreingestellten Insights-Dashboards als CLI-Befehle verfügbar. Jeder Unterbefehl postet an einen dedizierten Insights-Endpunkt und gibt die unformatierte Antwort im Standardumschlag Code/Data zurück. Alle sieben Unterbefehle haben dieselbe Filteroberfläche (Zeitbereich, Ordner, Prozesse, Maschinen).

Zusammenfassung

uip insights jobs <verb> [options]

Verben

Verb	Zweck
summary	Gesamtanzahl der Aufträge, Anzahl der erfolgreichen Aufträge, durchschnittliche Verarbeitungszeit.
completed-timeline	Abgeschlossene Aufträge im Laufe der Zeit, gruppiert nach Endstatus.
uncompleted-timeline	Nicht abgeschlossene (laufende/ausstehende) Aufträge im Laufe der Zeit.
top-failures	Prozesse mit den meisten Auftragsfehlern.
failures-by-reason	Auftragsfehler, gruppiert nach Ausnahmegrund.
process-details	Aufschlüsselung der Aufträge pro Prozess mit Anzahl nach Status.
failure-details	Detaillierte Fehlerzeilen für die Drill-down-Unterprüfung.

Freigegebene Filter

Jeder insights jobs -Unterbefehl akzeptiert die gleichen Optionen:

Markieren	Beschreibung
--time-range <minutes>	Relativer Zeitbereich in Minuten (z. B 1440 für 1 Tag, 43200 für 30 Tage).
--started-after <epoch-ms>	Absolute Startzeit als Unix-Epoche in Millisekunden.
--started-before <epoch-ms>	Absolute Endzeit als Unix-Epoche in Millisekunden.
--folder-key <guid>	Ordnerschlüsselfilter (wiederholbar).
--process-name <name>	Prozessnamensfilter (wiederholbar).
--machine-name <name>	Filter für Maschinenname (wiederholbar).
--timezone-offset <minutes>	Offset der Client-Zeitzone in Minuten von UTC.

Ein Zeitbereich ist erforderlich: --time-range oder sowohl --started-after als auch --started-before zusammen. Wenn nur eines von --started-after/--started-before angegeben wird, ist dasselbe wie die Angabe von keinem – der Befehl schlägt mit A time range is required. fehl und beendet 1. Die Kombination von --time-range mit dem absoluten Paar ist gültig, aber das Insights-Back-End wird auf das kleinere Intervall aufgelöst. Jeder andere Filter (--folder-key, --process-name, --machine-name, --timezone-offset) ist optional; --folder-key, --process-name und --machine-name sind wiederholbar – übergeben Sie sie mehrmals, um mehrere Werte einzuschließen.

Integer-Optionen (--time-range, --started-after, --started-before, --timezone-offset) werden zur Parsezeit validiert; Ein nicht numerischer Wert schlägt schnell mit einer Nachricht zum Benennen des Flags fehl.

Zusammenfassung der UIP Insights-Aufträge

Gesamtanzahl der erfolgreichen Aufträge und durchschnittliche Verarbeitungszeit.

Optionen

Siehe Freigegebene Filter.

Beispiele

uip insights jobs summary --time-range 1440

uip insights jobs summary \
    --process-name Invoicing --process-name Payroll --time-range 43200

uip insights jobs summary --time-range 1440 \
    --output-filter 'Data.{total:TotalJobs, success:SuccessfulJobs}'

Antwortcode: InsightsJobsSummary.

UIP Insights-Aufträge abgeschlossen – Zeitleiste

Abgeschlossene Aufträge im Laufe der Zeit, gruppiert nach Endauftragsstatus.

Optionen

Siehe Freigegebene Filter.

Beispiele

uip insights jobs completed-timeline --time-range 10080

uip insights jobs completed-timeline \
    --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
    --time-range 1440 --timezone-offset -480

uip insights jobs completed-timeline \
    --started-after 1714003200000 --started-before 1714608000000

Antwortcode: InsightsJobsCompletedTimeline.

UIP Insights-Aufträge nicht abgeschlossen – Zeitleiste

Nicht abgeschlossene (laufende/ausstehende) Aufträge im Laufe der Zeit.

Optionen

Siehe Freigegebene Filter.

Beispiele

uip insights jobs uncompleted-timeline --time-range 1440

uip insights jobs uncompleted-timeline \
    --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
    --folder-key f0f0f0f0-0000-0000-0000-000000000002

uip insights jobs uncompleted-timeline --time-range 1440 \
    --machine-name prod-worker-01

Antwortcode: InsightsJobsUncompletedTimeline.

Häufigste Fehler bei UIP Insights-Aufträgen

Prozesse mit den meisten Fehlern im Filterfenster.

Optionen

Siehe Freigegebene Filter.

Beispiele

uip insights jobs top-failures --time-range 43200

uip insights jobs top-failures --time-range 10080 \
    --folder-key f0f0f0f0-0000-0000-0000-000000000001

uip insights jobs top-failures --time-range 43200 \
    --output-filter 'Data[].{process:ProcessName, count:FailureCount}'

Antwortcode: InsightsJobsTopFailures.

Fehler bei UIP Insights-Aufträgen nach Grund

Auftragsfehler, gruppiert nach Ausnahmegrund.

Optionen

Siehe Freigegebene Filter.

Beispiele

uip insights jobs failures-by-reason --time-range 43200

uip insights jobs failures-by-reason --time-range 1440 \
    --process-name Invoicing

uip insights jobs failures-by-reason --time-range 10080 \
    --output-filter 'Data[].{reason:Reason, count:Count}'

Antwortcode: InsightsJobsFailuresByReason.

UIP Insights-Aufträge – Prozessdetails

Aufschlüsselung der Aufträge pro Prozess mit Anzahl nach Status.

Optionen

Siehe Freigegebene Filter.

Beispiele

uip insights jobs process-details --process-name Invoicing --time-range 1440

uip insights jobs process-details --time-range 43200 \
    --folder-key f0f0f0f0-0000-0000-0000-000000000001

uip insights jobs process-details \
    --process-name Invoicing --process-name Payroll \
    --started-after 1714003200000 --started-before 1714608000000

Antwortcode: InsightsJobsProcessDetails.

Fehlerdetails für UIP Insights-Aufträge

Detaillierte Fehlerzeilen für die Drill-down-Unterprüfung.

Optionen

Siehe Freigegebene Filter.

Beispiele

uip insights jobs failure-details --process-name Invoicing --time-range 1440

uip insights jobs failure-details --time-range 10080 \
    --machine-name prod-worker-01

uip insights jobs failure-details --time-range 1440 \
    --output-filter 'Data[].{job:JobKey, reason:Reason, ts:StartTime}'

Antwortcode: InsightsJobsFailureDetails.

Datenform (--output json)

Alle Befehle geben denselben Umschlag zurück. Das Feld Data enthält die endpunktspezifische Insights-Antwort – die innere Struktur unterscheidet sich je nach Endpunkt, aber der Umschlag ist einheitlich.

{
  "Code": "InsightsJobsSummary",
  "Data": { "...": "endpoint-specific payload" }
}

Hinweis:

Die genaue innere Struktur jeder Antwortvariante wird von der Insights-API angegeben und ist hier nicht aufgeführt. Führen Sie den Befehl einmal mit --output json für einen Mandanten mit Daten aus, um das Schema anzuzeigen, das Sie nutzen, und heften Sie @uipath/cli in CI an, wenn Sie bestimmte Felder parsen.

Fehlerverhalten

• Fehlende Authentifizierung. Die CLI gibt Failure mit Instructions: "Run 'uip login' to authenticate first." aus und beendet 1.
• Backend-Fehler (4xx/5xx aus Insights). Failure mit Instructions: "Check your authentication, tenant, and filter parameters." und beendet 1.

Zugehörig

• uip insights – Toolübersicht.
• uip login – Sitzung, die für jeden Insights-Aufruf verwendet wird.
• uip traces – LLM-Beobachtungsspannen, eine übergeordnete Beobachtbarkeitsoberfläche.

Siehe auch

• Globale Optionen
• Exitcodes