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 na UiPath^®

Nível de Log	Registrado	Exemplo/Comentário	arquivo de log	Painel de Saída	Página de logs do Orchestrator
Verbose	Atividades	Trace {"message":{"DisplayName":"Message box","State":"Executing","Activity":"UiPath.Dialog.Activities.MessageBox","Arguments":{"Caption":"","Text":"String in message BOX"}... Trace {"message":{"DisplayName":"Message box","State":"Closed","Activity":"UiPath.Dialog.Activities.MessageBox","Arguments":{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok"}	Sim	Não	Sim
Verbose	Variáveis	"Variables":{"NewTransaction":"False"}}	Sim	Não	Sim
Verbose	Argumentos (propriedades)	"Arguments":{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok"}	Sim	Não	Sim
Trace	Atividades	Trace {"message":"write","level":"Trace","logType":"User","timeStamp":"","fingerprint":"","windowsIdentity":"","machineName":"","processName":"New Process","processVersion":"","jobId":"","robotName":"","machineId":,"organizationUnitId":}	Sim	Não	Sim
Trace	WriteLine	Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity"} Rastrear {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.Statements.Flowchart"}	Sim	Sim	Sim
Information	Mensagem do Log	Info {"message":"message from activity" Observação: exceto mensagens registradas com o nível Rastreamento definido na atividade.
Aviso	Avisos	Warn {"message":"Aviso de atividade de mensagem de log"	Sim	Sim	Sim
Aviso	Erros	Erro {"message":"Erro da atividade de mensagem de log"	Sim	Sim	Sim
Aviso	Crítica	Erros críticos	Sim	Sim	Sim
Erro	Erros	Erro {"message":"Erro da atividade de mensagem de log"	Sim	Sim	Sim
Erro	CriticalFatal	Erros críticos	Sim	Sim	Sim
Crítica	CriticalFatal	Erros críticos	Sim	Sim	Sim
Desativado	N/A	N/A	Não	Não	Não

Níveis de registro em log na UiPath^®

Nível de Registros de Log	Logs padrão	Logs definidos pelo usuário
Desativado	Nenhum	Nenhum
Crítica	Todas as mensagens registradas com nível Crítico ou superior.	Todas as mensagens registradas com nível Crítico ou superior.
Erro	Todas as mensagens registradas com nível de Erro ou superior.	Todas as mensagens registradas com nível de Erro ou superior.
Aviso	Todas as mensagens registradas com nível de Aviso ou superior.	Todas as mensagens registradas com nível de Aviso ou superior.
Information	Todas as mensagens registradas com nível de Informação ou superior.	Todas as mensagens registradas com nível de Informação ou superior.
Trace	Todas as mensagens registradas com nível de Rastreamento ou superior.	Todas as mensagens registradas com nível de Rastreamento ou superior.
Verbose	Todas as mensagens registradas com nível de Rastreamento e logs de Rastreamento de Fluxo de Trabalho.	Todas as mensagens registradas com nível de Rastreamento.

O nível Detalhado registra em log uma mensagem para a atividade start e end, além dos valores das variáveis e dos argumentos que são usados.

Por padrão, o nível Verbose inclui:

• Entrada de log Execução Iniciada - gerada sempre que um processo é iniciado.
• Entrada de log Execução Finalizada -gerada sempre que um processo é finalizado.
• Entrada de log de Transação Iniciada - gerado toda vez que um item de transação é obtido pelo Robô a partir do Orchestrator.
• Entrada de log de Transação Encerrada - gerado sempre que o Robô define o status de transação como Sucesso ou Falha.

• Entrada de log de Informações da Atividade - gerado sempre que uma atividade é iniciada, com falha ou finalizada dentro de um processo.

  Observação: a ordem de prioridade dos tipos de logs é: Verbose < Trace < Information < Warning < Error < Critical < Off.

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.