Registros de robot

Los registros son archivos con marca de tiempo que contienen eventos informativos y mensajes de error y advertencia importantes para la aplicación.

Si Orchestrator no está disponible, los registros se almacenan en una base de datos local (C:\Windows\System32\config\systemprofile\AppData\Local\UiPath\Logs\execution_log_data), dentro del espacio de disco disponible, hasta que se restablezca la conexión. Cuando se restablece la conexión, los registros se envían por lotes en el orden en que se han generado.

Nota: la base de datos no se elimina después de que los registros se hayan enviado con éxito a Orchestrator.

El estado de un trabajo se almacena en la memoria del servicio UiPath Robot. Cuando Orchestrator está disponible, la información relativa al estado del trabajo se sincroniza entre ambos. Sin embargo, si Orchestrator no está disponible y se reinicia el servicio UiPath Robot, la información se perderá. Esto significa que cada vez que Orchestrator esté disponible, el trabajo se ejecutará de nuevo.

Registros de diagnóstico de robot

Estos registros ofrecen información relacionada con el propio robot y su contexto. Son útiles para identificar la causa de un error concreto.

Habilitar los registros de diagnóstico de robot

De forma predeterminada, los registros de diagnóstico de robot están habilitados y registran cualquier mensaje con los niveles Error o Advertencia.

Si se necesitan otros niveles de información en el registro, todos ellos pueden habilitarse si se habilita Seguimiento de bajo nivel. De forma predeterminada, esta característica está deshabilitada.

Para habilitar el Seguimiento de bajo nivel, ejecuta el siguiente comando UiRobot.exe --enableLowLevel en el símbolo de sistema.

Para deshabilitar el Seguimiento de bajo nivel, ejecuta el siguiente comando UiRobot.exe --disableLowLevel en el símbolo de sistema.

Habilitar el Seguimiento de bajo nivel como administrador, usuario local o de dominio inicia el seguimiento de bajo nivel para el archivo .etl. Esto habilita el seguimiento detallado para el ejecutor de robot y el mantenimiento del robot de UiPath en el Visor de eventos.

No olvides primero ir al directorio de instalación usando el argumento cd, por ejemplo cd C:\Program Files\UiPath\Studio.

Nota:

Recomendamos habilitar Seguimiento de bajo nivel solo cuando se investiga un problema, y deshabilitarlo cuando finalice la sesión de investigación.

Además, el archivo .etl que contiene la información de seguimiento se genera solo después de deshabilitar la función.

No es necesario reiniciar el robot para que los cambios surtan efecto.

Destinos de los registros de diagnóstico de robot

La ubicación de destino de los registros se controla mediante el archivo <Installation Folder>\NLog.config.Los registros de diagnóstico los recoge el registrador de tipo Interno y se reenvían usando destinos de NLog.

De forma predeterminada, los registros internos se envían al Visor de eventos, como se especifica en las siguientes líneas desde NLog.config:

<target xsi:type="EventLog" name="eventLog" layout="${callsite:className=false:includeSourcePath=true:methodName=false} ${message}" source="UiPath" log="Application" />

<logger name="Internal" minLevel="Trace" writeTo="eventLog" />

Nota: para modificar el NLog.configarchivo se requieren permisos de administrador. El servicio UiRobot.exe debe reiniciarse si el destino Interno se cambia en el archivo NLog.config para que los cambios surtan efecto.

Abrir el archivo de registro .etl

Este tipo de archivo puede abrirse desde el Visor de eventos:

1. En el Visor de eventos, en el panel Acciones, haz clic en Abrir registro guardado. Se muestra la ventana Abrir registro guardado.
2. Navega hasta el archivo de registro de seguimiento generado y haz clic en Abrir. El archivo se muestra en el panel izquierdo, bajo Registros guardados.

3. Selecciona el archivo. Ten en cuenta que se muestran los contenidos de los registros.

   
   

   

   
   

Registros de ejecución de robot

Los registros de ejecución de robot son mensajes generados por la ejecución de un proceso y suelen contener información relacionada con su comportamiento y los mensajes definidos por el usuario.

Hay varias formas en que se pueden generar los registros de ejecución:

• La actividad Escribir línea crea registros en el nivel de Seguimiento.
• La actividad Mensaje de registro crea registros en el nivel que se especifica en el campo de propiedad Nivel.
• Ejecutar un proyecto de automatización genera registros que contienen el comportamiento de cada actividad. Estos registros tienen el nivel Seguimiento si el ajuste Nivel de la ventana de Configuración de Orchestrator se establece en Verboso.

