Realizar verificações diagnósticas do Agente de bot

Use o utilitário de diagnóstico do Agente de bot para problemas relacionados com a conectividade entre o dispositivo Executor de bots e a Control Room. O utilitário ajuda a diagnosticar problemas, fornecendo soluções ou sugestões para ajudar a resolver os problemas.

Pré-requisitos

Certifique-se de que o Agente de bot esteja instalado no dispositivo do usuário.

Procedimento

  1. Abra o prompt de comando do Windows.
  2. Acesse o caminho de instalação do Agente de bot.
    • O caminho padrão para o Agente de bot instalado no sistema é C:\Program Files\Automation Anywhere\Bot Agent.
    • O caminho padrão para o Agente de bot instalado no usuário local é %USERPROFILE%\AppData\Local\Programs\Automation Anywhere\Bot Agent.
  3. Insira AADiagnosticUtility.exe para executar o utilitário de diagnóstico do Agente de bot.
    São exibidas diversas opções, acompanhadas de suas descrições, para realizar a verificação diagnóstica.
    Opção Descrição
    -checkDownloadError <CR_URL> Verifique a existência de erros de download de dependência do bot se houver falhas na implantação do bot.
    Nota: As mensagens de erro são mantidas na memória do dispositivo e removidas quando o serviço Agente de bot for reiniciado.

    Use esta opção quando o dispositivo Executor de bots for conectado à Control Room, mas as automações falharem devido a pacotes dependentes que não foram baixados no dispositivo Executor de bots. Neste caso, o utilitário oferece sugestões para mais diagnósticos.
    -checkProxy <CR_URL> Verifique as configurações de proxy no dispositivo.

    Quando o dispositivo Executor de bots for incapaz de se conectar à Control Room, use esta opção para verificar se um proxy está disponível ou configurado para uso pelo Agente de bot.

    Você também tem a opção de importar configurações de proxy usando a opção importProxy.

    Nota: As definições de proxy do seu dispositivo para proxy autenticado podem ser definidas durante o processo de registro do Agente de bot e podem ser atualizadas por meio do utilitário de diagnóstico Agente de bot. As mesmas credenciais são utilizadas para todos os usuários do dispositivo.
    -checkWSError <CR_URL> Verifique a conectividade e os erros do WebSocket.
    Nota: As mensagens de erro são mantidas na memória do dispositivo e removidas quando o serviço Agente de bot for reiniciado a partir da guia Serviços do Gerenciador de Tarefas do Windows.

    Quando um dispositivo Executor de bots não consegue se conectar à Control Room devido a erros na conexão WebSocket, esta opção fornece as razões possíveis para análise.
    -collectLogs Reduza o tempo de processamento para a coleta de informações sobre problemas ao capturar diversos logs do dispositivo Executor de bots.
    Use esta opção para capturar e salvar o atual gerenciador de nós do dia, inicializador do bot e logs de visualização de eventos para depuração e solução de problemas em uma pasta compactada do dispositivo em que o utilitário está sendo executado.
    • Para Agente de bot instalado no sistema, os logs são salvos em C:\ProgramData\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip
    • Para Agente de bot instalado no usuário local, os logs são salvos em %USERPROFILE%\AppData\Local\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip
    Nota:
    • Para capturar logs do Windows para eventos de segurança, execute o utilitário com privilégios elevados (execute como administrador).

      Se você executar o utilitário sem privilégios elevados, será exibido o seguinte erro:

      Erro: não foi possível capturar security_event_viewer_<date>.evtx
    • Para economizar espaço de armazenamento, exclua o arquivo após a depuração.
    -configProxy <CR_URL> Verifique e configure as credenciais do proxy, se necessário.

    Quando o dispositivo Executor de bots for incapaz de se conectar à Control Room devido à falta de credenciais para um servidor autenticado, use esta opção para configurar as credenciais do servidor proxy. Verifique se o problema de conectividade foi resolvido fazendo logon na Control Room.
    -importProxy <CR_URL> Importe as configurações de proxy de um dispositivo de usuário logado para o dispositivo do usuário do sistema.
    Nota: Você deve ter permissão do administrador para importar configurações de proxy.

    Quando o dispositivo Executor de bots não conseguir se conectar à Control Room devido a problemas no servidor proxy, use esta opção para importar as configurações proxy de um usuário logado para o usuário do sistema em Agente de bot.

    Esta opção oferece informações sobre os seguintes pontos:
    • se o servidor proxy é, ou não é, autenticado.
    • O URL da Control Room foi adicionado à lista de destinatários seguros no servidor proxy.
    • As conexões WebSocket foram permitidas como parte da configuração de proxy.
    -importSSLCertificate path_to_ssl_certificate Importe um certificado SSL para a loja de credenciais Java, se necessário.
    Nota: Você deve ter permissão do administrador para importar o certificado SSL.

    Quando o dispositivo Executor de bots não conseguir se conectar à Control Room por causa de um certificado SSL inválido, use esta opção para importar o certificado SSL. Você deve assegurar que um arquivo de certificado válido esteja disponível no local do arquivo especificado na opção importSSLCertificatepath_to_ssl_certificate.

    Você deve reiniciar o serviço Agente de bot Automation Anywhere para que o certificado importado fique ativo.
    -list Ver implantações de bot ativas nos dispositivos locais.

    Use esta opção para verificar e listar as automações (bots) que estão em funcionamento.
    -ping <CR_URL> Verifique a conectividade entre a Control Room e os dispositivos do Executor de bots.

    Use esta opção para verificar se um dispositivo Executor de bots pode executar o ping (alcançar) da Control Room.
    -validateSSLCertificate <CR_URL> Verifique se o certificado SSL é válido ou inválido.
    Nota: Você deve ler a permissão para realizar esta verificação.

    Quando o dispositivo Executor de bots não conseguir se conectar à Control Room por causa de um certificado SSL inválido, use esta opção para verificar a validade de certificado SSL. Para resolver o problema, use a opção importSSLCertificate.
  4. Insira a seguinte opção no prompt de comando: <filepath>\AADiagnosticUtility.exe -<option> <CR_URL>
    Por exemplo, para verificar os erros do WebSocket, insira no prompt de comando: AADiagnosticUtility.exe -checkWSError https://yourcrurl.com/
    A opção retorna para o seguinte resultado: este dispositivo não encontrou nenhum erro recente de Web Socket

    Use as outras opções para realizar mais verificações de diagnóstico.