Registro y niveles de registro

Durante la ejecución del proceso, el robot genera un mensaje (registro) para cada paso por el camino. Estos se recopilan y guardan en un archivo de registro. La operación general de recogida y almacenamiento de registros se llama Registro.

Cada registro tiene un nivel de registro, que hace referencia al detalle del mensaje generado.

Los niveles de registro se refieren al tipo de severidad escrita en el archivo de registro.

Niveles de registro en UiPath

El nivel de registro se refiere a cuán detallado debe ser el mensaje generado. Puedes configurarlo mediante:

• la configuración de Nivel de registro en la página UiPath Assistant > Preferencias > General. De forma predeterminada, está establecido en Información.
• la configuración de Nivel de registro en Orchestrator > Gestionar acceso > Usuarios > cuenta de usuario o robot > Configuración del robot.De forma predeterminada, está establecido en Información.
  Nota:

  El nivel de registro que estableces en Orchestrator anula el nivel configurado en UiPath Assistant.

UiPath utiliza los siguientes niveles de registro, enumerados en orden ascendente de su prioridad.

• Off: no se almacenan registros. Este nivel se utiliza normalmente para desactivar el registro.
• Verbose: informa un nivel de granularidad aún mayor, registrando todos los detalles posibles sobre las operaciones de automatización. Esto podría incluir información sobre cambios de variables, llamadas de función o incluso respuestas externas. Muestra todos los registros con el nivel Trace. De forma predeterminada, el nivel Verbose incluye las siguientes entradas de registro:
  • Inicio de ejecución: se genera cada vez que se inicia un proceso.
  • Ejecución terminada: se genera cada vez que se finaliza un proceso.
  • Transacción iniciada: se genera cada vez que el Robot obtiene un elemento de transacción de Orchestrator.
  • Transacción finalizada: se genera cada vez que el robot establece el estado de la transacción en Correcto o Fallido.
  • Información de actividad: se genera cada vez que se inicia una actividad, falla o finaliza dentro de un proceso.
• Trace: estos registros contienen la información más detallada, a menudo utilizada para depurar o realizar el seguimiento de rutas de ejecución de tareas específicas dentro del sistema. Muestra todos los registros con los niveles Trace, Information, Warning, Error y Crítico.
• Information: los registros informativos proporcionan una visión general sobre la ejecución de automatización, como el inicio y el final de las tareas. Muestra todos los registros con los niveles Information, Warning, Error y Crítico.
• Warning: estos registros incluyen problemas menores o cuestiones potenciales que no afectan inmediatamente a la operación actual, pero pueden llegar a ser significativos en el futuro. Muestra todos los registros con los niveles Warning, Error y Crítico.
• Error: los registros generados en este nivel incluyen detalles de los errores que se han producido durante la ejecución, que impiden la operación normal del flujo de trabajo pero no detienen todo el sistema. Muestra todos los registros con los niveles Error y Crítico.
• Crítico: se graban registros que indican un problema o error crítico. Los problemas lo suficientemente graves como para requerir atención inmediata generalmente se registran en este nivel.

Acerca de la información de PII en los registros

Information, Warning, Error, y Critical

Los valores de los argumentos de entrada/salida no tienen seguimiento cuando se utilizan los niveles de registro Information, Warning, Error, Critical. Esto significa que no se envía información PII en los registros de Orchestrator a menos que se añada explícitamente desde Studio.

Trace y Verbose

Los niveles de registro Trace y Verbose rastrean y escriben los valores de los argumentos de entrada/salida en los registros de Orchestrator. Si esos valores incluyen información PII, se añaden a los registros de Orchestrator.

Usar excludeLoggedData para ocultar Information confidencial

La variable excludedLoggedData permite añadir palabras clave para evitar que los valores de las variables y los argumentos se registren en el nivel Detallado.

Esto también se puede conseguir marcando la casilla de verificación Private de cualquier actividad. Más información sobre la protección de la Information confidencial aquí.

"excludedLoggedData": [
      "Private:*",
      "<em>password</em>"
    ],

TiposDeRegistro

Existen varias posibilidades de mensajes de registro, en función del evento que se registre, como se indica a continuación:

