Acerca de la herramienta de diagnóstico

La herramienta de diagnóstico de UiPath es una utilidad independiente, que te permite recopilar y obtener una mejor vista previa de la información de diagnóstico, que luego se empaqueta y puede enviarse a nuestro equipo de soporte técnico para ayudarte a resolver posibles problemas.

Se incluye con una variedad de recopiladores para ayudarte a obtener solo la información que necesitas. Además, puedes guardar los recopiladores seleccionados como perfil para utilizarlo más tarde. La información puede recopilarse desde Studio, Robot, RobotJS, Actividades y Orchestrator.

Puedes descargar la herramienta de diagnóstico desde el Centro de recursos en tu instancia de Automation Cloud.

También viene instalado con Studio, y puedes encontrarlo en la carpeta C:\Program Files\UiPath\Studio (para las instalaciones por máquina) o en la carpeta %localappdata%\Programs\UiPath\Studio(para las instalaciones por usuario).

Para acceder a ella, basta con hacer clic en el botón Inicio y buscar la aplicación Herramientas de diagnóstico.

La sección Iniciar

Las Herramientas de diagnóstico se basan en perfiles, que reúnen información mediante recopiladores. El perfil es un conjunto de recopiladores especializados en la recogida de información específica, dependiendo de las incidencias que tengas. La herramienta viene con un par de perfiles predefinidos, cada uno con un conjunto de recopiladores específicos, pero también es posible crear tus propios perfiles, cada uno adecuado para un problema concreto. Incluso si lo inicias con un perfil predefinido, puedes añadir o eliminar recopiladores en función de la información que haya que recopilar.

Perfil	Descripción
Problema con Studio/Robot/Actividades	Recopila información sobre Studio, Robot o Actividades. Este perfil viene con varios recopiladores habilitados de forma predeterminada.
Problema de Orchestrator	Recopila información sobre tu conexión a Orchestrator. Este perfil viene con varios recopiladores habilitados de forma predeterminada.
Perfil vacío	Este perfil no viene con ninguno recopilador seleccionado. Aquí está donde puedes crear perfiles personalizados con los recopiladores deseados para utilizarlos más tarde.
Ubicación personalizada	Recopila información basada en un archivo .json que suministra. Puedes seleccionar los recopiladores que vas a utilizar.

Además, puedes elegir importar un paquete .zip generado previamente con los datos recopilados que se van a revisar.

La sección Configurar

Esta sección es donde se encuentran todos los recopiladores. A los dos primeros perfiles ya se han añadido varios recopiladores, pero también puedes añadir otros o eliminar los existentes. Los recopiladores disponibles son los siguientes:

Recopilador	Información recopilada
Información del registro	Las claves de registro utilizadas, así como el nombre del valor y de los datos del valor correspondientes.
Información de pantalla	Pantalla o pantallas utilizadas, así como el tipo, la resolución, los PPP y las coordenadas de desplazamiento.
Registros de evento	Genera un archivo de registro .evtx para la aplicación seleccionada. Este colector puede utilizarse con los siguientes filtros: • Período (número de días) • Nivel del evento • FiltroDeFuentes (lista de fuentes de aplicaciones separadas por comas)
Variables de entorno	Variables del sistema o del entorno local utilizadas, basado en una cláusula configurable.
Información del ordenador	Nombre, sistema operativo, sesión, administrador y configuración del proxy de la máquina.
Archivos de registro	Ejecución, Studio, ETL y registros combinados. Se pueden ver y exportar desde cada sección.
Información del proceso	Procesos del sistema utilizado.
Instalaciones de terceros	Enumera todas las aplicaciones de terceros utilizadas.
Instalaciones de UiPath	Enumera todos los productos de UiPath instalados en esa máquina, así como la versión, el tipo y la ruta.
Licencia	Muestra el estado y el tipo de licencia.
Archivo de configuración	Enumera los archivos disponibles UiStudio.v2.settings, NuGet.config, UiPath.settings y UiStudio.settings con la posibilidad de acceder a ellos.
Configuración web de Orchestrator	Muestra el archivo Web.config, basado en la ubicación de la clave de registro especificada y su valor.
Archivo de host de aplicaciones de Orchestrator	Muestra el archivo applicationhost.config basado en una carpeta especificada.
Archivos	Obtiene los archivos de una DirectoryPath especificada con una Pattern configurable.
Registro personalizado	Recupera las claves de registro utilizadas, así como el nombre del valor correspondiente y los datos del valor de una ruta personalizada.

