Warnungsverlauf von UIP Insights

Syntax und Optionen für „uip insights Alert-history“, die den Verlauf des UiPath Insights-Warnungstriggers und die Metriken pro Intervall pro Intervall liest.

uip insights alert-history liest, wann Warnungen ausgelöst werden – Triggerzeilen und aggregierte Trigger-Anzahl-Metriken – im Gegensatz zu Alerts, bei denen gelesen wird, wie Warnungen definiert sind.

Hinweis:

Diese Routen sind funktionsgesteuert für Cloud- und dedizierte SaaS-Bereitstellungen. Bei anderen Bereitstellungstypen schlägt der Befehl mit einem ConfigError fehl, der angibt, dass die Routen nicht bereitgestellt werden, anstatt mit einem leeren Ergebnis.

Zusammenfassung

uip insights alert-history list [--time-range <minutes> | --since <epoch-seconds> [--until <epoch-seconds>]] [--alert-name <name>] [--folder-name <names...>] [--severity <severities...>] [-l <n>] [-o <n>]
uip insights alert-history get-metrics [--time-range <minutes> | --since <epoch-seconds> [--until <epoch-seconds>]] [--alert-name <name>] [--folder-name <names...>] [--severity <severities...>] --time-grouping <size>

Alle Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes. Keines der Verben akzeptiert -t, --tenant – sie verwenden den während uip login ausgewählten Mandanten.

Freigegebene Filter

Beide Verben akzeptieren denselben Filtersatz:

Markieren	Beschreibung
--time-range <minutes>	Relatives Fenster, das jetzt endet, in Minuten. Sich gegenseitig ausschließend mit --since/--until – siehe unten.
--since <epoch-seconds>	Absolute untere Grenze, Unix- Epochensekunden (nicht Millisekunden – Aufträge verwenden Millisekunden).
--until <epoch-seconds>	Absolute Obergrenze, Unix-Epochensekunden. Nur aussagekräftig mit --since.
--alert-name <name>	Filtern Sie nach einem Warnungsnamen. Darf nicht leer sein.
--folder-name <names...>	Filtern nach Ordnername (kein Ordnerschlüssel), durch Leerzeichen getrennt/wiederholbar.
--severity <severities...>	Filtern nach Schweregrad, durch Leerzeichen getrennt/wiederholbar: INFO, WARN, ERROR, NORMAL (NORMAL wird nur für die Abwärtskompatibilität beibehalten).

Eine Zeitauswahl ist erforderlich: Übergeben Sie --time-range oder --since (optional mit --until). Wenn keines von beiden bestanden ist, schlägt die Validierung fehl. --since 0/abwesend --since mit nur --until legen beide auf den ältesten abrufbaren Zeitstempel fest, anstatt abgelehnt zu werden.

Wichtig:

list begrenzt die neuesten 1000 Zeilen auf der Serverseite (ORDER BY Timestamp DESC LIMIT 1000) – dies ist in der Nutzlast selbst nicht sichtbar. Wenn genau 1000 Zeilen zurückgegeben werden, enthält das Instructions -Feld der Antwort einen Kürzungshinweis: Die „true“-Anzahl kann größer und unbekannt sein. Enge --time-range/--since+--until oder fügen Sie Filter hinzu, um unter der Obergrenze zu bleiben, anstatt einer zurückgegebenen Anzahl von 1000 als genau zu vertrauen.

UIP Insights Alert-History-Liste

Listen Sie den Warnungstriggerverlauf in einem Zeitfenster auf, neueste zuerst.

Optionen

Siehe Freigegebene Filter, plus:

Markieren	Beschreibung
-l, --limit <number>	Maximale Anzahl zurückzugebender Zeilen. Die Standardeinstellung ist 50.
-o, --offset <number>	Zeilen, die übersprungen werden sollen, bevor Ergebnisse zurückgegeben werden.

Die Paginierung erfolgt clientseitig über die Backend-Antwort (bis zu 1000 Zeilen).

Beispiele

uip insights alert-history list --time-range 1440

uip insights alert-history list \
  --since 1714003200 --until 1714608000 \
  --severity ERROR WARN

Datenform

{
  "Code": "InsightsAlertHistoryList",
  "Data": [
    {
      "alertId": 42,
      "alertName": "High failure rate",
      "triggeredAt": 1714003200,
      "severity": "ERROR",
      "operator": "GreaterThan",
      "threshold": 5,
      "metric": "FailedJobCount",
      "metricState": "Failed",
      "deliveryId": 7
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

triggeredAt sind Unix- Epochensekunden – die gleiche Einheit wie --since/--until, im Gegensatz zu den Millisekundenfeldern von Aufträgen. Unter --folder-name kann das Back-End denselben Trigger einmal pro übereinstimmendem Ordner ausgeben, sodass identisch aussehende Zeilen echte, unterschiedliche Ereignisse und keine Duplikate sein können.

UIP Insights Alert-History Get-Metrics

Rufen Sie die Anzahl der Warnungstrigger pro Zeitintervall ab, gruppiert nach Warnungstyp.

Optionen

Siehe Freigegebene Filter, plus:

Markieren	Beschreibung
--time-grouping <size>	Erforderlich. Bucket-Größe für die Metrikintervalle.

Beispiel

uip insights alert-history get-metrics --time-range 10080 --time-grouping day

Datenform

{
  "Code": "InsightsAlertHistoryMetrics",
  "Data": {
    "groups": ["High failure rate", "SLA breach"],
    "intervalEndTimes": [1714003200, 1714089600],
    "counts": [[2, 5], [0, 1]]
  }
}

Die Ergebnisse werden nach Warnungstyp gruppiert: counts enthält eine Zeile von Triggeranzahlen pro Eintrag in groups und jede Anzahl ist mit der Intervallendzeit zum selben Index in intervalEndTimes gekoppelt.

Zugehörig

• Alerts – Die Warnungsdefinitionen, auf die diese Trigger verweisen.
• Alert-Deliveries – wo die Benachrichtigung eines Triggers (deliveryId) gesendet wurde.

Siehe auch

• Insights-Übersicht