Uso del paquete de soporte de Automation Suite

Información general

El paquete de soporte de Automation Suite recopila registros a nivel de aplicación de los servicios de UiPath® y los objetos relevantes necesarios para evaluar y solucionar el problema. El paquete de soporte de Automation Suite también contiene registros históricos que puedes utilizar para analizar patrones al solucionar un problema. Los registros históricos son especialmente útiles cuando la posible causa raíz de un problema no es evidente con solo observar el estado del clúster.

El paquete de soporte de Automation Suite también es necesario cuando se solicita orientación o una solución al equipo de soporte de UiPath®, ya que lo necesitan para fines de análisis.

Nota:

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

Parámetros de la herramienta Paquete de soporte de Automation Suite

• La telemetría de uso y configuración resumida de alto nivel también se exporta con esta herramienta generando un archivo XML. Esta telemetría incluye:
  • Detalles de configuración de la instalación de Automation Suite (como el tipo de Kubernetes, el modo de instalación, la versión y los servicios habilitados, entre otros ajustes).
  • Información de uso de recursos a nivel de clúster (como disponibilidad y utilización de CPU y memoria, entre otras métricas).
  • Detalles de ejecución del comando UiPathctl (como estado, registros y duración, entre otros detalles).
  • Telemetría de uso:
    • 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.
• UiPath utiliza estos datos solo para informes internos para reforzar la comprensión del cliente y mejorar la calidad del soporte y la experiencia general.
• Puedes cargar el archivo XML en el Customer Portal para compartir tu telemetría de uso autoalojado de alto nivel con el equipo de soporte de UiPath.
• Puedes dejar de generar telemetría resumida añadiendo service-metrics a la lista de exclusiones con la opción --exclude=service-metrics . Esta opción está disponible en Automation Suite 2.2510 y posteriores.

Generando el paquete de soporte

Para generar el paquete de soporte, ejecuta el siguiente comando desde el directorio del instalador:

./bin/uipathctl health bundle cluster_config.json --versions versions/helm-charts.json

A partir de Automation Suite 2.2510.1, las rutas al archivo de configuración (cluster_config.json) y los parámetros del archivo de versiones (helm-charts.json) son opcionales. Puedes generar el paquete de soporte simplemente ejecutando:

./bin/uipathctl health bundle

Esta herramienta requiere algo de tiempo para recopilar y almacenar todos los registros en una ubicación temporal en tu máquina local o de gestión.

La siguiente tabla enumera los marcadores opcionales que puedes utilizar para la herramienta del 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--exclude=rke2-bundle o --exclude=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.

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 --days no se especifica, los registros históricos se recopilarán durante 2 días a partir de la fecha de inicio especificada.

El paquete RKE2 se incluye de forma predeterminada en el paquete de soporte. Para excluirlo, utilizaflag --exclude=rke2-bundle.

Los registros históricos no se incluyen de forma predeterminada en el paquete de soporte. Para incluirlos, utiliza el marcador --include=historical-logs.

Estructura del paquete de soporte de Automation Suite

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

Archivo/carpeta	Descripción
logs	Contiene los registros históricos recopilados de ceph o del almacén de objetos externo.
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.
server0.tar.gz, server1.tar.gz, ...	Contiene el paquete RKE2 para cada nodo del 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 configuración y uso de alto nivel almacenada en archivos XML individuales.

La estructura del paquete RKE2 es la siguiente:

Directorio	Descripción
systemlogs	Contiene los registros relacionados con los eventos del sistema, las auditorías de seguridad y los mensajes generales del sistema.
systeminfo	Contiene información sobre los procesos en ejecución, el uso del disco, la utilización de la CPU, etc.
etcd	Contiene la información relacionada con el almacenamiento de datos del almacén de clave-valor etcd .
journald	Contiene los registros gestionados por systemd-journald.
networking	Contiene los detalles de configuración de la red, como iptables, enrutamiento, etc.
rke2	Contiene los registros de kubelet, los certificados de agente y servidor, información sobre crictl y los recursos que se ejecutan en el clúster y los registros del pod.