Si no estás satisfecho con los recopiladores proporcionados de un perfil, simplemente puedes eliminarlos haciendo clic en el botón x del contenedor del recopilador correspondiente.

Si quieres más recopiladores, haz clic en el botón Añadir un nuevo recopilador y elige el que necesites de la lista.

Si consideramos que quieres usar varios recopiladores varias veces, puedes añadirlos a la lista y hacer clic en el botón Exportar perfil a archivo. Se genera un archivo .json que puedes importar posteriormente desde la sección Iniciar.

Algunos recopiladores te permiten ver la información de forma más detallada.

Por ejemplo, el recopilador Archivos de registro te permite explorar los archivos recopilados de un tipo de registro (ExecutionLogs, StudioLogs, EtlLogs o CombinedLogs) en una ventana independiente, con la posibilidad de ver la ruta de acceso de un archivo de registro, abrirlo o incluso elegir cuál de los archivos de registro se va a exportar.

De forma similar, el recopilador Información del registro solo muestra los primeros resultados en la sección Vista previa, pero te permite ver todos los resultados en una ventana independiente, haciendo clic en el botón Mostrando x de y filas, donde la x es el número de resultados que se muestra y la y, el total.

La sección Vista previa

Aquí es donde se muestra toda la información recopilada. Se agrupan en cuadros plegables para que la información sea fácil de leer. Si no estás satisfecho con los recopiladores específicos, puedes deshabilitarlos para que no se exporten al paquete final.

Los recopiladores que no se consideran necesarios para la exportación pueden ser deshabilitados aquí. Basta con desmarcar los recopiladores deseados antes de hacer clic en Siguiente.

La sección Exportar

La última sección muestra una vista previa de los recopiladores utilizados en el proceso. Todo lo que queda por hacer es hacer clic en Exportar para guardar todos los datos recopilados en el paquete .zip, con la posibilidad de abrir la ubicación donde se guarda el archivo. También puedes navegar entre las secciones si quieres realizar cambios en los recopiladores.

Argumentos de la línea de comandos

La Herramienta de diagnóstico también puede utilizarse desde el Símbolo del sistema o desde Windows PowerShell. Los argumentos y sus resultados son los mismos, independientemente del modo de utilización.

Se puede acceder a él de este modo:

• Símbolo del sistema: abre una instancia del sistema elevado con privilegios elevados y utiliza el comando cd en la ubicación de la herramienta de diagnóstico. Luego, usa uno de los argumentos que figuran a continuación.
• Windows PowerShell: navega a la ubicación de la Herramienta de diagnóstico y elige abrirla en PowerShell. A continuación, utiliza uno de los argumentos que figuran a continuación.

Ejemplo:

UiPath.DiagnosticTool.exe run <[defaultProfile] | [pathToProfile> [Optional Parameter]

Argumento	Descripción
run studio	Ejecuta el perfil predeterminado de Studio.
run orchestrator	Ejecuta el perfil predeterminado de Orchestrator.
run <pathToFile>	Ejecuta un perfil de diagnóstico personalizado previamente creado de un archivo .json generado.
-o, --output	Especifica la salida del paquete .zip generado que contiene todos los datos recopilados.

Generar un informe de herramienta de diagnóstico

Para generar un informe de herramienta de diagnóstico:

1. Haz clic en Iniciar y busca la aplicación UiPath Diagnostics Tool.
2. Selecciona las opciones adecuadas en la sección Iniciar y haz clic en Siguiente.
3. Configura los datos en la sección Configurar y haz clic en Recopilar.
   Nota: una ventana de confirmación para eliminar el progreso actual aparece al hacer clic en Anterior.
4. Revisa los datos en la sección Vista previa y haz clic en Siguiente.
5. Haz clic en Exportar en la sección Exportar.
6. Guarda el archivo .zip generado en tu máquina.
7. Envía el archivo .zip generado al equipo de soporte técnico.