Utilisation du pack d'assistance Automation Suite

Vue d’ensemble de l’outil du pack d’assistance Automation Suite, de son contenu et de la manière dont il aide à résoudre les problèmes.

Vue d'ensemble (Overview)

Le pack d’assistance Automation Suite collecte les journaux des services UiPath® au niveau des applications, ainsi que les objets pertinents requis pour évaluer et résoudre le problème. Le pack d'assistance Automation Suite contient également des journaux historiques que vous pouvez utiliser afin d'analyser les modèles dans le cadre de la résolution d'un problème. Les journaux historiques sont particulièrement utiles lorsque la cause profonde potentielle d'un problème n'est pas indiquée simplement en examinant l'état du cluster.

Le pack d’assistance Automation Suite est également nécessaire lorsque vous demandez des conseils ou une solution à l’équipe d’assistance UiPath®, car celle-ci en aura besoin à des fins d’analyse.

Remarque :

Le pack d’assistance Automation Suite ne collecte aucune information d’identification ni données confidentielles vous concernant, concernant votre utilisateur ou votre automatisation, et ne les stocke pas. Les applications UiPath® ne divulguent et ne consignent aucune information confidentielle dans leurs enregistrements. Au niveau de la plateforme, le collecteur de journaux a été conçu de façon à ce que ces informations sensibles soient masquées.

Paramètres du pack d'assistance Automation Suite

• La télémétrie d'utilisation et de configuration résumée de haut niveau est également exportée avec cet outil générant un fichier XML. Cette télémétrie comprend :
  • Détails de la configuration de l'installation d'Automation Suite
  • Informations d'utilisation des ressources au niveau du cluster.
  • Détails de l'exécution de la commande UiPathctl ).
  • Télémétrie d’utilisation :
    • Durée d'exécution du robot par mois par type de robot.
    • Simultanéité des robots : le nombre maximal de robots exécutés en même temps.
    • Métriques sur l'exécution des tâches, l'exécution des processus, les éléments de la file d'attente, le taux d'échec des tâches et les utilisateurs.
    • Informations sur l'environnement.
    • Résumé de la consommation d’AI Units si vous utilisez AI Center.
• UiPath utilise ces données uniquement à des fins de gestion interne afin de renforcer la compréhension des clients et d’améliorer la qualité de l’assistance ainsi que l’expérience globale.
• Vous pouvez télécharger le fichier XML dans le Customer Portal pour partager votre télémétrie d'utilisation auto-hébergée de haut niveau avec l'équipe d'assistance d'UiPath.
• Pour afficher le fichier XML, ouvrez-le à l'aide de SQL Server Management Studio ou de n'importe quelle visionneuse XML.
• Vous pouvez arrêter de générer la télémétrie résumée en ajoutant service-metrics à la liste d’exclusion avec l’option --exclude=service-metrics . Cette option est disponible dans Automation Suite 2.2510 et versions ultérieures.

Génération du bundle d’assistance

Pour générer le pack d'assistance, exécutez la commande suivante à partir du répertoire du programme d'installation :

./bin/uipathctl health bundle cluster_config.json --versions versions/helm-charts.json

À partir d'Automation Suite 2.2510.1, les chemins d'accès au fichier de configuration (cluster_config.json) et au fichier de versions (helm-charts.json) sont facultatifs. Vous pouvez générer le pack d'assistance simplement en exécutant :

./bin/uipathctl health bundle

Cet outil nécessite un certain temps pour rassembler et stocker tous les journaux dans un emplacement temporaire sur votre machine locale ou de gestion.

La table suivante répertorie les indicateurs facultatifs que vous pouvez utiliser pour l'outil de pack d'assistance :

Indicateur	Description
--output-dir string	Spécifie le répertoire où stocker le pack d'assistance.
--namespace string	Spécifiez l’espace de noms dans lequel UiPath Automation Suite est déployée.
--include string	Spécifiez les composants supplémentaires (séparés par des virgules) à inclure dans le bundle (par exemple, --include=historical-logs).
--exclude string	Spécifiez les composants (séparés par des virgules) à exclure du bundle (tels que--exclude=rke2-bundle ou --exclude=service-metrics).
--from YYYY-MM-DD	La date de début de collecte des journaux historiques au format AAAA-MM-JJ.
--days int	Le nombre de jours à partir de la date de début de collecte des journaux historiques.
--limit-bytes int	Limite la taille des journaux des pods en cours d'exécution en fournissant la valeur entière en octets.

Par défaut, si l'indicateur --from n'est pas spécifié, les journaux historiques seront collectés au cours des 2 derniers jours à partir d'aujourd'hui, indépendamment de l --days spécifié. Si --from est spécifié et que --days n'est pas spécifié, les journaux historiques seront collectés pendant 2 jours à compter de la date de début spécifiée.

Le bundle RKE2 est inclus par défaut dans le pack d’assistance. Pour l'exclure, utilisezflag --exclude=rke2-bundle.

Les journaux historiques ne sont pas inclus par défaut dans le pack d'assistance. Pour les inclure, utilisez l'indicateur --include=historical-logs.

Paramètres du pack d'assistance Automation Suite

L'archive .tar.gz contient les fichiers et dossiers suivants :

Fichier/Dossier	Description
logs	Contient les journaux historiques collectés à partir de ceph ou d'un magasin d'objets externe.
current-logs	Contient les journaux en direct (tels que les journaux des instances actuelle et précédente des pods).
events.json	Contient les descriptions d'événements de tous les espaces de noms.
alerts	Contient les alertes Prometheus actives dans le cluster.
server0.tar.gz, server1.tar.gz, ...	Contient le bundle RKE2 pour chaque nœud du cluster.
namespace/resource/object.yaml	Contient les descriptions d'objets pour l'espace de noms préféré ou personnalisé du serveur et les ressources à l'échelle du cluster.
service-metrics	Contient une télémétrie de configuration et d'utilisation de haut niveau stockées dans des fichiers XML individuels.

La structure du bundle RKE2 est la suivante :

Répertoire (Directory)	Description
systemlogs	Contient les journaux liés aux événements système, aux audits de sécurité et aux messages système généraux.
systeminfo	Contient des informations sur les processus en cours d'exécution, l'utilisation du disque, l'utilisation du processeur, etc.
etcd	Contient les informations relatives au stockage des données du magasin clé-valeur etcd .
journald	Contient les journaux gérés par systemd-journald.
networking	Contient les détails de configuration réseau tels que les IPtables, le routage, etc.
rke2	Contient les journaux kubelet, les certificats d'agent et de serveur, les informations sur critique et les ressources exécutées sur le cluster et les journaux des pods.