Sobre logs

Visão geral

A página Logs exibe logs gerados por robôs em todas as pastas às quais você tem acesso.

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.

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 exibir todos os logs gerados por um robô para um trabalho indicado, navegue até a página Trabalhos, clique no menu de três pontos correspondente ao trabalho no qual você está interessado e selecione Exibir logs.

Para filtrar logs gerados por robôs em todas as pastas às quais você tem acesso, vá para a página Logs e use os filtros desejados. Observe que alguns filtros são aplicados por padrão, como Tempo, que é definido como Último dia. Para exibir todos os logs, certifique-se de remover todos os filtros.

Para filtrar logs pelo nome da máquina do host na qual foram gerados, use o filtro Máquina na página Logs. O 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.

Os logs podem ser enviados para o Elasticsearch, um banco de dados SQL local e/ou UiPath Insights, permitindo assim 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).

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.

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 de Exibir em Logs no contexto da pasta para ter acesso aos logs gerados em uma pasta.