Nivel de registro de los Registros de ejecución

El nivel de registro predeterminado está controlado por la configuración de Nivel guardada en la ventana de Configuración de Orchestrator. De forma predeterminada, está establecido en Información.

Cambiar el nivel de registro predeterminado desde la ventana de configuración de Orchestrator:

1. Desde UiPath Assistant, ve al menú Preferencias y luego accede a la Configuracion de Orchestrator

2. Selecciona el nivel de registro deseado en el menú desplegable Nivel de registro, bajo la sección Registro.

   
   

   

   
   
   Notra: si el Robot se instala como servicio de Windows, se necesita permiso de administrador para modificar esta configuración.

Destinos de los registros de ejecución

De forma predeterminada, los registros de ejecución se guardan en un archivo de la carpeta %LocalAppData%\UiPath\Logs. Los mensajes los recopila el registrador WorkflowLogging y se pueden reenviar usando destinos de NLog, tal como se especifica en los siguientes parámetros del NLog.configarchivo :

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
  <rules>
    <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
  </rules>
  <targets>
    <target type="File" name="WorkflowLogFiles" fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" keepFileOpen="true" openFileCacheTimeout="5" concurrentWrites="true" encoding="utf-8" writeBom="true" />
  </targets>
</nlog>

Si el robot está conectado a Orchestrator, todos los registros de ejecución se envían a Orchestrator y se pueden ver en la página Registros.

Además, los destinos y el contenido de registro se pueden configurar modificando el archivo <Installation Folder>\NLog.config.

Eliminación de archivos de registro antiguos

Para evitar crear una gran cantidad de archivos de registro que consumen espacio en el disco de la máquina, puedes archivar archivos de registro una vez que se haya alcanzado una cantidad de archivos determinados.

Esto se realiza añadiendo los siguientes parámetros en la <target>etiqueta :

• archiveNumbering="Date"
• archiveEvery="Day"
• archiveDateFormat="yyyy-MM-dd"
• archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"

• maxArchiveFiles="10"

  <?xml version="1.0" encoding="utf-8" ?>
  <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
    <rules>
      <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
    </rules>
    <targets>
      <target type="File"
        name="WorkflowLogFiles"
        fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log"
        layout="${time} ${level} ${message}"
        keepFileOpen="true"
        openFileCacheTimeout="5"
        concurrentWrites="true"
        encoding="utf-8"
        writeBom="true"
        archiveNumbering="Date"
        archiveEvery="Day"
        archiveDateFormat="yyyy-MM-dd"
        archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"
        maxArchiveFiles="10"
      />
    </targets>
  </nlog>

  Nota: maxArchiveFilesel es el parámetro que controla el número de archivos comprimidos.
  Nota: para modificar el NLog.configarchivo se requieren permisos de administrador. No es preciso reiniciar el mantenimiento de robot de UiPath para que los cambios surtan efecto.

Más modificaciones de los registros

Si el nivel de registro se ha establecido en Verboso, los mensajes contienen todos los detalles sobre las actividades que se ejecutaron. Esta salida del registro se puede personalizar modificando el archivo UiPath.Executor.exe.config, que puede encontrarse en la carpeta C:\Program Files\UiPath\Studio. Para hacerlo hay que añadir código XML bajo la etiqueta <system.serviceModel>. Por ejemplo:

<tracking>
    <profiles>
        <trackingProfile name="StandardProfile">
         <workflow>
          <activityStateQueries>  
            <activityStateQuery activityName="*">
                <states>  
                    <state name="Faulted"/>  
                </states>
                <arguments>  
                    <argument name="*"/>  
                </arguments> 
                 <variables>  
                    <variable name="*"/>  
                </variables>             
            </activityStateQuery>
          </activityStateQueries>    
         </workflow>
        </trackingProfile>       
    </profiles>
</tracking>

Como la etiqueta <states> solo contiene <state name="Faulted"/>, al insertar el código anterior solo se habilita el registro de las actividades que tienen el estado Defectuoso. Añadir otros parámetros bajo la etiqueta <states>, como <state name="Executing"/>, hace que también se registren actividades que tienen otros estados.

No solo se pueden modificar los estados de actividad, sino también otras cosas, como variables y argumentos.Puedes encontrar más información sobre la personalización aquí.

Nota: la modificación del UiPath.Executor.exe.configarchivo requiere un reinicio del mantenimiento de robot de UiPath para que los cambios surtan efecto.