Ejecutar la herramienta de paquete de soporte

La herramienta del paquete de soporte de Automation Suite recopila registros a nivel de aplicación de los servicios de UiPath® y otros componentes de software, como Istio, ArgoCD, etc. La herramienta del paquete de soporte de Automation Suite también contiene registros históricos que puedes utilizar para analizar patrones al solucionar un problema. Los registros detallados son particularmente útiles cuando la posible causa raíz de un problema no es evidente con solo mirar el estado del clúster.

La herramienta del paquete de soporte de Automation Suite también es necesaria al solicitar orientación o una solución al equipo de soporte de UiPath®, ya que la necesita para fines de análisis.

Nota:

La herramienta del paquete de soporte de Automation Suite no recopila ni almacena ningún PII o datos confidenciales de ti, tu usuario o tu automatización. Las aplicaciones de UiPath® no filtran ni registran ninguna información confidencial en sus registros. En el nivel de plataforma, el recopilador de registros está diseñado para enmascarar cualquier información crítica de este tipo.

La telemetría de uso resumida de alto nivel también se exporta con esta herramienta generando un archivo XML. Esta telemetría incluye:

• Duración de la ejecución del robot por mes por tipo de robot.

• Simultaneidad de robots: el número máximo de robots que se ejecutan al mismo tiempo.

• Métricas sobre trabajos ejecutados, procesos ejecutados, elementos en cola, tasa de fallos de trabajo y usuarios.

• Información del entorno.

• Resumen de uso AI Units si utilizas AI Center.

Puedes cargar el archivo XML en el Customer Portal para compartir tu telemetría de uso autohospedado de alto nivel con el equipo de soporte de UiPath.

Puede optar por no generar esta telemetría resumida enumerando service-metrics en la lista de excluidos en Automation Suite 2024.10 y superior.

Generando el paquete de soporte

Para generar el paquete de soporte, ejecuta el siguiente comando:

./uipathctl health bundle input.json --versions version.json

Esta herramienta tarda un tiempo en recopilar y almacenar todos los registros en una ubicación temporal en su máquina local / de administración.

La siguiente tabla enumera los marcadores opcionales que admite la herramienta de paquete de soporte:

Banderas	Descripción
--output-dir string	Especifique el directorio para almacenar el paquete de soporte.
--namespace string	Especifique el espacio de nombres donde se implementa UiPath Automation Suite.
--include string	Especifica componentes adicionales (separados por comas) para incluir en el paquete (como --include=historical-logs).
--exclude string	Especifica los componentes (separados por comas) para excluir del paquete (como service-metrics).
--from YYYY-MM-DD	La fecha de inicio para recopilar los registros históricos en formato AAAA-MM-DD.
--days int	El número de días desde la fecha de inicio para los que se recopilarán los registros históricos.
--limit-bytes int	Limita el tamaño de los registros de los pods en ejecución proporcionando el valor entero en bytes.

Nota:

• De forma predeterminada, si no se especifica el marcador --from , los registros históricos se recopilarán durante los últimos 2 días a partir de hoy, independientemente del --days especificado.
• Si se especifica --from y no se especifica --days , los registros históricos se recopilarán durante 2 días a partir de la fecha de inicio especificada.

Estructura del paquete de soporte de Automation Suite

El archivo .tar.gz contiene los siguientes archivos y carpetas:

Archivo/carpeta	Descripción
current-logs	Contiene los registros en vivo (como los registros de la instancia actual y anterior de los pods).
events.json	Contiene las descripciones de eventos de todos los espacios de nombres.
alerts	Contiene las alertas de Prometheus activas en el clúster.
namespace/resource/object.yaml	Contiene las descripciones de objetos para el espacio de nombres preferido/personalizado del servidor y los recursos del ámbito del clúster.
service-metrics	Contiene telemetría de uso de alto nivel almacenada en archivos XML individuales.

Nota:

Los registros históricos no son compatibles con los entornos EKS/AKS.