Orchestrator
2023.4
falso
Imagem de fundo do banner
Guia do usuário do Orchestrator
Última atualização 19 de abril de 2024

Sobre logs

A página Logs exibe os logs gerados por Robôs em todas as pastas às quais o usuário tem acesso, incluindo os logs gerados para trabalhos iniciados por meio de sessões de depuração remotas.

Para acessá-las, navegue até a guia Automações do Orchestrator a partir de um contexto de pasta e selecione Logs nas opções exibidas.

A tabela abaixo contém descrições de campo para a página Logs .

Campo

Description

Hora

O carimbo de data/hora com que o log foi registrado.

Observação: é possível classificar e filtrar a lista de logs por Período.

Nível

O nível de gravidade no qual a mensagem foi logada. As seguintes opções estão disponíveis: Trace, Debug, Info, Warn, Error e Fatal.

Observação: é possível classificar e filtrar a lista de logs por Nível.

Processo

O nome do processo que gerou uma determinada mensagem de log.

Hostname

O nome da estação de trabalho usada para a execução do processo.

Identidade do host

A identidade na qual a execução será realizada. Os seguintes valores são possíveis:

  • <Domain\Username> – Trabalhos executados nessa conta específica. Exibido nos seguintes casos:

... trabalhos em primeiro plano, independentemente da versão do Robot;

... todos os trabalhos executados em Robots inferiores ao 2021.10;

... trabalhos Attended executados em Robots conectados usando uma chave da máquina, sem logon do usuário.

Observação: para os Robôs anteriores a outubro de 2021, a identidade do host será preenchida dinamicamente de acordo com as configurações de conta feitas no Orchestrator. Alterar o domain\username para a conta usada para executar um trabalho também altera a identidade do host.
  • ROOT - Trabalhos em segundo plano executados em robôs do Linux.
  • NT AUTHORITY\LOCAL SERVICE - Trabalhos executados sob a identidade de serviço do Robô. Exibido para trabalhos em segundo plano executados em Robôs posteriores a outubro de 2021 sem credenciais.
    Os robôs em modo de serviço são executados sob NT AUTHORITY\LOCAL SERVICE. Os robôs no modo de usuário são executados sob uma determinada identidade de usuário.
  • N/A - Trabalhos iniciados a partir do UiPath Assistant por usuários conectados usando o login interativo. Para robôs conectados com a chave da máquina, sem logon de usuário, o <Domain\Username> será exibido.

Mensagem

A mensagem registrada. Isso também pode ser uma mensagem registrada por meio da atividade Log Message no Studio.

Lembre-se de que o conteúdo dessa coluna é exibido no idioma do Robô, independentemente do idioma que tenha sido escolhido para o Orchestrator.

Observação: Os logs gerados fora do contexto de uma pasta podem ser vistos apenas no banco de dados do Orchestrator e no Elasticsearch.

Filtragem

Para visualizar todos os logs gerados por um Robô para um trabalho indicado, navegue até a página Trabalhos.

Para filtrar logs pelo nome da máquina do host na qual foram gerados, use o filtro Máquina na página Logs.

O novo filtro funciona retroativamente para logs armazenados no Elasticsearch, enquanto que, para logs armazenados no banco de dados, funciona apenas para novas entradas de logs.

Armazenamento de logs

Se o Orchestrator estiver indisponível, os logs serão armazenados em um banco de dados local (C:\Windows\SysWOW64\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.

É possível enviar logs para o Elasticsearch, um banco de dados SQL local, e/ou o UiPath Insights, permitindo que você tenha logs de não repúdio. Eles são independentes e, como tal, um problema encontrado em um não afeta o(s) outro(s).

Configure o local onde os logs estão armazenados em UiPath.Orchestrator.dll.config, alterando o valor do parâmetro writeTo.

A página Logs exibe as entradas que os robôs enviam ao Orchestrator, se os logs forem enviados para o Elasticsearch ou um banco de dados SQL. Se os logs forem enviados para o Elasticsearch e SQL, então a página Logs exibirá apenas as entradas enviadas para o Elasticsearch.

Observação:

O desempenho do banco de dados SQL começa a degradar quando atinge 2 milhões de logs de Robôs, com uma degradação grave quando o limite de 6 milhões é atingido. A degradação leva a pesquisas de log lentas e afeta o desempenho de suas automações.

Esses limiares representam nossas médias observadas. Dependendo do hardware do servidor do banco de dados, os valores podem ser menores ou maiores (em até 2 a 3 vezes).

Você precisa limpar regularmente o banco de dados para garantir que você permaneça dentro desses limites.

Se, no entanto, suas necessidades de negócios exigem que você exceda esses limites, você precisa usar o Elasticsearch para manter o desempenho.

Se você usa o Elasticsearch para armazenar seus logs de Robô, observe que, em determinadas circunstâncias, apenas 10.000 itens podem ser consultados.

Devido a uma limitação do Elasticsearch, os tenants do Orchestrator do Cloud Platform são configurados para ignorar logs de robôs maiores que 50 kb. A grande grande maioria dos logs tem, em média, em torno de 2 kb.

Níveis de Registro de Logs

As mensagens são registradas em log nos seguintes níveis: Trace, Debug, Info, Warn, Error e Fatal.

As mensagens personalizadas também podem ser enviadas para esta página a partir do Studio, com a atividade Log Message. As mensagens podem ser registradas em log em todos os níveis descritos acima e devem ser usadas para fins de diagnóstico.

Por exemplo, na captura de tela abaixo, você pode ver que registramos em log uma mensagem personalizada em um nível de severidade Fatal.



Consulte Níveis de Registro de Logs para obter mais informações.

Exportação de logs

Todos os logs podem ser exportados para um arquivo .csv, clicando no botão Exportar. Os filtros aplicados a esta página serão considerados quando esse arquivo for gerado. Por exemplo, se você definir para exibir apenas os logs dos últimos 30 dias com um nível de gravidade Info, apenas as entradas que atendam a esses critérios serão baixadas.

Para garantir o melhor desempenho, observe que as entradas exportadas não estão em ordem cronológica.



Os logs podem não estar na ordem adequada apenas no seguinte cenário:

  • Há duas ou mais entradas de log do robô com quase o carimbo de data/hora – Elas são iguais na casa dos milissegundos (o tempo expresso como yyyy-MM-dd HH\:mm\:ss.fff é o mesmo), mas diferem nas subunidades de milissegundos (os últimos quatro valores em yyyy-MM-dd HH\:mm\:ss.fffffff são diferentes).
  • Os logs são exibidos no Orchestrator, com a ordem de classificação padrão na grade (classificação por tempo decrescente).

No entanto, isso não afeta o banco de dados e o arquivo .csvexportado.

Observação: Tanto as exceções do servidor do Orchestrator, quanto o rastreamento de pilha na janela Detalhes do trabalho, serão registrados em log em inglês, independentemente de qual idioma tiver sido escolhido pelo usuário.

Permissões

Você precisa ter a permissão Exibir em Logs no contexto da pasta para ter acesso aos logs gerados nessa pasta.

Was this page helpful?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Logotipo branco da Uipath
Confiança e segurança
© 2005-2024 UiPath. All rights reserved.