Historial-de-alertas de UIP Insights

Sintaxis y opciones para `uip insights alerta-historial`, que lee el historial de desencadenadores de alertas de UiPath Insights y las métricas de recuento de desencadenadores por intervalo.

uip insights alert-history cuándo se activan las alertas (filas de desencadenador y métricas de recuento de desencadenadores agregadas) a diferencia de alertas, que lee cómo se definen las alertas.

Nota:

Estas rutas están controladas por características a las implementaciones en la nube y SaaS dedicado. En otros tipos de implementación, el comando falla con un ConfigError que indica que las rutas no se sirven, en lugar de un resultado vacío.

Sinopsis

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>

Todos los verbos respetan las opciones globales y los códigos de salida estándar. Ninguno de los verbos acepta -t, --tenant: utilizan el tenant seleccionado durante uip login.

Filtros compartidos

Ambos verbos aceptan el mismo conjunto de filtros:

Marca	Descripción
--time-range <minutes>	Ventana relativa que finaliza ahora, en minutos. Mutuamente excluyente en efecto con --since/--until — ver más abajo.
--since <epoch-seconds>	Límite inferior absoluto, segundos de época de Unix (no milisegundos: los trabajos utilizan milisegundos).
--until <epoch-seconds>	Límite superior absoluto, segundos de época de Unix. Solo significativo con --since.
--alert-name <name>	Filtrar a un nombre de alerta. No debe estar vacío.
--folder-name <names...>	Filtrar por nombre de carpeta (no clave de carpeta), separado por espacios/repetible.
--severity <severities...>	Filtrar por gravedad, separados por espacios/repetibles: INFO, WARN, ERROR, NORMAL (NORMAL se mantiene solo por compatibilidad con versiones anteriores).

Se requiere una selección de tiempo: pasar --time-range, o --since (opcionalmente con --until). Pasar ninguno falla la validación. --since 0/ausente --since con solo --until establece ambos flotantes en la marca de tiempo recuperable más antigua en lugar de ser rechazados.

Importante:

list límites en las 1000 filas más recientes del lado del servidor (ORDER BY Timestamp DESC LIMIT 1000): esto es invisible en la propia carga útil. Cuando se devuelven exactamente 1000 filas, el campo Instructions de la respuesta lleva una nota de truncamiento: el recuento real puede ser mayor y desconocido. Limite --time-range/--since+--until o añada filtros para permanecer por debajo del límite en lugar de confiar en un recuento devuelto de 1000 como exacto.

Lista de historial de alertas de UIP Insights

Enumerar las filas del historial de desencadenadores de alerta en una ventana de tiempo, las más recientes primero.

Opciones

Consulta Filtros compartidos y, además:

Marca	Descripción
-l, --limit <number>	Máximo de filas para devolver. El valor predeterminado es 50.
-o, --offset <number>	Filas a omitir antes de devolver resultados.

La paginación es del lado del cliente sobre la respuesta del backend (hasta 1000 filas).

Ejemplos

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

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

Forma de datos

{
  "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 son segundos de época de Unix: la misma unidad que --since/--until, a diferencia de los campos de milisegundos de los trabajos. En --folder-name, el backend puede emitir el mismo desencadenador una vez por carpeta coincidente, por lo que las filas de aspecto idéntico pueden ser eventos reales y distintos en lugar de duplicados.

UIP Insights: historial de alertas, obtención de métricas

Obtenga recuentos de desencadenadores de alerta por intervalo de tiempo, agrupados por tipo de alerta.

Opciones

Consulta Filtros compartidos y, además:

Marca	Descripción
--time-grouping <size>	Obligatorio. Tamaño del depósito para los intervalos de la métrica.

Ejemplo

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

Forma de datos

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

Los resultados se agrupan por tipo de alerta: counts contiene una fila de recuentos de desencadenadores por entrada en groups, y cada recuento se empareja con la hora de finalización del intervalo en el mismo índice en intervalEndTimes.

Relacionado

• alertas : las definiciones de alerta a las que hacen referencia estos desencadenadores.
• entregas-alerta : donde se envió una notificación de desencadenador (deliveryId).

Ver también

• Descripción general de Insights