uip insights - alertes-historique

Syntaxe et options de `uip insights alert-history`, qui lit l'historique des déclencheurs d'alertes UiPath Insights et les mesures du nombre de déclencheurs par intervalle.

uip insights alert-history lit lorsque les alertes sont déclenchées — lignes de déclencheur et métriques agrégées sur le nombre de déclencheurs — par opposition aux alertes, qui lisent la façon dont les alertes sont définies.

Remarque :

Ces routages sont limités aux déploiements Cloud et SaaS dédiés. Sur les autres types de déploiement, la commande échoue avec une ConfigError indiquant que les routages ne sont pas servis, plutôt qu'un résultat vide.

Synthèse

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>

Tous les verbes respectent les options globales et les codes de sortie standard. Aucun verbe n'accepte -t, --tenant — il utilise le locataire sélectionné lors de uip login.

Filtres partagés

Les deux verbes acceptent le même ensemble de filtres:

Drapeau	Description
--time-range <minutes>	Fenêtre relative se terminant maintenant, en minutes. mutuellement exclusif en vigueur avec --since/--until — voir ci-dessous.
--since <epoch-seconds>	Limite inférieure absolue, secondes d’époque Unix (pas millisecondes — les tâches utilisent des millisecondes).
--until <epoch-seconds>	Limite supérieure absolue, secondes d’époque Unix. Uniquement significatif avec --since.
--alert-name <name>	Filtrez sur un seul nom d'alerte. Ne doit pas être vide.
--folder-name <names...>	Filtrer par nom de dossier (pas clé de dossier), séparé par des espaces/répétable.
--severity <severities...>	Filtrer par gravité, séparé par des espaces/répétable: INFO, WARN, ERROR, NORMAL (NORMAL est conservé uniquement à des fins de rétrocompatibilité).

Une sélection d'heure est requise: saisissez --time-range ou --since (facultatif avec --until). La réussite de la validation se fait. --since 0/absent --since avec seulement --until définissent les deux flottants sur l'horodatage récupérable le plus ancien plutôt que d'être rejetés.

Important :

list se termine au niveau des 1000 lignes les plus récentes côté serveur (ORDER BY Timestamp DESC LIMIT 1000) — ceci est invisible dans la charge utile elle-même. Lorsqu'exactement 1 000 lignes sont renvoyées, le champ Instructions de la réponse comporte une note de coupure: le nombre réel peut être plus important et inconnu. Affinez --time-range/--since+--until ou ajoutez des filtres pour rester sous le plafond plutôt que de vous fier à un décompte exact de 1000.

uip insights - liste de l’historique des alertes

Répertorie les lignes de l'historique des déclencheurs d'alerte dans une fenêtre temporelle, la plus récente en premier.

Options

Voir les filtres partagés, plus:

Drapeau	Description
-l, --limit <number>	Nombre maximal de lignes à renvoyer. La valeur par défaut est 50.
-o, --offset <number>	Lignes à ignorer avant de renvoyer des résultats.

La pagination est côté client sur la réponse principale (jusqu'à 1 000 lignes).

Exemples

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

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

Format des données

{
  "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 correspond aux secondes d'époque Unix — la même unité que --since/--until, contrairement aux champs millisecondes des tâches. Sous --folder-name, le backend peut émettre le même déclencheur une fois par dossier correspondant, de sorte que les lignes d'apparence identique peuvent être des événements réels et distincts plutôt que des doublons.

uip insights - alertes-historiques - get-metrics

Obtenez le nombre de déclencheurs d'alertes par intervalle de temps, regroupés par type d'alerte.

Options

Voir les filtres partagés, plus:

Drapeau	Description
--time-grouping <size>	Requis. Taille du compartiment pour les intervalles de métriques.

Exemple

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

Format des données

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

Les résultats sont regroupés par type d'alerte: counts contient une ligne de nombres de déclencheurs par entrée dans groups, et chaque nombre est associé à l'heure de fin de l'intervalle au même index dans intervalEndTimes.

Associé

• alertes — les définitions d'alertes auxquelles ces déclencheurs sont associés.
• alert-deliveries - où la notification d'un déclencheur (deliveryId) a été envoyée.

Voir également

• Vue d’ensemble d’Insights