Configuração de regras de log

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 mais informações, consulte Logs de Robots.

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

Você pode definir as configurações do Orchestrator no arquivo nlog.custom.config. Para modificar as configurações, siga as seguintes etapas:

1. Coloque as novas regras de log dentro do arquivo nlog.custom.config . Verifique os seguintes detalhes para um exemplo:

   {
     "10_Robot_Insights": {
       "logger": "Robot.*",
       "ruleName": "insightsRobotLogsRule",
       "minLevel": "Info",
       "writeTo": "insightsRobotLogs",
       "enabled": false,
       "final": false,
       "filters": {
         "defaultAction": "Ignore",
         "conditions": [
           {
             "condition": "level >= LogLevel.Error or ends-with('${message}', ' execution ended')",
             "action": "Log"
           }
         ]
       }
     }
   }

2. Use a ferramenta de configuração do Orchestrator para atualizar a configuração. Use o seguinte comando para mesclar as chaves do arquivo nlog.custom.config personalizado com as configurações já disponíveis no mapa de configuração orchestrator-customconfig .

   ./orchestrator-configurator.sh -l nlog.custom.config

   Esse comando não remove nenhuma configuração existente.

Exemplo de Regras de Log

No exemplo a seguir, estamos enviando apenas logs que excedem um certo nível ou contêm a mensagem de que a execução terminou:

{
  "10_Robot_Insights": {
    "logger": "Robot.*",
    "ruleName": "insightsRobotLogsRule",
    "minLevel": "Info",
    "writeTo": "insightsRobotLogs",
    "enabled": false,
    "final": false,
    "filters": {
      "defaultAction": "Ignore",
      "conditions": [
        {
          "condition": "level >= LogLevel.Error or ends-with('${message}', ' execution ended')",
          "action": "Log"
        }
      ]
    }
  }
}

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