Registro de Log e Níveis de Log

Durante a execução de processos, o Robô gera uma mensagem (Log) para cada etapa ao longo do caminho. Essas são coletadas e armazenadas em um Arquivo de Log. A operação geral de coleta e armazenamento de Logs é chamada de Registro de Log.

Cada Log tem um Nível de Log, que se refere ao quão detalhada a mensagem gerada é.

Os Níveis de Log referem-se ao tipo de severidade escrita no Arquivo de Log.

Níveis de Log no UiPath

O nível de registro refere-se ao nível de detalhe que a mensagem gerada deve ter. Você pode configurá-lo por meio de:

• a configuração de Nível de log na página UiPath Assistant > Preferências > Geral. Por padrão, ele é definido como Informação.
• a configuração de Nível de registro na página Orchestrator > Gerenciar acesso > Usuários > conta de usuário ou robô > Configurações do Robô. Por padrão, ele é definido como Informação.
  Observação: o nível de registro que você define no Orchestrator substitui o nível configurado no UiPath Assistant.

O UiPath usa os seguintes níveis de registro, listados em ordem crescente de prioridade.

• Desligado – Nenhum registro é armazenado. Esse nível é normalmente usado para desativar o registro.
• Verbose – Relata um nível ainda mais fino de granularidade, registrando todos os detalhes possíveis sobre as operações de automação. Isso pode incluir informações sobre alterações de variáveis, chamadas de função ou até respostas externas. Exibe todos os logs com o nível de Trace. Por padrão, o nível Verbose inclui as seguintes entradas de registro:
  • Execução iniciada – gerada toda vez que um processo é iniciado.
  • Execução encerrada – gerada toda vez que um processo é finalizado.
  • Transação iniciada – gerada toda vez que um item de transação é obtido pelo Robô do Orquestrador.
  • Transação encerrada – gerada toda vez que o Robô define o status da transação como Sucesso ou Fracasso.
  • Informações da atividade – geradas toda vez que uma atividade é iniciada, apresenta falha ou concluída dentro de um processo.
• Rastreamento – Esses registros contêm as informações mais detalhadas, geralmente usadas para depuração ou rastreamento da caminhos de execução de tarefas específicas no sistema. Exibe todos os registros com os níveis Rastreamento, Informação, Aviso, Erro e Crítico.
• Informações – Os registros informativos fornecem informações gerais sobre a execução de automação, como início e fim das tarefas. Exibe todos os registros com os níveis de Informação, Aviso, Erro e Crítico.
• Aviso – Esses registros incluem pequenos problemas ou problemas em potencial que não afetam imediatamente a operação atual, mas podem tornar-se significativos no futuro. Exibe todos os registros com os níveis de Aviso, Erro e Crítico.
• Erro – Os registros gerados nesse nível incluem detalhes de erros que ocorreram durante a execução, que impedem a operação normal do fluxo de trabalho, mas não fazem com que o sistema inteiro pare. Exibe todos os registros com os níveis de Erro e Crítico.
• Crítico – Os registros que indicam um problema ou erro crítico são gravados. Os problemas sérios o suficiente para exigirem atenção imediata geralmente são registrados nesse nível.

Sobre informações de PII em logs

Information, Warning, Error, e Critical

Os valores dos argumentos de entrada/saída não são rastreados quando os níveis de log Information, Warning, Error e Critical são usados. Isso significa que nenhuma informação de PII é enviada nos logs do Orchestrator, a menos que seja explicitamente adicionada do Studio.

Trace e Verbose

Os níveis de log Trace e Verbose rastreiam e gravam os valores dos argumentos de entrada/saída em logs do Orchestrator. Se esses valores incluírem informações de PII, elas são adicionadas aos logs do Orchestrator.

Usar excludeLoggedData para ocultar informações confidenciais

A variável excludedLoggedData permite que você adicione palavras-chave para evitar que valores de variáveis e argumentos sejam registrados no nível Detalhado.

Isso também pode ser feito selecionando a caixa de seleção Private de qualquer atividade. Saiba mais sobre a proteção das informações confidenciais aqui.

"excludedLoggedData": [
      "Private:*",
      "<em>password</em>"
    ],

