Sobre a ferramenta de diagnóstico

A Ferramenta de Diagnóstoco UiPath é um utilitário independente, que possibilita que você colete melhor e pré-visualize as informações de diagnóstico, as quais são, então, empacotadas e podem ser enviadas para nossa equipe de suporte técnico para ajudá-lo a resolver possíveis problemas.

Ela vem agrupada com uma série de coletores para ajudá-lo a reunir somente as informações que precisar. Além disso, é possível salvar os coletores selecionados como um perfil para ser usado mais tarde. As informações podem ser coletadas do Studio, do Robô, RobotJS, Atividades e Orchestrator.

Você pode baixar a Ferramenta de Diagnóstico a partir do Centro de Recursos de sua instância do Automation Cloud.

Ele também vem instalado com o Studio, e você pode encontrá-lo na pasta %localappdata%\Programs\UiPath\Studio (para as instalações por máquina) ou na pasta C:\Program Files\UiPath\Studio (para as instalações por usuário).

Para acessá-lo, basta clicar no botão Iniciar e procurar pelo aplicativo Ferramenta de Diagnóstico.

A Seção Iniciar

A Ferramenta de Diagnóstico se baseia em perfis, a qual reúne informações usando os coletores. Um perfil consiste em um conjunto de coletores especializados em reunir informações específicas, dependendo dos problemas que você tiver. A ferramenta vem com alguns perfis predefinidos, cada qual com um conjunto específico de coletores. Porém, também é possível criar seus próprios perfis, cada qual adequado para um problema em particular. Mesmo que você comece com um perfil predefinido, mais tarde você poderá adicionar ou remover coletores, dependendo de quais informações precisarem ser reunidas.

Perfil	Description
Problema do Studio/Robot/Activities	Reúne informações sobre o Studio, o Robô ou Atividades. Por padrão, esse perfil vem com vários coletores habilitados.
Problema do Orchestrator	Reúne informações sobre sua conexão com o Orchestrator. Por padrão, esse perfil vem com vários coletores habilitados.
Perfil em Branco	Esse perfil não vem com nenhum coletor selecionado. Aqui é onde você pode criar perfis personalizados com os coletores desejados para usar posteriormente.
Local Personalizado	Reúne informações com base em um arquivo .json a ser fornecido por você. Você pode selecionar os coletores a serem usados.

Adicionalmente, você pode optar por importar um pacote .zip de dados coletados gerado anteriormente para revisar.

A seção Configurar

Esta seção é onde se encontram todos os coletores. Os dois primeiros perfis já vêm com vários coletores adicionados a eles, mas você poderá também adicionar outros ou remover os existentes. Os coletores disponíveis são como segue:

Coletor	Informações reunidas
Informações de Registro	Chaves de registro usadas, bem como o nome e os dados de valor correspondentes.
Informações da Tela	Monitor ou monitores usados, bem como o tipo, resolução, DPI e as coordenadas da função de Deslocamento.
Logs de Evento	Gera um arquivo de log .evtxpara o aplicativo selecionado. Esse coletor pode ser usado com os seguintes filtros: • Período (número de dias) • Nível do evento • SourcesFilter (lista de origens de aplicativos separadas por vírgula)
Variáveis de Ambiente	Variáveis de ambiente local ou de sistema usadas, com base em uma cláusula configurável.
Informações do Computador	Nome, domínio, sistema operacional, seção, administrador e configurações do proxy da máquina.
Arquivos de Log	Execução, Studio, ETL e logs combinados. Eles podem ser visualizados e exportados de cada seção.
Informações de Processo	O sistema processa os usados.
Instalações de Terceiros	Relaciona todos os aplicativos de terceiros usados.
Instalações do UiPath	Relaciona todos os produtos UiPath instalados naquela máquina, bem como a versão, o tipo e o caminho.
Licença	Exibe o tipo e o status da licença.
Arquivo de Configurações	Relaciona os arquivos UiPath.settings, UiStudio.settings, UiStudio.v2.settings, e NuGet.config disponíveis com a possibilidade de acessá-los.
Configurações da Web para o Orchestrator	Exibe o arquivo Web.config, com base no local da Chave do Registro especificada e seu valor.
Arquivo Host do Aplicativo do Orchestrator	Exibe o arquivo applicationhost.config, com base em uma pasta especificada.
Arquivos	Obtém os arquivos a partir de um DirectoryPath especificado com um Patternconfigurável.
Registro personalizado	Recupera chaves do registro usadas, assim como o nome do valor correspondente e os dados de valores a partir de um caminho personalizado.

