Logs do Robot

Os logs são arquivos com marcadores de tempo, que contêm eventos informativos, mensagens de erro e avisos relevantes para o aplicativo.

Se o Orchestrator estiver indisponível, os logs serão armazenados em um banco de dados local (C:\Windows\System32\config\systemprofile\AppData\Local\UiPath\Logs\execution_log_data), dentro do espaço de disco disponível, até que a conexão seja restaurada. Quando a conexão for restaurada, os logs serão enviados em lotes na ordem em que tiverem sido gerados.

Observação: o banco de dados não é excluído após os logs terem sido enviados com sucesso para o Orchestrator.

O status de um trabalho é armazenado na memória do serviço do UiPath Robot.Quando o Orchestrator ficar disponível, as informações relacionadas ao status do trabalho serão sincronizadas entre os dois.No entanto, se o Orchestrator não estiver disponível e você reiniciar o serviço do UiPath Robot, as informações serão perdidas.Isso significa que sempre que o Orchestrator ficar disponível, o trabalho será executado novamente.

Logs de diagnóstico do Robô

Esses logs fornecem informações relacionadas ao Robô em si, e ao seu contexto. Eles são úteis na identificação da causa de um erro específico.

Habilitando os Logs de Diagnóstico do Robô

Por padrão, os Logs de Diagnóstico do Robô são habilitados e qualquer mensagem a níveis de Erro ou Aviso, é registrada.

Se outros níveis de informações de log forem necessários, todos eles poderão ser habilitados, caso o Rastreamento de Baixo Nível esteja habilitado. Por padrão, essa funcionalidade fica desabilitada.

Para habilitar o Rastreamento de Baixo Nível, execute o seguinte comando UiRobot.exe --enableLowLevel no Prompt de Comando.

Para desabilitar o Rastreamento de Baixo Nível, execute o seguinte comando UiRobot.exe --disableLowLevel no Prompt de Comando.

Habilitar o Rastreamento de Baixo Nível como um usuário administrador local ou de domínio, inicia o rastreamento de baixo nível para o arquivo .etl. Isso permite o rastreamento detalhado para o Executor e para o Serviço do Robô no Visualizador de Eventos.

Não se esqueça de primeiro ir ao diretório de instalação, usando o argumento cd, como em cd C:\Program Files\UiPath\Studio.

Observação:

Recomendamos habilitar o Rastreamento de Baixo Nível apenas ao investigar um problema, e desabilitá-lo quando a sessão de investigação estiver concluída.

Além disso, o arquivo .etl que contém as informações de rastreamento é gerado apenas após você desabilitar a funcionalidade.

O Robô não precisa ser reiniciado para que as alterações entrem em vigor.

Destino dos logs de diagnóstico do Robô

O local de destino dos logs é controlado pelo arquivo <Installation Folder>\NLog.config. Os logs de Diagnóstico são coletados pelo logger do tipo Interno e são encaminhados usando os destinos do NLog.

Por padrão, os logs internos são enviados para o Visualizador de Eventos, conforme especificado nas seguintes linhas do NLog.config:

<target xsi:type="EventLog" name="eventLog" layout="${callsite:className=false:includeSourcePath=true:methodName=false} ${message}" source="UiPath" log="Application" />

<logger name="Internal" minLevel="Trace" writeTo="eventLog" />

Observação: a edição do arquivo NLog.config requer permissões de administrador. O serviço UiRobot.exe precisa ser reiniciado, caso o destino interno seja alterado no arquivo NLog.config para que as alterações entrem em vigor.

Abrindo o .etl arquivo de log

Este tipo de arquivo pode ser aberto a partir do Visualizador de Eventos:

1. No Visualizador de Eventos, no painel Ações, clique em Abrir Log Salvo. A janela Abrir Log salvo será exibida.
2. Procure o arquivo de log de rastreamento gerado e clique em Abrir. O arquivo é exibido no painel esquerdo, em Logs Salvos.

3. Selecione o arquivo. Observe que o conteúdo dos logs são exibidos.

   
   

   

   
   

Logs de Execução do Robô

Os logs de execução do rRobô são mensagens geradas pela execução de um processo e, geralmente contêm informações relacionadas ao seu comportamento, além de mensagens definidas pelo usuário.

Há várias maneiras de gerar logs de execução:

• A atividade Write Line cria logs no nível Trace.
• A atividade de Log Message cria logs no nível especificado no campo da propriedade Level.
• Executar um projeto de automação gera logs que contêm o comportamento de cada atividade. Esses logs possuem o nível de Rastreamento, caso a configuração de Nível na janela de configurações do Orchestrator estiver definida como Verbose.

