Configuração de regras de log

Configure regras de log do robô para ingestão pelo Insights no Automation Suite no OpenShift.

Visão geral

Os logs de robô capturam logs de diagnóstico e execução. Você pode configurar as condições para que os logs de Robô sejam ingeridos pelo Insights. Por exemplo, você só deseja capturar logs para Processos que incluam um nome específico.

Para obter detalhes, consulte Logs do UiPath Robot.

Quando configurar regras de log

• Após a instalação do Insights.
• Após a atualização do Insights.
• Quando você deseja adicionar ou configurar regras de log existentes.

Regras de log padrão

As configurações padrão para logs de Robô ingeridos pelo Insights incluem apenas os últimos logs e logs de erro. As seções a seguir mostram regras de log padrão baseadas na versão do Insights que você está executando.

Regras de log padrão para as versões 2022.4 e superiores

Nesse exemplo, são ingeridos os últimos logs e logs de Erro para todos os processos. Essa versão do Insights ingere o último nível de Info de um Robô que executou um processo, com logs de nível de processo e quaisquer logs de nível de Erro, conforme mostrado no exemplo a seguir.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs">
        <filters defaultAction="Ignore">
          <when condition="level &gt;= LogLevel.Error or ends-with('${message}',' execution ended')" action="Log" />
          <when condition="'${ui-robot-logs-num-custom-fields}' &gt; 1 and not ends-with('${message}', ' execution started')" action="Log" />
        </filters>

Regras de log padrão para a versão 2021.10

Nesse exemplo, todos os logs (nível Info e superior) para todos os processos são ingeridos. Essa versão do Insights ingere todos os logs (nível Info e superior) gerados pelo Robô para todos os processos, conforme mostrado no exemplo a seguir.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs"/>

Configurar regras de log

Observação:

• Somente os administradores devem alterar os valores no arquivo de configuração do Orchestrator.
• Faça backup do arquivo UiPath.Orchestrator.dll.config antes de prosseguir. Você pode encontrar o arquivo em C:\Program Files (x86)\UiPath\Orchestrator.
• Reinicie o site após fazer alterações no arquivo de configuração do Orchestrator.
• Todos os parâmetros diferenciam maiúsculas de minúsculas.
• Para o melhor desempenho, os Logs de Robô gerados ao longo de um período de dois anos não devem exceder 200 milhões de registros.
• Use o arquivo de configuração do NLog para capturar dados que sejam relevantes para o Insights em seu ambiente e reduzir o número de registros gerados por Logs de Robô.

1. Navegue até C:\Program Files (x86)\UiPath\Orchestrator e abra o arquivo UiPath.Orchestrator.dll.config para modificar as configurações do Orchestrator.
2. Encontre os parâmetros dos Logs de Robô (por exemplo, <logger name="Robot.*" environmentSpecificConfiguration/>)
3. Configure um filtro com uma ação padrão (por exemplo, filters defaultAction="Ignore").
4. Configure condições com base no nível de log ou outros eventos (consulte o Exemplo de regras de log).
5. Salve o arquivo e reinicie o Orchestrator.

Para obter detalhes sobre a configuração do arquivo de configuração do Orchestrator, consulte UiPath.Orchestrator.dll.config.

Exemplos de regras de log

Os exemplos a seguir mostram configurações de regras de log personalizadas para os logs de nível Info e Erro. Ao definir condições específicas, o Insights ingere logs apenas para os processos que você configurar.

{
  "10_Robot_Insights": {
    "enabled": false,
    "final": false,
    "logger": "Robot.*",
    "minLevel": "Info",
    "ruleName": "insightsRobotLogsRule",
    "writeTo": "insightsRobotLogs"
  }
}

Ingerir todos os logs e quaisquer logs de Erro para um processo específico

No exemplo a seguir, o Insights ingere todos os logs de nível Info e Erro para os nomes de processo a seguir: payment disp, 68fields ou 68fields_20.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs">
    <filters defaultAction="Ignore">
      <when condition="equals('${event-properties:item=processName}', 'payment disp') or equals('${event-properties:item=processName}', '68fields') or equals('${event-properties:item=processName}', '68fields_20')" action="Log" />
    </filters>
  </logger>

Ingerir apenas os últimos logs e logs de Erro para um processo específico

No exemplo a seguir, o Insights ingere apenas os últimos logs de nível Info e Erro para os nomes de processo a seguir: payment disp, 68fields ou 68fields_20.

Apenas os logs de nível Erro e o último log de cada Robô são registrados no Insights.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs">
    <filters defaultAction="Ignore">
      <when condition="(level >= LogLevel.Error or ends-with('${message}',' execution ended')) and (contains('${event-properties:item=processName}', 'payment disp') or equals('${event-properties:item=processName}', '68fields') or equals('${event-properties:item=processName}', '68fields_20'))" action="Log" />
    </filters>
  </logger>

Não ingerir logs para um processo específico

No exemplo a seguir, o Insights não ingere nenhum log para o nome de processo: payment disp.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs">
    <filters defaultAction="Log">
      <when condition="equals('${event-properties:item=processName}', 'payment disp')" action="Ignore" />
    </filters>
  </logger>

Artigos relacionados

Arquivo de configuração do NLog