Registros de robot

Los registros son archivos con fecha que contienen información sobre mensajes de eventos, errores y advertencias relevantes para la aplicación.

Los tipos de registros se presentan en las siguientes páginas:

Registros de ejecución de robot

Los registros de ejecución de Robot son mensajes que genera la ejecución de un proceso. Contienen información relacionada con su comportamiento y mensajes definidos por el usuario en el flujo de trabajo.

Los registros de ejecución los genera:

• La actividad Escribir línea, que crea registros a nivel de Seguimiento.
• La actividad Mensaje de registro, que crea registros al nivel especificado en el campo de propiedad de la actividad Nivel.
• Ejecutar un proyecto de automatización, que genera registros que contienen el comportamiento de cada actividad. Estos registros utilizan el Tracenivel si la configuración de Nivel en la ventana de configuración de Orchestrator en UiPath Assistant está establecida como Detallado.

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.

Nota: el nivel de registro establecido en Orchestrator para el robot anula el establecido en UiPath^® Assistant.

Solo los registros que coinciden con el nivel especificado en la configuración de Assistant u Orchestrator se envían a Orchestrator.

Cambiar el nivel de registro predeterminado desde UiPath Assistant:

1. Desde UiPath^® Assistant, ve al menú Preferencias y luego accede a la Configuración 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 está instalado en Modo de servicio, se necesitan Permisos de Administrator para editar esta configuración.

Destino Orchestrator

Si el robot está conectado a Orchestrator, solo aparecen los registros que coinciden con el nivel establecido en Asistente u Orchestrator en la página de Registros.

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.

Destino NLog

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

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

Eliminando Archivos de registro del flujo de trabajo 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 NLog.config:

• 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 de registro se puede personalizar editando el UiPath.Executor.exe.configarchivo , desde la C:\Program Files\UiPath\Studiocarpeta .

Para ello, se debe añadir el siguiente codigo XML bajo la etiqueta <system.serviceModel>.

<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 la actividad, sino también las 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.

Registros de diagnóstico de robot

Los registros de diagnóstico del UiPath Robot ofrecen información relacionada con el propio Robot y su contexto. Son útiles para identificar la causa de un error concreto.

Los registros de diagnóstico de UiPath Robot se guardan en las siguientes ubicaciones:

• En Windows, los registros de diagnóstico relacionados con errores se registran en el Visor de eventos.

• En todas las plataformas, incluyendo Windows, los registros de diagnóstico detallados se escriben en un archivo:

  • %LocalAppData%\UiPath\Logs\internal\Robot.logen Windows cuando el UiPath Robot está instalado en modo usuario.
  • %PROGRAMDATA%\UiPath\Logs\internal\Robot.logen Windows cuando el UiPath Robot está instalado en modo servicio.
  • ~/.local/share/UiPath/Logs/internal/Robot.log en otras plataformas.

Registros de diagnóstico del controlador

E Rastreo del controlador se escribe en un .etlarchivo .

Para habilitar el Rastreo del controlador, abre Solicitud de Comando con derechos de administrador, accede al directorio de instalación utilizando el cdargumento , cd C:\Program Files\UiPath\Studiocomo y ejecuta el UiRobot.exe --enableLowLevelcomando .

Para deshabilitar el Rastreo del controlador, abra Solicitud de Comando con derechos de administrador, acceda al directorio de instalación utilizando el argumento cd, como cd C:\Program Files\UiPath\Studio y ejecute el comando UiRobot.exe --disableLowLevel.

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 UiPath Robot para que los cambios surtan efecto.