À propos de l'outil de diagnostic (Diagnostic Tool)

L’outil de diagnostic UiPath est un utilitaire autonome vous permettant de mieux collecter et prévisualiser les informations de diagnostic, qui sont ensuite packagées et peuvent être envoyées à notre équipe de support technique pour vous aider à résoudre les problèmes potentiels.

Il est livré avec plusieurs collecteurs pour vous aider à recueillir uniquement les informations dont vous avez besoin. De plus, vous pouvez enregistrer les collecteurs sélectionnés en tant que profil à utiliser ultérieurement. Les informations peuvent être collectées depuis Studio, Robot, RobotJS, Activities et Orchestrator.

Vous pouvez télécharger l’outil de diagnostic à partir du centre de ressources dans votre instance Automation Cloud.

Il est également inclus dans l'installation de Studio : vous pouvez le trouver dans le dossier C:\Program Files\UiPath\Studio (pour les installations par machine) ou dans le dossier %localappdata%\Programs\UiPath\Studio (pour les installations par utilisateur).

Pour y accéder, cliquez tout simplement sur le bouton Démarrer (Start) et recherchez l'application Outil de diagnostic (Diagnostics Tool).

Section Démarrer (Start)

L’outil de diagnostic est basé sur des profils qui recueillent des informations à l’aide de collecteurs. Un profil est un ensemble de collecteurs spécialisés dans la collecte d’informations spécifiques, selon les problèmes que vous avez. L’outil est livré avec plusieurs profils prédéfinis, chacun possédant un ensemble spécifique de collecteurs, mais il est également possible de créer vos propres profils, chacun adapté à un problème particulier. Même si vous commencez avec un profil prédéfini, vous pouvez ensuite ajouter ou supprimer des collecteurs, en fonction des informations à collecter.

Profil	Description
Problème lié à Studio/au robot/aux activités	Recueille des informations sur Studio, le Robot ou les activités. Ce profil est livré avec plusieurs collecteurs activés par défaut.
Problème lié à Orchestrator	Recueille des informations sur votre connexion à Orchestrator. Ce profil est livré avec plusieurs collecteurs activés par défaut.
Profil vide	Ce profil n'est pas livré avec des collecteurs sélectionnés. C’est ici que vous pouvez créer des profils personnalisés avec les collecteurs désirés à utiliser plus tard.
Emplacement personnalisé	Recueille des informations en fonction d'un fichier .json que vous fournissez. Vous pouvez sélectionner les collecteurs à utiliser.

En outre, vous pouvez choisir d’importer un package de données collectées .zip précédemment généré à examiner.

La section Configurer

Cette section est l’endroit où tous les collecteurs se trouvent. Les deux premiers profils ont déjà plusieurs collecteurs ajoutés, mais vous pouvez également en ajouter d’autres ou supprimer les collecteurs existants. Les collecteurs disponibles sont les suivants :

Collecteur	Informations collectées
Informations du registre	Clés de registre utilisées, ainsi que le nom de valeur et les données de valeur correspondants.
Informations de l'écran	Affichage ou affichages utilisés, ainsi que le type, la résolution, le DPI et les coordonnées de décalage.
Journaux des événements	Génère un fichier journal .evtx pour l’application sélectionnée. Ce collecteur peut être utilisé avec les filtres suivants : • Période (nombre de jours) • Niveau de l'événement • FiltreSources) (SourcesFilter) (liste des sources d'applications séparées par des virgules)
Variables de l'environnement	Variables système ou environnement locales utilisées, sur la base d’une clause configurable.
Informations de l'ordinateur	Nom, domaine, système d’exploitation, session, administrateur et paramètres proxy de la machine.
Fichiers journaux	Exécution, Studio, ETL et journaux combinés. Ils peuvent être consultés et exportés à partir de chaque section.
Informations du processus	Processus système utilisés.
Installations de produits tiers	Enrôle toutes les applications tierces utilisées.
Installations de UiPath	Enrôle tous les produits UiPath installés sur cette machine, ainsi que la version, le type et le chemin.
Licence (License)	Affiche le type de licence et le statut.
Fichier de paramètres	Enrôle les fichiers UiPath.settings, UiStudio.settings, UiStudio.v2.settings, et NuGet.config disponibles avec la possibilité d’y accéder.
Configuration Web d'Orchestrator	Affiche le fichier Web.config , en fonction de l’emplacement spécifié de la clé de registre et de sa valeur.
Fichier de l'hôte des applications Orchestrator	Affiche le fichier applicationhost.config basé sur un dossier spécifié.
Fichiers	Récupère les fichiers d'un élément DirectoryPath spécifié avec un élément Pattern configurable.
Registre personnalisé	Récupère les clés de registre utilisées, ainsi que le nom de valeur correspondant et les données de valeur à partir d'un chemin d'accès personnalisé.

