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

By default, Internal logs are sent to Event Viewer, as specified in the following lines from 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 archivo NLog.config 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.

   

   Nota:

   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 almacenan en un archivo en 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 archivo NLog.config:

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

If the Robot is connected to Orchestrator, all execution logs are sent to Orchestrator and can be seen in the Logs page.

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:

  El maxArchiveFileses el parámetro que controla el número de archivos de archivo.

  Nota:

  Para modificar el archivo NLog.config 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.

Not only activity states can be modified, but also other things, such as variables and arguments. More information about customization can be found here.

Nota:

La modificación del archivo UiPath.Executor.exe.config requiere un reinicio del mantenimiento de robot de UiPath para que los cambios surtan efecto.