LogTypes

Há várias ocorrências possíveis de mensagens de log, dependendo do evento que é registrado, conforme mostrado a seguir:

Padrão

Gerado por padrão quando a execução de um processo é inicia e termina, quando acontece um erro do sistema e a execução é interrompida ou quando as configurações de registro de log estão ajustadas para registrar a execução de cada atividade.

Observação: esses logs têm o valor Default no campo logType.

Os eventos registrados por esta categoria são:

• Início de Execução é gerado sempre que um processo é iniciado. Isso é registrado começando com o nível de log de Informação.
• Fim de Execução é gerado sempre que um processo é finalizado. Isso é registrado começando com o nível de log de Informação.
• Início de Transação é gerado sempre que uma transação dentro de um processo é iniciada. Isso é registrado começando com o nível de log de Informação.
• Fim de Transação é gerado sempre que uma transação dentro de um processo é finalizada.Isso é registrado começando com o nível de log de Informação.
• Log de Erro é gerado sempre que a execução encontra um erro e é interrompida. Isso é registrado começando com o nível de log Erro.
• Log de Depuração é gerado se a Configuração de Registro de Log do Robô estiver definida como Verbose e contém nomes da atividades, tipos, valores variáveis, argumentos, etc. Isso é registrado a partir do nível de registro de log Trace.

Definido pelo usuário

Gerado de acordo com o processo projetado pelo usuário no Studio, ao usar a atividade Log Message ou a atividade Write Line.

Observação: esses logs têm o valor User no campo logType.

Campos de Log

Há vários tipos de campos de log que podem ser encontrados nos tipos de mensagem de log acima. Eles podem ser classificados da seguinte maneira:

Campos padrão

• Mensagem - A mensagem de log.
• Nível - Defina a severidade do log.
• Carimbo de data/hora - A data e o horário exatos em que a ação foi executada.
• NomeDoArquivo — o nome do arquivo .xaml que está sendo executado.
• jobId * - A chave do trabalho que estão executando o processo.
• processName * - O nome do processo que acionou o registro em log.
• processVersion * - O número da versão do processo.
• windowsIdentity - O nome do usuário que realizou a ação que foi registrada.
• robotName * - O nome do Robot (conforme definido no Orchestrator).
• machineName - o nome da máquina do Robot.
• machineId * - O ID da máquina do Robot.
• organizationUnitId * - O ID da organização do Orchestrator.

* Campos de log marcados com um asterisco não podem ser substituídos usando a atividade Add Log Fields.

Observação: os campos processName e processVersion não aparecem em logs se o processo for executado localmente, sem estar conectado ao Orchestrator.

Campos de tipo específico

Esses logs estão presentes, dependendo do tipo de log.

Fim de Execução

• totalExecutionTimeInSeconds
• totalExecutionTime

Início de Transação

• QueueName
• ID da Transação
• transactionState
• initiatedBy

Fim de Transação

• QueueName
• ID da Transação
• transactionState
• transactionStatus
• Tempo de Execução da Transação
• Tipo da Exceção de Processamento
• Motivo da Exceção de Processamento
• queueItemReviewStatus
• queueItemPriority

Log de Depuração

activityInfo, que é uma mensagem em JSON com os seguintes campos:

• NomeDeExibição
• Estado (Com falha, Encerrado, Executando)
• Atividade

• Argumentos

  Observação: apenas totalExecutionTimeInSeconds, totalExecutionTime e queueName estão sempre presentes nas mensagens de log. Variables e Arguments geralmente possuem subcampos.

Campos definidos pelo usuário

Esses campos são definidos no Studio, usando a atividade Adicionar Campos de Log, e aparecem em todos os logs subsequentes após a atividade ser gerada, a menos que sejam removidos pela atividade Remover Campos de Log.

Importante:

Ao definir Campos de Log Personalizados, certifique-se de também verificar a nomeclatura dos Campos de Log Padrão, para evitar informações conflitantes nos Arquivos de Log, nos mesmos Campos de Log.

Ter a mesma convenção de nomeclatura para Campos Personalizados e Padrão de Log, também pode afetar o Processo que você está executando.