Journal des évènements du Robot

Les journaux sont des fichiers portant la date et l'heure de leur création et contenant un historique des événements, des messages d'erreur et des avertissement relatifs à l'application.

Si Orchestrator n'est pas disponible, les journaux sont enregistrés dans une base de données locale (C:\Windows\SysWOW64\config\systemprofile\AppData\Local\UiPath\Logs\execution_log_data), dans l'espace disque disponible, jusqu'au rétablissement de la connexion. Ensuite, les journaux sont envoyés par lots, dans l'ordre de leur création.

Remarque :

La base de données n'est pas supprimée une fois les journaux envoyés à Orchestrator.

L'état d'une tâche est enregistré dans la mémoire du service UiPath Robot. Lorsqu'Orchestrator est à disponible, les informations relatives à l'état de la tâche sont synchronisées entre les deux. Toutefois, si Orchestrator n'est pas disponible et que vous redémarrez le service UiPath Robot, les informations sont perdues. Cela signifie qu'à chaque fois qu'Orchestrator est disponible, la tâche est réexécutée.

Journaux de diagnostic du Robot

Ces journaux contiennent des informations liées au Robot (Robot) et à son environnement direct. Ils sont utiles pour identifier la cause d'une erreur spécifique.

Activer les journaux de diagnostic du Robot

Par défaut, les journaux diagnostic du Robot sont activés et tous les messages de type Erreur (Error) ou Avertissement (Warning) sont enregistrés.

Si vous avez besoin d'enregistrer d'autres types d'évènements, vous pouvez également les activer, à condition que l'option de Traçage faible soit activée. Par défaut, cette option est désactivée.

Pour activer le traçage à faible niveau, exécutez la commande suivante UiRobot.exe --enableLowLevel dans l’invite de commande.

Pour désactiver le traçage à faible niveau, exécutez la commande suivante UiRobot.exe --disableLowLevel dans l’invite de commande.

L'activation de l'option de Traçage faible en tant qu'administrateur, utilisateur local ou encore utilisateur de domaine déclenche le traçage faible pour le fichier .etl et permet un traçage détaillé de l'Executor et du Service du Robot dans l'Observateur d’événements.

Souvenez-vous de commencer par vous rendre dans le répertoire d'installation, en utilisant l'argument cd. Par exemple : cd C:\Program Files (x86)\UiPath\Studio.

Remarque :

Nous vous recommandons d’activer le suivi à faible niveau uniquement lors de l’enquête sur un problème et de le désactiver lorsque la session d’enquête est terminée.

En outre, le fichier .etl contenant les informations de traçage est généré uniquement une fois la fonctionnalité désactivée.

Il est inutile de redémarrer le Robot pour que les modifications prennent effet.

Cibles des journaux de diagnostic du Robot

L'emplacement cible des journaux est contrôlé par le fichier<Installation Folder>\NLog.config. Les journaux de diagnostic sont collectés par l'enregistreur de type interne et sont transférés à l'aide de cibles 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" />

Remarque :

Des droits administrateur sont nécessaires pour pouvoir modifier le fichier NLog.config. Si la cible Interne est modifiée dans le fichier NLog.config, le service UiRobot.exe doit être redémarré pour que les modifications prennent effet.

Consulter le fichier journal .etl

Ce type de fichier peut être ouvert à partir de l'Observateur d'événements.

1. Dans le volet Actions de l'Observateur d'événements, cliquez sur Ouvrir le journal enregistré (Open Saved Log). La fenêtre Ouvrir le journal enregistré (Open Saved Log) s'affiche.

2. Chercher le fichier journal généré par l'option de traçage et cliquer sur Ouvrir pour qu'il apparaisse dans le panneau de gauche, sous Journaux enregistrés (Saved Logs).

3. Sélectionnez le fichier. Notez que le contenu des journaux s'affiche.

   

Journaux d'exécution du Robot

Les journaux d'exécution du Robot sont des messages générés par l'exécution d'un processus. En règle générale, ils contiennent des informations liées au déroulement de celui-ci, ainsi que des messages définis par l'utilisateur.

Les journaux d'exécution peuvent être créés de plusieurs façons :

• L'activité Écrire une ligne (Write Line) génère des journaux au niveau du Traçage.
• L'activité Message du journal des événements (Log Message) génère des journaux appartenant au niveau indiqué dans le champ des propriétés du Niveau (Level).
• L'exécution d'un projet d'automatisation génère des journaux qui contiennent le comportement de chaque activité. Ces journaux ont le niveau de traçage si le paramètre Niveau (Level) dans la fenêtre Paramètres d'Orchestrator (Orchestrator Settings) est défini sur Verbose.

Niveau de journalisation des journaux d'exécution

Le niveau de journalisation par défaut est contrôlé par le paramètre Niveau (Level) stocké dans la fenêtre Paramètres d'Orchestrator (Orchestrator Settings). Par défaut, il est défini sur Information.

Modification du Niveau de Journalisation par défaut dans la fenêtre Paramètres d'Orchestrator (Orchestrator Settings) :

1. Depuis l'assistant UiPath, accédez au menu Préférences, puis aux paramètres d'Orchestrator

2. Sélectionnez le niveau de journalisation de votre choix dans le menu déroulant Niveau, dans la section Journalisation.

   

   Remarque :

   Si le Robot (Robot) est installé en tant que service Windows, vous devez disposer de droits administrateur pour modifier ce paramètre.

Cibles des journaux d'exécution

By default, Execution Logs are stored in a file in the %LocalAppData%\UiPath\Logs folder. The messages are collected by the Execution type logger and can be forwarded by using NLog targets, as specified by the following parameters in the NLog.config file:

<target xsi:type="File" name="executionFile" fileName="${LogDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" concurrentWrites="true" />
<logger name="Execution" minLevel="Trace" writeTo="executionFile" final="true" />

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

De plus, les cibles et le contenu des logs peuvent être configurés en modifiant le fichier <Installation Folder>\NLog.config.

Remarque :

Des droits administrateur sont nécessaires pour pouvoir modifier le fichier NLog.config. Le service du Robot n'a pas besoin d'être redémarré pour que les modifications prennent effet.

Modification supplémentaire des journaux

Si le niveau de journalisation choisi est Détaillé (Verbose), les messages contiennent le déroulement entier de l'exécution. Le format de sortie de journal peut être personnalisé en modifiant le fichier UiPath.Executor.exe.config situé dans le dossier C:\Program Files (x86)\UiPath\Studio. Pour ce faire, un code XML doit être ajouté sous la balise <system.serviceModel>. Par exemple :

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

Puisque la balise <states> ne contient ici que <state name="Faulted"/>, l'ajout du code ci-dessus autorise uniquement les activités de type En échec. L'ajout d'autres paramètres sous la balise <states> (comme par exemple <state name="Executing"/>) étend la journalisation à d'autres types d'activités.

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

Remarque :

Pour que les modifications apportées au fichier UiPath.Executor.exe.config prennent effet, il est nécessaire de redémarrer le service du Robot.

Taille de vidage et intervalle de vidage

The Flush Size and Flush Interval can be changed from the Orchestrator UiPath.Orchestrator.dll.config settings. See the UiPath.Orchestrator.dll.config document for more details.

Remarque :

La commande envoyant les journaux aux déclencheurs Orchestrator à la fin de la période définie pour RobotsLogs.Flush.Interval. Si les journaux s'accumulent et que le robot est déconnecté avant que le délai ne soit écoulé, ces journaux sont envoyés la prochaine fois que le robot se connecte à Orchestrator.