Types de journaux

La plateforme UiPath est équipée d'outils de journalisation pour tous ses composants principaux. Tous les journaux spécifiques à UiPath reposent sur l'infrastructure Nlog.

Ces journaux peuvent être classés selon les caractéristiques suivantes :

Catégorie du journal

Selon la catégorie à laquelle ils appartiennent, c'est-à-dire selon s'ils ont été créés par un utilisateur ou générés automatiquement par le système, les journaux peuvent être :

• Journaux par défaut (Default Logs) : générés par défaut au début et à la fin de l'exécution d'un projet, lorsqu'une erreur système se produit et que l'exécution s'arrête, ou lorsque les paramètres de journalisation sont configurés pour consigner l'exécution de chaque activité. Les événements consignés par cette catégorie sont :

  • Démarrage de l'exécution (Execution Start) : les journaux sont générés à chaque fois qu'un processus est démarré (niveau = Information)
  • Fin de l'exécution (Execution End) : les journaux sont enregistrés à chaque fois qu'un processus est terminé (niveau = Information)
  • Début de la transaction (Transaction Start) : les journaux sont enregistrés à chaque fois qu'un processus est démarré (niveau = Information)
  • Fin de la transaction (Transaction End) : les journaux sont enregistrés à chaque fois qu'une transaction est terminée (niveau = Information)
  • Journal des erreurs (Error Log) : les journaux sont enregistrés à chaque fois que l'exécution rencontre une erreur et qu'elle s'arrête (niveau = Erreur).
  • Journal de débogage (Debugging Log) : les journaux sont enregistrés si la journalisation du Robot est configurée avec le niveau Détaillé (Verbose). Il contient les noms et les types des activités, les valeurs des variables, les arguments, etc.
• Journaux personnalisables (User-Defined Logs) : générés selon le processus conçu par l'utilisateur dans Studio, lorsque l'activité Message du journal des événements (Log Message) ou Écrire une ligne (Write Line) est utilisée.

Champs d'un journal (Log Fields)

Champs par défaut

• Message (Message) - le message du journal des événements
• Niveau (Level) - définit la gravité du journal.
• Timestamp - la date et l'heure exactes de l'événement.
• Nom de fichier (FileName) - le nom du fichier .xaml en cours d'exécution.
• IdTâche (jobId)  * : la clé de la tâche qui exécute le processus.
• NomProcessus (processName)  * : le nom du processus qui déclenche la journalisation
• VersionProcessus (processVersion)  * : le numéro de version du processus.
• windowsIdentity - le nom de l'utilisateur qui a déclenché l'événement qui a été enregistré.
• NomRobot (robotName)  * : le nom du robot (défini dans Orchestrator)
• machineName : le nom de la machine robot.
• IdMachine (machineId) * : l'ID de la machine robot.
• IdUnitéOrganisation (OrganizationUnitId) * : l’ID de l’organisation Orchestrator.

* Les champs de journal marqués d'un astérisque ne peuvent pas être remplacés à l'aide de l'activité Ajouter des champs de journal (Add Log Fields).

Remarque : il est possible que les options processName et processVersion ne s'affichent pas si le processus est exécuté localement sans connexion à Orchestrator.

Champs spécifiques au type

La présence de ces champs de journal varie en fonction du type de journal :

• totalExecutionTimeInSeconds appartient à la catégorie Fin d'exécution (Execution End)
• totalExecutionTime appartient à la catégorie Fin d'exécution (Execution End)
• Nom de la file d'attente (queueName) appartient aux catégories Début de transaction (Transaction Start) et Fin de transaction (Transaction End).
• transactionID appartient aux catégories Début de transaction (Transaction Start) et Fin de transaction (Transaction End).
• transactionState appartient aux catégories Début de transaction (Transaction Start) et Fin de transaction (Transaction End).
• transactionStatus appartient à la catégorie Fin de transaction (Transaction End).
• transactionExecutionTime appartient à la catégorie Fin de transaction (Transaction End).

• activityInfo appartient à la catégorie du journal de débogage. Il s'agit d'un message JSON composé des champs suivants :

  • DisplayName
  • État (State): En échec (Faulted), Fermé (Closed), En cours d'exécution (Executing)
  • Activité
  • Variables

  • Arguments

    Remarque : seuls les 3 premiers sont toujours présents dans le message. Les variables et les arguments ont généralement des sous-champs.

Champs définis par l'utilisateur

Ces champs sont définis dans Studio à l'aide de l'activité Ajouter des champs de journaux (Add Log Fields) et apparaissent dans tous les journaux suivants après la génération de l'activité, sauf s'ils sont supprimées par l'activité Supprimer les champs de journaux (Remove Log Fields).