Nível de Logs de Execução

O nível de log padrão é controlado pela configuração Nível, armazenada na janela de Configurações do Orchestrator. Por padrão, ele é definido como Informação.

Alterando o Nível de Log Padrão a partir da Janela de Configurações do Orchestrator:

1. No UiPath Assistant, acesse o menu Preferências e, em seguida, acesse as Configurações do Orchestrator

2. Selecione o nível de log desejado no menu suspenso Nível de Log, na seção Logging.

   
   

   

   
   
   Observação: se o Robô estiver instalado como um Serviço do Windows, a permissão de administrador será necessária para editar essa configuração.

Destinos dos Logs de execução

Por padrão, os Logs de Execução são armazenados em um arquivo na pasta %LocalAppData%\UiPath\Logs. As mensagens são coletadas pelo logger WorkflowLogging e podem ser encaminhadas usando os destinos do NLog, conforme especificado pelos seguintes parâmetros no arquivo NLog.config:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
  <rules>
    <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
  </rules>
  <targets>
    <target type="File" name="WorkflowLogFiles" fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" keepFileOpen="true" openFileCacheTimeout="5" concurrentWrites="true" encoding="utf-8" writeBom="true" />
  </targets>
</nlog>

Se o Robô estiver conectado ao Orchestrator, todos os logs de execução serão enviados para o Orchestrator e podem ser vistos na página Logs.

Além disso, os destinos de log e o conteúdo podem ser configurados, editando o arquivo <Installation Folder>\NLog.config.

Exclusão de arquivos de log antigos

Para evitar criar uma grande quantidade de arquivos de log, que consomem espaço em disco na máquina, você pode optar por arquivar os arquivos de log após ter sido atingido um número específico de arquivos.

Isso é feito adicionando os seguintes parâmetros na tag <target>:

• archiveNumbering="Date"
• archiveEvery="Day"
• archiveDateFormat="yyyy-MM-dd"
• archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"

• maxArchiveFiles="10"

  <?xml version="1.0" encoding="utf-8" ?>
  <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
    <rules>
      <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
    </rules>
    <targets>
      <target type="File"
        name="WorkflowLogFiles"
        fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log"
        layout="${time} ${level} ${message}"
        keepFileOpen="true"
        openFileCacheTimeout="5"
        concurrentWrites="true"
        encoding="utf-8"
        writeBom="true"
        archiveNumbering="Date"
        archiveEvery="Day"
        archiveDateFormat="yyyy-MM-dd"
        archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"
        maxArchiveFiles="10"
      />
    </targets>
  </nlog>

  Observação: o maxArchiveFiles é o parâmetro que controla o número de arquivos.
  Observação: a edição do arquivo NLog.config requer permissões de administrador. O serviço do Robô não precisa ser reiniciado para que as alterações entrem em vigor.

Edição Adicional de Logs

Se o nível de log estiver definido como Verbose, as mensagens conterão todos os detalhes sobre as atividades que foram processadas na execução. Esse resultado de log pode ser personalizado, editando o arquivo UiPath.Executor.exe.config, que pode ser encontrado na pasta C:\Program Files\UiPath\Studio. Para fazer isso, o código XML deve ser adicionado sob a tag <system.serviceModel>. Por exemplo:

<tracking>
    <profiles>
        <trackingProfile name="StandardProfile">
         <workflow>
          <activityStateQueries>  
            <activityStateQuery activityName="*">
                <states>  
                    <state name="Faulted"/>  
                </states>
                <arguments>  
                    <argument name="*"/>  
                </arguments> 
                 <variables>  
                    <variable name="*"/>  
                </variables>             
            </activityStateQuery>
          </activityStateQueries>    
         </workflow>
        </trackingProfile>       
    </profiles>
</tracking>

Como a tag <states> contém apenas <state name="Faulted"/>, inserir o código acima permite que apenas as atividades em estado com falha sejam registradas. Adicionar outros parâmetros sob a tag <states>, como <state name="Executing"/>, faz com que atividades que tenham outros estados também sejam registradas.

Não apenas os estados de atividade podem ser modificados, mas também outras coisas, como variáveis e argumentos. Mais informações sobre a personalização podem ser encontradas aqui.

Observação: a modificação do arquivo UiPath.Executor.exe.config requer uma reinicialização do serviço do Robô para que as alterações entrem em vigor.