trabajos de uip insights

Sintaxis y opciones para `trabajos de uip insights`, que expone los paneles de Insights preestablecidos como comandos filtrables por intervalo de tiempo y carpeta.

uip insights jobs los paneles preestablecidos de Insights como comandos CLI. Cada subcomando se publica en un punto final de Insights dedicado y devuelve la respuesta sin procesar en el sobre estándar Code/Data . Los siete subcomandos comparten la misma superficie de filtro (rango de tiempo, carpetas, procesos, máquinas).

Sinopsis

uip insights jobs <verb> [options]

Verbos

Verbo	Propósito
summary	Recuento total de trabajos, recuento correcto, tiempo medio de procesamiento.
completed-timeline	Trabajos completados a lo largo del tiempo, agrupados por estado terminal.
uncompleted-timeline	Trabajos no completados (en ejecución/pendientes) a lo largo del tiempo.
top-failures	Procesos con más fallos de trabajo.
failures-by-reason	Errores de trabajo agrupados por motivo de excepción.
process-details	Desglose de trabajos por proceso con recuentos por estado.
failure-details	Filas de fallos detalladas para la investigación detallada.

Filtros compartidos

Cada subcomando insights jobs acepta las mismas opciones:

Marca	Descripción
--time-range <minutes>	Intervalo de tiempo relativo en minutos (por ejemplo 1440 durante 1 día, 43200 durante 30 días).
--started-after <epoch-ms>	Hora de inicio absoluta como epoch Unix en milisegundos.
--started-before <epoch-ms>	Hora de finalización absoluta como epoch Unix en milisegundos.
--folder-key <guid>	Filtro de clave de carpeta (repetible).
--process-name <name>	Filtro de nombre de proceso (repetible).
--machine-name <name>	Filtro de nombre de máquina (repetible).
--timezone-offset <minutes>	Desplazamiento de la zona horaria del cliente en minutos con respecto a UTC.

Se requiere un intervalo de tiempo: pase --time-range, o --started-after y --started-before juntos. Proporcionar solo uno de --started-after/--started-before es lo mismo que no proporcionar ninguno: el comando falla con A time range is required. y sale de 1. Combinar --time-range con el par absoluto es válido, pero el backend de Insights se resuelve en el intervalo que sea más estrecho. Cualquier otro filtro (--folder-key, --process-name, --machine-name, --timezone-offset) es opcional; --folder-key, --process-name y --machine-name son repetibles: pásalos varias veces para incluir varios valores.

Las opciones enteras (--time-range, --started-after, --started-before, --timezone-offset) se validan en el momento del análisis; un valor no numérico falla rápidamente con un mensaje que nombra el marcador.

Resumen de trabajos de UIP Insights

Recuento total de trabajos, recuento correcto y tiempo medio de procesamiento.

Opciones

Consulta Filtros compartidos.

Ejemplos

uip insights jobs summary --time-range 1440

uip insights jobs summary \
    --process-name Invoicing --process-name Payroll --time-range 43200

uip insights jobs summary --time-range 1440 \
    --output-filter 'Data.{total:TotalJobs, success:SuccessfulJobs}'

Código de respuesta: InsightsJobsSummary.

UIP Insights Jobs Completed-Timeline

Trabajos completados a lo largo del tiempo, agrupados por estado de trabajo terminal.

Opciones

Consulta Filtros compartidos.

Ejemplos

uip insights jobs completed-timeline --time-range 10080

uip insights jobs completed-timeline \
    --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
    --time-range 1440 --timezone-offset -480

uip insights jobs completed-timeline \
    --started-after 1714003200000 --started-before 1714608000000

Código de respuesta: InsightsJobsCompletedTimeline.

Línea de tiempo incompleta de trabajos de UIP Insights

Trabajos no completados (en ejecución/pendientes) a lo largo del tiempo.

Opciones

Consulta Filtros compartidos.

Ejemplos

uip insights jobs uncompleted-timeline --time-range 1440

uip insights jobs uncompleted-timeline \
    --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
    --folder-key f0f0f0f0-0000-0000-0000-000000000002

uip insights jobs uncompleted-timeline --time-range 1440 \
    --machine-name prod-worker-01

Código de respuesta: InsightsJobsUncompletedTimeline.

Trabajos de UIP Insights: fallos principales

Procesos con más fallos en la ventana de filtro.

Opciones

Consulta Filtros compartidos.

Ejemplos

uip insights jobs top-failures --time-range 43200

uip insights jobs top-failures --time-range 10080 \
    --folder-key f0f0f0f0-0000-0000-0000-000000000001

uip insights jobs top-failures --time-range 43200 \
    --output-filter 'Data[].{process:ProcessName, count:FailureCount}'

Código de respuesta: InsightsJobsTopFailures.

Errores de trabajos de uip insights por motivo

Errores de trabajo agrupados por motivo de excepción.

Opciones

Consulta Filtros compartidos.

Ejemplos

uip insights jobs failures-by-reason --time-range 43200

uip insights jobs failures-by-reason --time-range 1440 \
    --process-name Invoicing

uip insights jobs failures-by-reason --time-range 10080 \
    --output-filter 'Data[].{reason:Reason, count:Count}'

Código de respuesta: InsightsJobsFailuresByReason.

Detalles del proceso de trabajos de UIP Insights

Desglose de trabajos por proceso con recuentos por estado.

Opciones

Consulta Filtros compartidos.

Ejemplos

uip insights jobs process-details --process-name Invoicing --time-range 1440

uip insights jobs process-details --time-range 43200 \
    --folder-key f0f0f0f0-0000-0000-0000-000000000001

uip insights jobs process-details \
    --process-name Invoicing --process-name Payroll \
    --started-after 1714003200000 --started-before 1714608000000

Código de respuesta: InsightsJobsProcessDetails.

Detalles de fallo de trabajos de UIP Insights

Filas de fallos detalladas para la investigación detallada.

Opciones

Consulta Filtros compartidos.

Ejemplos

uip insights jobs failure-details --process-name Invoicing --time-range 1440

uip insights jobs failure-details --time-range 10080 \
    --machine-name prod-worker-01

uip insights jobs failure-details --time-range 1440 \
    --output-filter 'Data[].{job:JobKey, reason:Reason, ts:StartTime}'

Código de respuesta: InsightsJobsFailureDetails.

Forma de datos (--json de salida)

Todos los comandos devuelven el mismo sobre. El campo Data lleva la respuesta de Insights específica del punto final: la estructura interna difiere según el punto final, pero la envolvente es uniforme.

{
  "Code": "InsightsJobsSummary",
  "Data": { "...": "endpoint-specific payload" }
}

Nota:

La estructura interna exacta de cada variante de respuesta está especificada por la API de Insights y no se enumera aquí. Ejecuta el comando una vez con --output json en un tenant con datos para ver el esquema que consumirás y ancla @uipath/cli en CI si analizas campos específicos.

Comportamiento de error

• Falta la autenticación. La CLI emite Failure con Instructions: "Run 'uip login' to authenticate first." y sale 1.
• Errores de backend (4xx/5xx de Insights). Failure con Instructions: "Check your authentication, tenant, and filter parameters." y sale de 1.

Relacionado

• uip insights : descripción general de la herramienta.
• uip login : sesión utilizada para cada llamada de Insights.
• uip traces — Intervalos de observabilidad de LLM, una superficie de observabilidad ortogonal.

Ver también

• Opciones globales
• Códigos de salida