Logs do Robot

Os logs são arquivos com carimbo de data/horário que contêm eventos informativos e mensagens de erro e advertência relevantes para o aplicativo.

Os tipos de logs são apresentados nas páginas a seguir:

Logs de Execução do Robô

Os logs de execução de Robots são mensagens geradas pela execução de um processo. Eles contêm informações relacionadas a seu comportamento e mensagens definidas pelo usuário no fluxo de trabalho.

Os logs de execução são gerados por:

• A atividade Write Line, que cria logs no nível Trace.
• A atividade Log Message, que cria logs no nível especificado no campo da propriedade Level da atividade.
• Executando um projeto de automação, gera logs que contêm o comportamento de cada atividade. Esses logs usam o nível Trace se a configuração Level na janela Configurações do Orchestrator no UiPath Assistant for 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.

Observação: o nível de log definido no Orchestrator para o UiPath Robot substitui o definido no UiPath^® Assistant.

Apenas logs que correspondem ao nível especificado nas configurações do Assistant ou do Orchestrator são enviados para o Orchestrator.

Alterar o nível de registro em log do UiPath Assistant:

1. No UiPath^® Assistant, acesse o menu Preferências e acesse 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 no modo de serviço, serão necessárias permissões de administrador para editar essa configuração.

Destino do Orchestrator

Se o UiPath Robot for conectado ao Orchestrator, apenas logs que correspondem ao nível definido no Assistant ou Orchestrator aparecerão na página Logs.

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.

Destino do NLog

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

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 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>

Excluindo arquivos de log de fluxos de trabalho 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> NLog.config:

• 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. Essa saída de log pode ser personalizada editando o arquivo UiPath.Executor.exe.config, a partir da pasta C:\Program Files\UiPath\Studio.

Para isso, o seguinte código XML deve ser adicionado sob a tag <system.serviceModel>.

<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 das atividades podem ser modificados, mas também variáveis e argumentos. Mais informações sobre a personalização podem ser encontradas aqui.

Observação: a modificação do UiPath.Executor.exe.configarquivo requer uma reinicialização do Serviço de Robôs para que as alterações entrem em vigor.

Logs de diagnóstico do Robô

Os logs de diagnóstico do Robot fornecem informações relacionadas ao próprio Robot e a seu contexto. Eles são úteis para identificar a causa de um erro específico.

Os logs de diagnóstico do Robot são salvos nos seguintes locais:

• No Windows, os logs de diagnóstico relacionados a erros são registrados em log no Visualizador de Eventos.

• Em todas as plataformas, incluindo o Windows, os logs de diagnóstico de Verbose são gravados em um arquivo:

  • %LocalAppData%\UiPath\Logs\internal\Robot.log no Windows, quando o robô é instalado no Modo de Usuário.
  • %PROGRAMDATA%\UiPath\Logs\internal\Robot.log no Windows, quando o Robot é instalado no Modo de Serviço.
  • ~/.local/share/UiPath/Logs/internal/Robot.log em outras plataformas.

Logs de diagnóstico de drivers

O Rastreamento de drivers é gravado em um arquivo .etl.

Para habilitar o Rastreamento de drivers, abra o Prompt de comando com direitos de administrador, acesse o diretório de instalação usando o argumento cd, como cd C:\Program Files\UiPath\Studio, e execute o comando UiRobot.exe --enableLowLevel.

Para desabilitar o Rastreamento de drivers, abra o Prompt de comando com direitos de administrador, acesse o diretório de instalação usando o argumento cd, como cd C:\Program Files\UiPath\Studio, e execute o comando UiRobot.exe --disableLowLevel.

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 Robot não precisa ser reiniciado para que as alterações entrem em vigor.