Effectuer des vérifications diagnostiques de l'Bot Agent

Utilisez l'utilitaire de diagnostic de l'Bot Agent pour les problèmes de connectivité entre le périphérique Bot Runner et la Control Room. L'utilitaire aide à diagnostiquer les problèmes en fournissant des solutions ou des suggestions pour aider à résoudre les problèmes.

Prérequis

Assurez-vous que l'Bot Agent est installé sur le périphérique utilisateur.

Procédure

  1. Ouvrez l'invite de commande de la fenêtre.
  2. Accédez au chemin d'installation de la Bot Agent.
    • Le chemin par défaut pour l'Bot Agent installé au niveau du système est C:\Program Files\Automation Anywhere\Bot Agent.
    • Le chemin par défaut pour l'Bot Agent installé au niveau de l'utilisateur local est %USERPROFILE%\AppData\Local\Programmes\Automation Anywhere\Bot Agent.
  3. Saisissez AADiagnosticUtility.exe pour exécuter l'utilitaire de diagnostic de l'Bot Agent.
    Les différentes options permettant d'effectuer la vérification diagnostique sont affichées avec leur description.
    Option Description
    -checkDownloadError <CR_URL> Vérifiez les erreurs de téléchargement de dépendance de robot si le déploiement du robot échoue.
    Remarque : Les messages d'erreur sont conservés dans la mémoire du périphérique et sont supprimés lorsque le service de l'Bot Agent est redémarré.

    Utilisez cette option lorsque le périphérique Bot Runner est connecté à la Control Room mais que les automatisations échouent car les packages dépendants ne sont pas téléchargés sur le périphérique Bot Runner. Dans ce cas, l'utilitaire fournit des suggestions pour un diagnostic plus approfondi.
    -checkProxy <CR_URL> Vérifiez les paramètres de proxy sur le périphérique.

    Lorsque le périphérique Bot Runner ne parvient pas à se connecter à la Control Room, utilisez cette option pour vérifier si un proxy est disponible ou configuré pour l'Bot Agent à utiliser.

    Vous avez également la possibilité d'importer les paramètres de proxy à l'aide de l'option importProxy.

    Remarque : Vous pouvez définir les paramètres de proxy authentifié de votre périphérique pendant le processus d'enregistrement de l'Bot Agent et les mettre à jour via l'utilitaire de diagnostic de l'Bot Agent. Les mêmes informations d'identification sont utilisées pour tous les utilisateurs du périphérique.
    -checkWSError <CR_URL> Vérifiez la connectivité WebSocket et les erreurs.
    Remarque : Les messages d'erreur sont conservés dans la mémoire du périphérique et sont supprimés lorsque le service de l'Bot Agent est redémarré depuis l'onglet Services du Gestionnaire de tâches Windows.

    Lorsqu'un périphérique Bot Runner ne peut pas se connecter à la Control Room en raison d'erreurs de connexion WebSocket, cette option fournit les raisons possibles pour une enquête plus approfondie.
    -collectLogs Réduisez le délai de collecte des informations sur les problèmes en capturant plusieurs journaux à partir du périphérique Bot Runner.
    Utilisez cette option pour capturer et enregistrer le gestionnaire de nœuds du jour, le lanceur du robot et l'observateur d'événements pour le débogage et le dépannage dans un dossier compressé sur le périphérique où l'utilitaire est exécuté.
    • Pour l'Bot Agent installé au niveau du système, les journaux sont enregistrés dans C:\ProgramData\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip
    • Pour l'Bot Agent installé au niveau de l'utilisateur local, les journaux sont enregistrés dans %USERPROFILE%\AppData\Local\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip
    Remarque :
    • Pour capturer les journaux Windows pour les événements de sécurité, exécutez l'utilitaire avec des privilèges élevés (exécuter en tant qu'administrateur).

      Si vous exécutez l'utilitaire sans privilèges élevés, l'erreur suivante s'affiche :

      Erreur : Impossible de capturer security_event_viewer_<date>.evtx
    • Pour économiser de l'espace de stockage, supprimez le fichier après le débogage.
    -configProxy <CR_URL> Vérifiez la configuration du proxy et configurez les informations d'identification du proxy, si nécessaire.

    Lorsque le périphérique Bot Runner ne peut pas se connecter à la Control Room en raison de l'absence d'informations d'identification pour un serveur authentifié, utilisez cette option pour configurer les informations d'identification du serveur proxy. Vérifiez que le problème de connectivité est résolu en vous connectant à la Control Room.
    -importProxy <CR_URL> Importez les paramètres de proxy d'un périphérique utilisateur connecté vers le périphérique utilisateur système.
    Remarque : Vous devez disposer de l'autorisation d'administrateur pour importer les paramètres de proxy.

    Lorsque le périphérique Bot Runner ne peut pas se connecter à la Control Room en raison de problèmes liés au serveur proxy, utilisez cette option pour importer les paramètres de proxy d'un utilisateur connecté vers l'utilisateur système pour l'Bot Agent.

    Cette option fournit des informations sur les éléments suivants :
    • Si le serveur proxy est authentifié ou non.
    • L'URL de la Control Room est ajoutée à la liste des destinataires sûrs dans le serveur proxy.
    • Les connexions WebSocket sont autorisées dans le cadre de la configuration du proxy.
    -importSSLCertificate path_to_ssl_certificate Importez un certificat SSL dans le magasin d'informations d'identification Java, si nécessaire.
    Remarque : Vous devez disposer de l'autorisation d'administrateur pour importer le certificat SSL.

    Lorsque le périphérique Bot Runner ne peut pas se connecter à la Control Room en raison d'un certificat SSL invalide, utilisez cette option pour importer le certificat SSL. Vous devez vous assurer qu'un fichier de certificat valide est disponible dans l'emplacement de fichier spécifié dans l'option importSSLCertificatepath_to_ssl_certificate.

    Vous devez redémarrer le service de l'Bot Agent Automation Anywhere pour que le certificat importé devienne effectif.
    -list Affichez les déploiements de robot actifs sur les périphériques locaux.

    Utilisez cette option pour vérifier et lister les automatisations (robots) qui sont en cours d'exécution.
    -ping <CR_URL> Vérifiez la connectivité entre la Control Room et les périphériques Bot Runner.

    Utilisez cette option pour vérifier si un périphérique Bot Runner peut exécuter un ping (atteindre) avec la Control Room.
    -validateSSLCertificate <CR_URL> Vérifiez la présence d'un certificat SSL valide et vérifiez si le certificat est valide ou non.
    Remarque : Vous devez disposer de l'autorisation de lecture pour effectuer cette vérification.

    Lorsque le périphérique Bot Runner ne peut pas se connecter à la Control Room en raison d'un certificat SSL invalide, utilisez cette option pour vérifier et afficher si le certificat SSL est valide ou non. Pour résoudre ce problème, utilisez l'option importSSLCertificate.
  4. Saisissez l'option suivante dans l'invite de commandes : <filepath>\AADiagnosticUtility.exe -<option> <CR_URL>
    Par exemple, pour vérifier les erreurs WebSocket, saisissez la commande suivante dans l'invite de commandes : AADiagnosticUtility.exe -checkWSError https://yourcrurl.com/
    L'option renvoie le résultat suivant : Récemment, ce périphérique n'a rencontré aucune erreur Web Socket

    Utilisez les autres options pour effectuer d'autres vérifications diagnostiques.