Predeterminado

Se genera de forma predeterminada cuando comienza y termina la ejecución de un proceso, cuando se produce un error del sistema y se detiene la ejecución, o cuando los ajustes de registro se configuran para registrar la ejecución de todas las actividades.

Nota:

Estos registros tienen el valor Default del campo logType.

Los eventos registrados por esta categoría son:

• El inicio de ejecución se genera cada vez que se inicia un proceso. Esto se registra a partir del nivel de registro Información.
• El final de la ejecución se genera cada vez que se finaliza un proceso. Esto se registra a partir del nivel de registro Información.
• El inicio de la transacción se genera cada vez que se inicia una transacción dentro de un proceso. Esto se registra a partir del nivel de registro Información.
• El fin de la transacción se genera cada vez que se inicia una transacción dentro de un proceso. Esto se registra a partir del nivel de registro Información.
• El registro de errores se genera cada vez que la ejecución encuentra un error y se detiene. Se registra a partir del nivel de registro Error.
• El registro de depuración se genera si la configuración de registro del robot se establece en Verbosa y contiene nombres de actividad, tipos, valores de variables, argumentos, etc. Esto se registra a partir del nivel de registro Seguimiento.

Definido por el usuario

Se genera según el proceso diseñado por el usuario en Studio, cuando se utiliza la actividad Registrar mensaje o la actividad Escribir línea.

Nota:

Estos registros tienen el valor User del campo logType.

Campos de registro

Hay múltiples tipos de campos de registro que se pueden encontrar en los tipos de mensajes de registro anteriores. Se pueden clasificar de la siguiente manera:

Campos por defecto

• Message - The log message.
• Level - Defines the log severity.
• Timestamp - The exact date and time the action was performed.
• FileName - The name of the .xaml file being executed.
• ID del trabajo: La clave del trabajo que ejecuta el proceso.
• NombreDelProceso*: el nombre del proceso que desencadenó el registro.
• VersiónDelProceso: * - El número de versión del proceso.
• windowsIdentity - The name of the user that performed the action that was logged.
• NombreRobot: * - El nombre del robot (tal como está definido en Orchestrator).
• machineName - The name of the robot machine.
• machineId * - El id de la máquina del robot.
• organizationUnitId * - El ID de la organización de Orchestrator.

*Los campos de registro marcados con un asterisco no pueden anularse utilizando la actividad Añadir campos de registro.

Nota:

Los campos processName y processVersion no aparecen en los registros si el proceso se ejecuta localmente, sin estar conectado a Orchestrator.

Campos específicos de tipo

Estos registros se muestran en función del tipo de registro.

Fin de la ejecución

• TiempoDeEjecuciónTotalEnSegundos
• TiempoDeEjecuciónTotal

Inicio de la transacción

• NombreDeCola
• IDDeTransacción
• EstadoDeTransacción
• iniciado por

Fin de la transacción

• NombreDeCola
• IDDeTransacción
• EstadoDeTransacción
• EstatusDeTransacción
• TiempoDeEjecuciónDeTransacción
• TipoDeExcepciónDeProcedimiento
• Motivo de la excepción de procesamiento
• queueItemReviewStatus
• PrioridadDeElementoDeCola

Registro de depuración

activityInfo, que es un mensaje JSON con los siguientes campos:

• NombreParaMostrar
• Estado (Fallido, Cerrado, En ejecución)
• Actividades
• Argumentos
  Nota:

  Solo totalExecutionTimeInSeconds, totalExecutionTime y queueName están siempre presentes en los mensajes de registro. Variables y Arguments suelen tener subcampos.

Campos definidos por el usuario

Estos campos se definen en Studio mediante la actividad Agregar campos de registro y aparecen en todos los registros posteriores después de que se haya generado la actividad, a menos que se eliminen con la actividad Eliminar campos de registro.

Importante:

Al definir los campos de registro personalizados, comprueba también la descripción con los campos de registro predeterminados para evitar conflictos de información en los archivos de registro referente a los mismos campos de registro. El uso de la misma convención de nombres tanto para los campos de registro personalizados como para los predeterminados podría afectar al proceso que se ejecuta.