執行 Bot Agent診斷檢查
使用 Bot Agent診斷公用程式處理 Bot Runner 裝置與 Control Room 之間的連線相關問題。此公用程式提供解決方案或建議來協助診斷問題,以進一步解決問題。
先決條件
確認 Bot Agent已安裝在使用者裝置上。
程序
- 開啟 Windows 命令提示字元。
-
瀏覽至 Bot Agent 安裝路徑。
- Bot Agent安裝在系統層級的預設路徑為 C:\Program Files\Automation Anywhere\Bot Agent。
- Bot Agent安裝在本機使用者層級的預設路徑為 %USERPROFILE%\AppData\Local\Programs\Automation Anywhere\Bot Agent。
-
輸入 AADiagnosticUtility.exe 以執行 Bot Agent診斷公用程式。
執行診斷檢查的各種選項會連同其說明一起顯示。
選項 說明 -checkDownloadError <CR_URL>
如果bot部署失敗,請檢查bot相依性是否下載錯誤。 註: 錯誤訊息會保留在裝置記憶體中,並在 Bot Agent服務重新啟動時移除。當 Bot Runner 裝置連線至 Control Room,但自動化因為相依套件並未下載至 Bot Runner 裝置而失敗時,請使用此選項。在此案例中,公用程式會提供進一步診斷的建議。
-checkProxy <CR_URL>
檢查裝置上的 Proxy 設定。 當 Bot Runner 裝置無法連線至 Control Room 時,請使用此選項來確認 Proxy 是否可用,或已為 Bot Agent設定以供使用。
您還可以選擇使用
importProxy
選項導入代理設置。-checkWSError <CR_URL>
檢查 WebSocket 連線和錯誤。 註: 錯誤訊息會保留在裝置記憶體中,並在 Bot Agent服務從 Windows 工作管理員的 [服務] 分頁重新啟動時移除。Bot Runner 裝置由於 WebSocket 連線錯誤而無法連線至 Control Room 時,此選項能提供進一步調查的可能原因。
-collectLogs
從 Bot Runner 裝置擷取多個記錄,以縮短收集問題相關資訊的處理時間。 使用此選項以擷取並儲存目前日期節點管理員、bot啟動器和事件檢視器記錄,以在執行公用程式的裝置上,對壓縮的資料夾進行除錯和疑難排解。- 對於安裝在系統層級的 Bot Agent,記錄會儲存在 C:\ProgramData\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip
- 對於安裝在本機使用者層級的 Bot Agent,記錄會儲存在 %USERPROFILE%\AppData\Local\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip
Recommendation:- 若要擷取安全性事件的 Windows 記錄,請以更高的權限執行公用程式 (以管理員身分執行)。
如果您在沒有提高權限的情況下執行公用程式,則會顯示下列錯誤:
錯誤:無法擷取 security_event_viewer_<date>.evtx
- 若要節省儲存空間,請在除錯後刪除檔案。
-configProxy <CR_URL>
檢查 Proxy 組態,並視需要設定 Proxy 認證。 當 Bot Runner 裝置因為缺少驗證伺服器的認證而無法連線至 Control Room 時,請使用此選項來設定 Proxy 伺服器認證。登入 Control Room 以確認連線問題已解決。
-importProxy <CR_URL>
將已登入使用者裝置的 Proxy 設定匯入至系統使用者裝置。 註: 您必須有管理員權限才能匯入 Proxy 設定。Bot Runner 裝置由於 Proxy 伺服器問題而無法連線至 Control Room 時,請使用此選項將已登入使用者的 Proxy 設定匯入至 Bot Agent的系統使用者。
此選項會提供下列資訊:- Proxy 伺服器是否經過驗證。
- Control Room URL 會新增至 Proxy 伺服器中的安全收件者清單。
- WebSocket 連線可作為 Proxy 組態的一部分。
-importSSLCertificate path_to_ssl_certificate
如有需要,請將 SSL 憑證匯入 Java 認證存放區。 註: 您必須有管理員權限才能匯入 SSL 憑證。當 Bot Runner 裝置因為無效的 SSL 憑證而無法連線至 Control Room 時,請使用此選項匯入 SSL 憑證。
importSSLCertificatepath_to_ssl_certificate
選項中指定的文件位置可用 。您必須重新啟動 Automation Anywhere Bot Agent服務,以使匯入的憑證生效。
-list
在本機裝置上檢視作用中的bot部署。 使用此選項可檢查並列出正在執行的自動化 (bots)。
-ping <CR_URL>
檢查 Control Room 和 Bot Runner 裝置之間的連線。 使用此選項可檢查 Bot Runner 裝置是否可以 Ping (觸及) Control Room。
-validateSSLCertificate <CR_URL>
檢查有效的 SSL 憑證,並檢視憑證是否有效或無效。 註: 您必須具有讀取權限才能執行此檢查。當 Bot Runner 裝置因為無效的 SSL 憑證而無法連線至 Control Room 時,請使用此選項來檢查並檢視 SSL 憑證是否有效。要解決此問題,請使用
importSSLCertificate
選項。 - 在命令提示字元下輸入以下選項:<filepath>\AADiagnosticUtility.exe -<option> <CR_URL>