Caso não fique satisfeito com os coletores fornecidos de um perfil, basta removê-los, clicando no botão x, no contêiner do coletor correspondente.

Se você pensa que precisa de mais coletores, clique no botão Adicionar um Novo Coletor e escolha o que precisar da lista.

Considerando que você deseja usar alguns coletores várias vezes, você pode adicioná-los à lista e clique no botão Exportar Perfil para o Arquivo. Isso irá gerar um arquivo .json que mais tarde você poderá importar da seção Iniciar.

Alguns coletores permitem que as informações sejam visualizadas de maneira mais detalhada.

Por exemplo, o coletor Arquivos de Log permite explorar os arquivos coletados de um tipo de log (ExecutionLogs, o StudioLogs, o EtlLogs ou CombinedLogs) em uma janela separada, com a possibilidade de visualizar o caminho de um arquivo de log, abrí-lo ou mesmo escolher quais arquivos de log a serem exportados.

De igual modo, o coletor Informações de Registro exibe somente os primeiros resultados na seção de Pré-visualização, mas permite que você visualize todos os resultados em uma janela separada, clicando no botão Exibir x de y, sendo que ali o x corresponde ao número de resultados exibido e o y ao total.

A Seção de Pré-visualização

Este é o local onde todas as informações coletadas são exibidas. Elas são agrupadas em caixas expansíveis para facilitar a leitura. Se você não estiver satisfeito com coletores específicos, basta que os desabilite para que não sejam exportados para o pacote final.

Os coletores que você não considerar necessário para exportar podem ser desabilitados aqui. Basta desmarcar os coletores desejados antes de clicar em Avançar.

A Seção Exportar

A última seção mostra uma pré-visualização dos coletores usados no processo. Tudo o que restará a fazer agora é clicar em Exportar para salvar todos os dados coletados em um pacote .zip, com a possibilidade de abrir o local onde o arquivo estiver salvo. Você também pode navegar entre as seções se quiser fazer alterações nos coletores.

Argumentos da Linha de Comando

A Ferramenta de Diagnóstico pode ser usada a partir do Prompt de Comando ou do Windows PowerShell. Os argumentos e seus resultados serão os mesmos, independentemente do modo de uso.

Eles podem ser acessados da seguinte maneira:

• Prompt de Comando ─ abra uma instância elevada do Prompt de comando e use o comando cd no local da Ferramenta de Diagnóstico. Em seguida, use um dos argumentos relacionados abaixo.
• Windows PowerShell ─ navegue até o local da Ferramenta de Diagnóstico, clique com o botão direito do mouse sobre ela e escolha abrir no PowerShell. Em seguida, use nos argumentos relacionados abaixo.

Exemplo:

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

Argumento	Description
run studio	Executa o perfil padrão do Studio.
run orchestrator	Executa o perfil padrão do Orchestrator.
run <pathToFile>	Executa um personalizado que foi criado anteriormente, perfil de diagnóstico personalizado de um arquivo .json gerado.
-o, --output	Especifica a saída do pacote .zip gerado, que contém todos os dados coletados.

Geração de um relatório de ferramenta de diagnóstico

Para gerar um relatório de ferramenta de diagnóstico:

1. Clique em Iniciar e pesquise o aplicativo de ferramenta de diagnóstico do UiPath.
2. Selecione as opções apropriadas na seção Iniciar e clique em Avançar.
3. Configure os dados na seção Configurar e clique em Coletar.
   Observação: uma janela de confirmação para excluir o progresso atual aparece ao clicar em Anterior.
4. Revise os dados na seção Visualização e clique em Avançar.
5. Clique em Exportar na seção Exportar.
6. Salve o arquivo .zip gerado em sua máquina.
7. Enviar o arquivo .zip gerado para a equipe de suporte técnico.