À propos des journaux

Vue d'ensemble (Overview)

La page Journaux (Logs) affiche les journaux générés par les Robots dans tous les dossiers auxquels vous avez accès.

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.

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

Afin d'afficher toute la journalisation générée par un Robot pour une tâche spécifique, accédez à la page Tâches, cliquez sur le menu avec les 3 points correspondant à la tâche qui vous intéresse et sélectionnez Afficher les journaux.

Afin de filtrer la journalisation générée par les Robots dans tous les dossiers auxquels vous avez accès, accédez à la page Journalisation et utilisez les filtres souhaités. Notez que certains filtres sont appliqués par défaut, comme Heure, défini sur Dernier jour (Last day). Pour afficher tous les journaux, assurez-vous de supprimer tous les filtres.

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

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 dans le contexte du dossier pour avoir accès aux journaux générés dans ce dossier.