histórico-do-alerta do uip insights

Sintaxe e opções para o "uip insights alerta-history", que lê o histórico de gatilhos de alerta do UiPath Insights e métricas de contagem de gatilhos por intervalo.

uip insights alert-history lê quando os alertas foram disparados — linhas de gatilho e métricas agregadas de contagem de gatilhos — em vez de alertas, que lê como os alertas são definidos.

Observação:

Essas rotas são fechadas para implantações Cloud e SaaS dedicado. Em outros tipos de implantação, o comando falha com um ConfigError indicando que as rotas não são fornecidas, em vez de um resultado vazio.

Resumo

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 os verbos honram as opções globais e os códigos de saída padrão. Nenhum dos verbos aceita -t, --tenant — eles usam o tenant selecionado durante uip login.

Filtros compartilhados

Ambos os verbos aceitam o mesmo conjunto de filtros:

Bandeira	Description
--time-range <minutes>	Janela relativa termina agora, em minutos. mutuamente exclusivo em vigor com --since/--until — veja abaixo.
--since <epoch-seconds>	Limite inferior absoluto, segundos de época Unix (não milissegundos — trabalhos usa milissegundos).
--until <epoch-seconds>	Limite superior absoluto, segundos de época Unix. Importante apenas com --since.
--alert-name <name>	Filtre para um nome de alerta. Não pode estar vazio.
--folder-name <names...>	Filtrar por nome da pasta (não chave da pasta), separado por espaço/repetível.
--severity <severities...>	Filtrar por gravidade, separado por espaço/repetível: INFO, WARN, ERROR, NORMAL (NORMAL é mantido apenas para compatibilidade com versões anteriores).

É necessária uma seleção de tempo: passe --time-range ou --since (opcionalmente com --until). A aprovação de nenhuma das palavras falha na validação. --since 0/absent --since com apenas --until define ambos flutuantes para o carimbo de data/hora recuperável mais antigo em vez de serem rejeitados.

Importante:

list limites nas mais recentes 1.000 linhas no lado do servidor (ORDER BY Timestamp DESC LIMIT 1000) — isso é invisível na própria carga. Quando exatamente 1.000 linhas são retornadas, o campo Instructions da resposta traz uma observação de truncamento: a contagem verdadeira pode ser maior e desconhecida. Limite --time-range/--since+--until ou adicione filtros para permanecer abaixo do limite em vez de confiar em uma contagem retornada de 1000 como exata.

lista de histórico de alertas do uip insights

Liste as linhas de histórico de gatilhos de alerta em uma janela de tempo, da mais recente primeiro.

Opções

Consulte Filtros compartilhados e mais:

Bandeira	Description
-l, --limit <number>	Máximo de linhas a serem retornadas. O padrão é 50.
-o, --offset <number>	Linhas a ignorar antes de retornar resultados.

A paginação é do lado do cliente na resposta do backend (até 1.000 linhas).

Exemplos

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

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

Formato dos dados

{
  "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 é segundos epoch do Unix — a mesma unidade que --since/--until, ao contrário dos campos de milissegundos dos trabalhos. Em --folder-name, o backend pode emitir o mesmo gatilho uma vez por pasta correspondente, portanto, linhas de aparência idêntica podem ser eventos reais, distintos, em vez de duplicatas.

uip insights histórico de alertas get-metrics

Obtenha contagens de gatilhos de alerta por intervalo de tempo, agrupados por tipo de alerta.

Opções

Consulte Filtros compartilhados e mais:

Bandeira	Description
--time-grouping <size>	Obrigatório. Tamanho do bucket para os intervalos da métrica.

Exemplo

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

Formato dos dados

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

Os resultados são agrupados por tipo de alerta: counts contém uma linha de contagens de gatilhos por entrada em groups, e cada contagem está emparelhada com o horário de término do intervalo no mesmo índice em intervalEndTimes.

Relacionado

• alertas — as definições de alerta a que esses gatilhos referenciam.
• alerta-entrega — para onde a notificação de um gatilho (deliveryId) foi enviada.

Veja também

• Visão geral do Insights