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 (de nivel de información y superiores) para todos los procesos. Esta versión de Insights ingiere todos los registros (de 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

Nota:

• Solo los administradores deben cambiar los valores en el archivo de configuración de Orchestrator.
• Haz una copia de seguridad del archivo UiPath.Orchestrator.dll.config antes de continuar. Puedes encontrar el archivo en C:\Program Files (x86)\UiPath\Orchestrator.
• Reinicia el sitio web después de hacer cambios en el archivo de configuración de Orchestrator.
• Todos los parámetros distinguen entre mayúsculas y minúsculas.
• Para obtener el mejor rendimiento, los registros de UiPath Robots generados en un marco de tiempo de dos años no deberían superar los 200 millones de registros.
• Usa el archivo de configuración de NLog para capturar datos relevantes para Insights en tu entorno y reducir el número de registros generados por los registros de UiPath Robots.

1. Ve a C:\Program Files (x86)\UiPath\Orchestrator y abre el archivo UiPath.Orchestrator.dll.config para modificar la configuración de Orchestrator.
2. Busca los parámetros de los registros de UiPath Robots (p. ej., <logger name="Robot.*" environmentSpecificConfiguration/>)
3. Configura un filtro con una acción predeterminada (p. ej., filters defaultAction="Ignore").
4. Configura las condiciones según el nivel de registro u otros eventos (consulta los ejemplos de reglas de registro).
5. Guarda el archivo y reinicia Orchestrator.

Para obtener más información sobre la configuración del archivo de configuración de Orchestrator, consulta UiPath.Orchestrator.dll.config.

Ejemplos de reglas de registro

Los siguientes ejemplos muestran configuraciones personalizadas de reglas de registro para registros de nivel información y error. Al establecer condiciones específicas, Insights ingiere registros solo para los procesos que configures.

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