使用增強型記錄專案
Velocity 用戶端的增強型記錄是管理員在 Android 裝置上開啟偵錯記錄並輕鬆擷取記錄檔的一種方式。 對 Velocity 記錄檔、網路記錄檔或畫面擷取檔案使用增強型記錄。 當您使用增強型記錄變更記錄層級時,裝置上任何設定檔中設定的記錄層級都會暫時遭到覆寫。 這可讓您啟動和停止偵錯記錄,而無需修改現有的主機設定檔或將檔案分發到裝置。
建立增強型記錄專案、指定要收集的記錄檔或畫面擷取,然後使用用戶端掃描提供的 QR 碼。 用戶端會開啟偵錯記錄和/或畫面擷取,直到滿足以下其中一個條件為止:
•裝置使用者關閉增強型記錄。
•點選功能表 > 結束關閉用戶端。
•裝置的檔案記憶體不足。
當增強型記錄停止時,用戶端會向使用者顯示訊息、壓縮檔案,然後將其傳送至管理員可以查看的控制台。 如果控制台無法使用,zip 檔案將會儲存到裝置上的 Downloads/com.wavelink.velocity 目錄。
裝置使用者無需 QR 碼即可開啟增強型記錄,但檔案一律儲存在裝置本機,不會傳送至控制台。 如需在沒有 QR 碼的情況下開啟增強型記錄的相關資訊,請參閱使用 Velocity 用戶端。 當您在沒有 QR 碼的情況下開啟增強型記錄時,它不包含畫面擷取檔案。
如果您為增強型記錄專案開啟畫面擷取,用戶端會為使用增強型記錄時處於作用中狀態的每個工作階段,建立一個單獨的畫面擷取檔案 (.wltsc)。
如果裝置是 Android 10,則用戶端無法存取 Downloads/com.wavelink.velocity 目錄,因此會將檔案改儲存在 Android/data/com.wavelink.velocity/files 目錄中。 比 Android 10 更新或更高版本的 Android 裝置允許存取「下載」目錄,但 Android 10 裝置不允許。
QR 碼如何運作?
當您使用 QR 碼開啟增強型記錄時,控制台就像伺服器一樣,可在控制台顯示 QR 碼時,透過 HTTPS 接收檔案。 系統會使用 QR 碼中包含的權杖來保護流量安全。 為了獲得適當的安全性,您應該僅在主動使用增強型記錄時顯示 QR 碼。 如果您選擇列印 QR 碼,建議您對此碼的存取加以限制。 QR 碼專用於產生此碼的控制台。
若要讓控制台從用戶端接收 zip 檔案,當裝置停止記錄時,其必須顯示 QR 碼。 收到的檔案會儲存在「下載」資料夾中。 如果未顯示 QR 碼,控制台將不會接受任何檔案。 (在這種情況下,裝置會顯示控制台無法使用的訊息,並將檔案儲存在本機)。但是,如果您關閉專案並稍後再次開啟該專案,裝置仍然可以將檔案傳送到控制台,前提是在用戶端停止記錄時會顯示相同的 QR 碼。 如果重新啟動控制台或變更主機位址或連接埠,QR 碼將不再有效。
增強型記錄選項
增強型記錄專案包含以下選項:
•客戶。 與專案相關聯之公司或組織的名稱。
•主機。 本機電腦的 IP 位址或主機名稱。 由於 QR 碼中使用了主機位址,因此如果變更主機位址,QR 碼也會變更,而且先前產生的 QR 碼會失效。
•連接埠。 控制台監聽傳入檔案的連接埠。 請確認沒有其他項目正在使用此連接埠。
•包含:
•偵錯記錄。 針對所有要偵錯的工作階段設定記錄層級,並將 Velocity 記錄檔包含在傳送到控制台的檔案中。
•網路記錄 (僅限 TE)。 針對要偵錯的網路記錄設定記錄層級,並將網路記錄檔包含在傳送到控制台的檔案中。 網路記錄檔不適用於 Web 工作階段。
•畫面擷取 (僅限 TE)。 開啟畫面擷取並擷取所有作用中 TE 工作階段的畫面。 每個工作階段都有一個單獨的畫面擷取檔案。 畫面擷取檔案會傳送到控制台。 如需有關使用畫面擷取以自訂畫面的詳細資訊,請參閱設定畫面。
•開啟記錄檔位置。 開啟儲存從裝置傳送的檔案的本機位置。
1.啟動 Velocity 控制台應用程式。
2.按一下畫面右上角的建立按鈕,然後選取增強型記錄。
3.為專案鍵入一個名稱。 也可以提供一個公司,用於專案排序。
4.按一下建立。
專案開啟,您可以進行設定。
從 Velocity 控制台執行前兩個步驟,然後使用 Android 裝置上的 Velocity 用戶端執行其餘步驟。 您可以在沒有 QR 碼的情況下,在裝置上啟動增強型記錄,但記錄完成後,裝置不會將檔案傳送到控制台。
1.在 Velocity 控制台中,開啟增強型記錄專案。
2.按一下右上角的顯示條碼。
3.在 Android 裝置上的 Velocity 用戶端中,導覽至設定檔清單,然後點選功能表 > 增強型記錄。
4.如要求提供密碼,請提供密碼。
5.使用裝置掃描 QR 碼。
6.點選啟動增強型記錄。
用戶端會開啟要求的記錄類型,直到滿足以下其中一個條件為止: 裝置使用者透過點選功能表 > 增強型記錄 > 停止增強型記錄關閉增強型記錄、使用者點選功能表 > 結束,或裝置的檔案記憶體不足。 請確認當裝置嘗試傳送檔案時顯示增強型記錄 QR 碼,而且當控制台收到壓縮檔案時,它們會顯示在「已接收的檔案」清單中。
如果控制台無法使用,用戶端會顯示一則訊息,指出無法聯絡控制台並將記錄檔儲存在本機上。
•如果您已使用 QR 碼啟動增強型記錄且檔案已傳輸至控制台,請導覽至安裝控制台所在 Windows 裝置上的 Downloads\VelocityLogs 目錄,而且每個增強型記錄專案在 VelocityLogs 目錄中都有自己的目錄。 如果您已開啟增強型記錄專案,按一下開啟記錄檔位置按鈕,開啟專用於目前增強型記錄專案的資料夾。 解壓縮檔案,然後使用文字編輯器開啟記錄檔,或將 .wltsc 匯入至主機設定檔。
-或-
•如果您已從用戶端啟動增強型記錄,或記錄檔未傳輸至控制台,請導覽至裝置上的 Downloads/com.wavelink.velocity 目錄。 (或者,如果裝置是 Android 10,請導覽至 Android/data/com.wavelink.velocity/files 目錄)。解壓縮檔案,然後使用文字編輯器開啟記錄檔,或將 .wltsc 匯入至主機設定檔。