À propos des journaux

La page Journaux (Logs) affiche les journaux générés par les Robots dans tous les dossiers auxquels l'utilisateur a accès, y compris les journaux générés pour les tâches démarrées via des sessions de débogage à distance.

Pour y accéder, allez dans l’onglet Automatisation (Automations) d'Orchestrator à partir d’un contexte de dossier et sélectionnez Journaux (Logs) parmi les options affichées.

Le tableau ci-dessous contient les descriptions des champs de la page Journaux (Logs).

Champ	Description
Délai (Time)	L'horodatage auquel le journal a été enregistré. Remarque : Vous pouvez trier et filtrer la liste des journaux par Heure (Time).
Niveau (Level)	Niveau de gravité de la journalisation du message. Les options suivantes sont disponibles : Traçage (Trace), Débogage (Debug), Informations (Info), Avertissement (Warn), Erreur (Error) et Fatal. Remarque : Vous pouvez trier et filtrer la liste des journaux par Niveau (Level).
Processus (Process)	Le nom du processus qui a généré un message de journal donné.
Nom de l'hôte	Le nom de la station de travail utilisée pour l'exécution du processus.
Identité de l'hôte	Identité sous laquelle l'exécution a lieu. Les valeurs suivantes sont possibles : <Domain\Username> : tâches exécutées sous ce compte spécifique. Affiché dans les cas suivants : tâches de premier plan quelle que soit la version du Robot ; toutes les tâches exécutées sur des Robots antérieurs à 2021.10 ; tâches Attended exécutées sur des Robots connectés à l'aide d'une clé machine, sans connexion de l'utilisateur. Remarque : pour les Robots antérieurs à la version 2021.10, l'identité de l'hôte est renseignée dynamiquement en fonction des paramètres de compte définis dans Orchestrator. La modification du domain\username du compte utilisé pour exécuter une tâche modifie également l'identité de l'hôte. ROOT - tâches en arrière-plan exécutées sur des robots Linux. NT AUTHORITY\LOCAL SERVICE : tâches exécutées sous l'identité du service de Robot. Affiché pour les tâches d'arrière-plan exécutées sur des Robots 2021.10 et ultérieurs sans informations d’identification. Les robots en mode service s'exécutent sous NT AUTHORITY\LOCAL SERVICE. Les robots en mode utilisateur s'exécutent sous une certaine identité d'utilisateur. N/A - tâches démarrées à partir de l'Assistant par les utilisateurs connectés à l'aide de la connexion interactive. Pour les robots connectés à l'aide de la clé machine, sans connexion de l'utilisateur, le <Domain\Username> s'affiche.
Message	Le message consigné. Ceci peut être également un message consigné via l'activité Consigner le message (Log Message) dans Studio. Notez que le contenu de cette colonne s'affiche dans la langue du robot, quelle que soit la langue choisie pour Orchestrator.

Remarque : Les journaux générés en dehors du contexte d'un dossier ne peuvent être affichés que dans la base de données Orchestrator et dans Elasticsearch.

Filtrage

Pour afficher tous les journaux générés par un robot pour une tâche indiquée, accédez à la page Tâches (Jobs).

Pour filtrer les journaux selon le nom de la machine hôte sur laquelle ils ont été générés, utilisez le filtre Machine sur la page Journaux (Logs).

Le nouveau filtre fonctionne rétroactivement pour les journaux stockés dans ElasticSearch, tandis que pour les journaux stockés dans la base de données, il ne fonctionne que pour les nouvelles entrées de journal.

Stockage des journaux

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.

Les journaux peuvent être envoyés à ElasticSearch, à une base de données SQL locale et/ou à Insights, vous permettant ainsi de disposer de journaux sans répudiation. Ils sont interdépendants et, de ce fait, un problème rencontré dans l'un n'affecte pas les autres.

Configurez l'emplacement de stockage des journaux dans UiPath.Orchestrator.dll.config, en modifiant la valeur du paramètre writeTo.

La page Journaux (Logs) affiche les entrées que les Robots envoient à Orchestrator si les journaux sont envoyés à Elasticsearch ou à une base de données SQL. Si les journaux sont envoyés à Elasticsearch et à SQL, la page Journaux (Logs) n'affiche que les entrées envoyées à Elasticsearch.

Remarque :

Les performances de la base de données SQL commencent à se dégrader lorsqu’elle atteint 2 millions de journaux Robot, avec une grave dégradation une fois le seuil de 6 millions atteint. Cette dégradation ralentit les recherches dans les journaux et a un impact sur les performances de vos automatisations.

Ces seuils représentent nos moyennes observées. Selon le matériel de votre serveur de base de données, les valeurs peuvent être plus petites ou plus grandes (jusqu'à 2 à 3 fois).

Vous devez nettoyer régulièrement la base de données afin de vous assurer de rester dans ces limites.

Si, toutefois, vos besoins commerciaux nécessitent que vous dépassiez ces seuils, vous devez utiliser Elasticsearch afin de maintenir les performances.

Si vous utilisez Elasticsearch pour stocker vos journaux de robot, veuillez noter que, dans certaines circonstances, seuls 10 000 éléments peuvent faire l'objet d'une requête.

En raison d’une limitation d'Elasticsearch, les locataires Orchestrator de la plate-forme Cloud sont configurés pour ignorer les journaux de robot de plus de 50 Ko. La grande majorité des journaux font en moyenne 2 Ko environ.

Niveaux de journalisation

Les messages sont consignés avec les niveaux suivants : Traçage (Trace), Débogage (Debug), Info, Avertissement (Warn), Erreur (Error) et Fatal(e) (Fatal).

Vous pouvez également envoyer les messages personnalisés à cette page depuis Studio, avec l'activité Message du journal des événements (Log Message). Les messages peuvent être consignés à tous les niveaux décrits ci-dessus et doivent être utilisés à des fins de diagnostic.

Dans la capture d'écran ci-dessous, par exemple, vous remarquez que nous avons consigné un message personnalisé à un niveau de gravité Fatal.

Exportation des journaux

Tous les journaux peuvent être exportés vers un fichier .csv, en cliquant sur le bouton Exporter (Export). Les filtres appliqués à cette page sont pris en compte lorsque ce fichier est généré. Par exemple, si vous choisissez d'afficher uniquement les journaux des 30 derniers jours avec le niveau de gravité Info, seules les entrées qui répondent à ces critères sont téléchargées.

Pour garantir les meilleures performances, notez que les entrées exportées ne sont pas dans l'ordre chronologique inverse.

Les journaux risquent de ne pas être dans l'ordre correct, uniquement dans le scénario suivant :

• Il existe deux ou plusieurs entrées de journal du Robot avec des horodatages pratiquement égaux, à la milliseconde près (l'heure exprimée en yyyy-MM-dd HH\:mm\:ss.fff est la même), mais qui diffèrent au niveau des sous-unités de la milliseconde (les quatre dernières valeurs dans yyyy-MM-dd HH\:mm\:ss.fffffff sont différentes).
• Les journaux s'affichent dans Orchestrator avec l'ordre de tri par défaut dans la grille (tri par heure en ordre décroissant).

Cependant, cela n'affecte pas la base de données et le fichier .csv exporté.

Remarque : Les exceptions du serveur d'Orchestrator et la pile de trace dans la fenêtre Détails de la tâche (Job Details), sont consignées en anglais, quelle que soit la langue choisie par l'utilisateur.

Autorisations

Vous devez posséder l’autorisation Consultation (View) pour les Journaux (Logs) dans le contexte du dossier pour avoir accès aux journaux générés dans ce dossier.