Configuración de las reglas de registro

Información general

Los registros de UiPath Robots capturan registros de diagnóstico y de ejecución. Puedes configurar las condiciones en las que Insights ingiere los registros de UiPath Robots. Por ejemplo, si solo quieres capturar registros para procesos que incluyan un nombre específico.

Para obtener más información, consulta Registros de robots.

Cuándo configurar las reglas de registro

• Después de la instalación de Insights.
• Después de la actualización de Insights.
• Cuando quieras añadir o configurar reglas de registro existentes.

Reglas de registro predeterminadas

La configuración predeterminada para los registros de UiPath Robots ingeridos por Insights incluye solo los últimos registros y los registros de error. Las siguientes secciones muestran las reglas de registro predeterminadas en función de la versión de Insights que se ejecute.

Reglas de registro predeterminadas para las versiones 2022.4 y posteriores

En este ejemplo, se ingieren los últimos registros y los registros de error para todos los procesos. Esta versión de Insights ingiere el último nivel de información de un UiPath Robot que ha ejecutado un proceso junto con los registros de nivel del proceso y de cualquier error, como se muestra en el siguiente ejemplo.

<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>

Reglas de registro predeterminadas para la versión 2021.10

En este ejemplo, se ingieren todos los registros (nivel de información y superior) para todos los procesos. Esta versión de Insights ingiere todos los registros (nivel de información y superiores) generados por el UiPath Robot para todos los procesos, como se muestra en el siguiente ejemplo.

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

Configurar reglas de registro

Puedes configurar los ajustes de Orchestrator en el archivo nlog.custom.config. Para modificar los ajustes, sigue los siguientes pasos:

1. Coloca las nuevas reglas de registro dentro del archivo nlog.custom.config . Comprueba los siguientes detalles para ver un ejemplo:

   {
     "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. Utiliza la herramienta de configuración de Orchestrator para actualizar la configuración. Utiliza el siguiente comando para combinar las claves del archivo nlog.custom.config personalizado con los ajustes ya disponibles en el mapa de configuración orchestrator-customconfig .

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

   Este comando no elimina ninguna configuración existente.

Ejemplo de reglas de registro

En el siguiente ejemplo, solo enviamos registros que superan un cierto nivel o contienen el mensaje de que la ejecución ha finalizado:

{
  "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 los registros y cualquier registro de error para un proceso en particular

En el siguiente ejemplo, Insights ingiere todos los registros de nivel información y error para los siguientes nombres de proceso: payment disp, 68fields o 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 solo el último registro y los registros de error para un proceso en particular

En el siguiente ejemplo, Insights ingiere solo los últimos registros de nivel información y los registros de error para los siguientes nombres de proceso: payment disp, 68fields o 68fields_20.

Solo se registran en Insights los registros de nivel error y el último registro de cada UiPath Robot.

<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>

No ingerir registros para un proceso en particular

En el siguiente ejemplo, Insights no ingiere ningún registro para el nombre de proceso: 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>

Artículos relacionados

Archivo de configuración NLog