uip Insights 警示历史记录

"uip Insights Alert-history" 的语法和选项，可读取 UiPath Insights 警示触发器历史记录和每个间隔的触发器计数指标。

uip insights alert-history读取何时触发警示 — 触发器行和聚合的触发器计数指标 — 与警示相反，读取如何定义警示。

备注：

这些路由通过功能门控到云和专用 SaaS 部署。在其他部署类型上，该命令将失败，并显示 ConfigError，声明未提供路由，而不是提供空结果。

大纲

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>

所有动词都遵循全局选项和标准退出代码。两个动词都不接受 -t, --tenant — 它们使用在 uip login 期间选择的租户。

共享筛选条件

这两个动词都接受相同的筛选条件集：

标记	描述
--time-range <minutes>	现在结束的相对窗口（以分钟为单位）。实际上与 --since/--until 互斥 — 见下文。
--since <epoch-seconds>	绝对下限，即 Unix 历元秒（不是毫秒——作业使用毫秒）。
--until <epoch-seconds>	绝对上限，以 Unix 历元秒为单位。仅对 --since 有意义。
--alert-name <name>	筛选为一个警示名称。不得为空。
--folder-name <names...>	按文件夹名称（而非文件夹键）筛选，以空格分隔/可重复。
--severity <severities...>	按严重性筛选，以空格分隔/可重复：INFO、WARN、ERROR、NORMAL（保留NORMAL仅用于向后兼容）。

需要选择时间：通过 --time-range 或 --since（可以使用 --until）。两者均未通过则无法通过验证。--since 0/absent --since，仅 --until 将两者浮点设置为最早的可检索时间戳，而不是被拒绝。

重要提示：

服务器端最新1000行 (list) 的 ( ORDER BY Timestamp DESC LIMIT 1000 ) — 在有效负载本身中不可见。当正好返回 1000 行时，响应的 Instructions 字段会带有截断说明：真实的计数可能更大且未知。缩小 --time-range/--since+--until 范围或添加筛选条件以保持在上限以下，而不是相信返回的计数 1000 是准确的。

uip Insights 警示历史记录列表

从新到旧列出时间窗口中的警示触发器历史记录行。

选项

请参阅共享筛选器，以及：

标记	描述
-l, --limit <number>	要返回的最大行数。默认为 50。
-o, --offset <number>	返回结果之前要跳过的行。

分页是客户端通过后端响应（最多 1000 行）进行的。

示例

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

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

数据形状

{
  "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是 Unix 历元秒— 与--since / --until单位相同，与作业的毫秒字段不同。在 --folder-name 下，后端可以为每个匹配的文件夹发出一次相同的触发器，因此看起来相同的行可能是真实的不同事件，而不是重复项。

uip Insights 警示历史记录获取指标

获取每个时间间隔的警示触发器计数，并按警示类型分组。

选项

请参阅共享筛选器，以及：

标记	描述
--time-grouping <size>	必需。指标间隔的存储桶大小。

示例

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

数据形状

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

结果按警示类型分组：counts 为 groups 中的每个条目保存一行触发器计数，每个计数与 intervalEndTimes 中同一索引处的间隔结束时间配对。

相关内容

• 警示— 这些触发器引用的警示定义。
• Alert-Deliveries — 触发器通知 ( deliveryId ) 发送至的位置。

另请参阅

• Insights 概述