Si vous n’êtes pas satisfait des collecteurs fournis d’un profil, vous pouvez simplement les supprimer en cliquant sur le bouton x dans le conteneur de collecte correspondant.

Si vous avez besoin de plus de collecteurs, cliquez sur le bouton Ajouter un nouveau collecteur et choisissez celui dont vous avez besoin dans la liste.

Étant donné que vous souhaitez utiliser certains collecteurs plusieurs fois, vous pouvez les ajouter à la liste et cliquer sur le bouton Exporter le profil vers un fichier (Export Profile to File). Cela génère un fichier .json que vous pouvez importer ultérieurement à partir de la section Démarrer.

Certains collecteurs vous permettent de visualiser les informations de manière plus détaillée.

Par exemple, le collecteur Fichiers journaux vous permet d’explorer les fichiers collectés d’un type de journal (ExecutionLogs, StudioLogs, EtlLogs, ou CombinedLogs) dans une fenêtre séparée, avec la possibilité de voir le chemin d’un fichier journal, de l’ouvrir, ou même de choisir quel fichier journal exporter.

De même, le collecteur d’informations de registre affiche uniquement les quelques premiers résultats dans la section Aperçu, mais vous permet d’afficher tous les résultats dans une fenêtre séparée, en cliquant sur le bouton Afficher x sur y, x étant ici le nombre de résultats affiché, et y le total.

Section Aperçu (Preview)

C’est ici que toutes les informations collectées sont affichées. elles sont regroupées dans des boîtes pliables pour rendre les informations facile à lire. Si vous n’êtes pas satisfait de certains collecteurs en particulier, vous pouvez simplement les désactiver afin qu’ils ne soient pas exportés dans le package final.

Les collecteurs que vous ne jugez pas nécessaires d’exporter peuvent être désactivés ici. Il suffit de décocher les collecteurs correspondants puis de cliquer sur Suivant.

Section Exporter (Export)

La dernière section affiche un aperçu des collecteurs utilisés dans le processus. Il ne reste plus qu’à cliquer sur Exporter (Export) pour enregistrer toutes les données collectées dans un package .zip , avec la possibilité d’ouvrir l’emplacement où le fichier est enregistré. Vous pouvez également naviguer entre les sections si vous souhaitez apporter des modifications aux collecteurs.

Arguments de ligne de commande

L’outil de diagnostic peut également être utilisé à partir de l’invite de commande ou de Windows PowerShell. Les arguments et leurs résultats sont les mêmes, quel que soit le mode d’utilisation.

Il peut être consulté comme suit :

• Invite de commande - ouvrez une instance de commande rapide élevée et utilisez la commande cd à l’emplacement de l’outil de diagnostic. Ensuite, utilisez l’un des arguments enrôlés ci-dessous.
• Windows PowerShell - naviguez jusqu’à l’emplacement de l’outil de diagnostic, faites un clic droit dessus et choisissez de l’ouvrir dans PowerShell. Ensuite, utilisez les arguments enrôlés ci-dessous.

Exemple :

UiPath.DiagnosticTool.exe run <[defaultProfile] | [pathToProfile> [Optional Parameter]

Argument	Description
run studio	Exécute le profil par défaut Studio.
run orchestrator	Exécute le profil par défaut Orchestrator.
run <pathToFile>	Exécute un profil de diagnostic personnalisé créé précédemment à partir d’un fichier .json généré.
-o, --output	Spécifie la sortie du package .zip généré contenant toutes les données collectées.

Génération d'un rapport d'outil de diagnostic

Pour générer un rapport d'outil de diagnostic :

1. Cliquez sur Démarrer ( Start ) et recherchez l'application Outil de diagnostic UiPath (UiPath Diagnostics Tool).
2. Sélectionnez les options appropriées dans la section Démarrer (Start) et cliquez sur Suivant ( Next).
3. Configurez les données dans la section Configurer (Configure) et cliquez sur Collecter ( Collect).
   Remarque : une fenêtre de confirmation pour supprimer la progression actuelle apparaît lorsque vous cliquez sur Précédent(Backup).
4. Vérifiez les données dans la section Aperçu (Preview) et cliquez sur Suivant ( Next).
5. Cliquez sur Exporter ( Export) dans la section Exporter (Export).
6. Enregistrez le fichier .zip sur votre machine.
7. Envoyez le fichier .zip généré vers l'équipe du support technique.