系統日誌
導覽路徑:設定 → 系統 → 系統日誌
系統日誌記錄管理程式運作時的事件:刷圖、排程、休眠、錯誤等。遇到問題時,日誌是找出原因最重要的線索,技術支援也經常需要你提供日誌。
頁面說明
標題旁顯示「共 N 筆,約 X MB」(容量是估計值)。標題下方一行是最近 24 小時的摘要:「最近 24 小時:錯誤 N · 警告 N」。數字是連結,點了會直接篩出最近 24 小時的錯誤(或警告)。
右上角按鈕:
| 按鈕 | 說明 |
|---|---|
| 下載完整日誌 | 把完整日誌與裝置狀態打包成一個檔案,見下載完整日誌 |
| 下載完整日誌旁的 ▼ | 選單裡的「黑盒子事件包」開啟事件包視窗,見黑盒子事件包 |
| 重新整理(↻) | 重新載入列表與摘要,顯示「已重新載入」 |
日誌列表
- 最新的在最上面,依日期分組:每天一個標題(日期、星期與當天筆數),往下捲時標題會固定在上方,隨時知道正在看哪一天。
- 一次載入一批,往下捲到底會自動載入更早的紀錄,不必按按鈕。
- 每一列:時間(時:分:秒)、訊息、操作。訊息不會被截短;CMS 元件的紀錄前面標「CMS ·」。
- 連續相同的訊息合併成一列,後面標「×N」。點「×N」可以看每一次發生的時間。
- 每一列的底色代表等級:
| 等級 | 底色 | 意思 |
|---|---|---|
| DEBUG | 藍 | 除錯細節(正式裝置上通常沒有) |
| INFO | 綠 | 一般事件,例如裝置沒有休眠的原因 |
| WARNING | 黃 | 出了狀況,但已自動重試、恢復或改用替代做法 |
| ERROR | 紅 | 無法自動恢復,需要有人處理,例如刷圖失敗 |
| CRITICAL | 紫 | 嚴重錯誤,例如關機前清除畫面失敗 |
- 操作:
- 眼睛圖示 查看完整訊息:顯示等級、完整時間與可複製的全文。
- 複製圖示 複製:複製成
[時間] [等級] [Thread] 訊息格式(合併的列會附上「×N」),顯示「已複製到剪貼簿」。
篩選日誌
篩選條件排成一列,改了就立即套用:
| 條件 | 說明 |
|---|---|
| 等級 | 「全部(含 INFO)」「警告以上」「錯誤以上」,預設是「警告以上」。要看一般事件(例如裝置為什麼沒有休眠),請改選「全部(含 INFO)」 |
| 時間範圍 | 「1 小時」「今天」「24 小時」「7 天」「全部」「自訂」,預設「全部」。選「自訂」會出現日期時間區間讓你選。時間以裝置時間為準 |
| 來源 | 「App」或「CMS」,不選就是全部 |
| 關鍵字搜尋 | 比對訊息內容,不分大小寫。輸入後按 Enter 或放大鏡套用 |
常用查詢
- 點摘要列的「錯誤 N」:直接看最近 24 小時的錯誤
- 等級選「全部(含 INFO)」,關鍵字
取消休眠:查看裝置為什麼沒有進入休眠 - 等級選「警告以上」,時間範圍選問題發生的那段時間:快速找出異常
下載完整日誌
要向技術支援回報問題時,按頁面右上角的 下載完整日誌,把下載的檔案傳給技術支援就好,不必自己篩選或整理日誌。
- 按 下載完整日誌,開啟對話框。
- 按 打包並下載,等候約 30 秒(畫面顯示「正在打包完整日誌,大約需要 30 秒,請稍候…」)。
- 瀏覽器下載完成後,把檔案傳給技術支援人員。
檔案包含裝置上的完整日誌(系統紀錄、App 日誌、事件包)與目前的裝置狀態,不含任何密碼。內容不受畫面上的篩選條件影響,一定是完整的。產生失敗時稍候再試一次即可。
清除日誌
導覽路徑:設定 → 系統 → 清除日誌
「清除日誌」已從系統日誌頁移到「系統設定」頁,避免回報問題前不小心刪掉。
- 在「系統設定」按 清除日誌。
- 在確認對話框確認「確定要清理過期日誌嗎?此操作無法復原。」,按 確定。
- 顯示清理了幾筆。
清理規則:
- 刪除超過 180 天的紀錄。
- 若仍超過約 500 MB,從最舊的開始刪除,直到低於上限。
日誌不會自動清理
日誌只有在你按下「清除日誌」時才會套用上述規則,平常不會自動刪除。長期使用的裝置,建議偶爾清理一次。要回報問題時,請先下載完整日誌再清除。
黑盒子事件包
裝置平常會持續保留最近 10 分鐘的系統紀錄與運作狀態(這就是「黑盒子」)。發生下列狀況時,會自動存成一個「事件包」,內容包含出事前 10 分鐘、出事當下,以及之後最多 10 分鐘:
- 某個程式當機,或一直重新啟動
- 網路卡消失
- 系統核心出現錯誤
- 溫度、記憶體或儲存空間超過門檻
- CMS 的圖片連續 3 次刷新失敗
- CMS 元件消失
- 軟體更新失敗,被還原回舊版
- 原廠重置
查看與下載:
- 在「系統日誌」頁按右上角「下載完整日誌」旁的 ▼,選 黑盒子事件包,開啟視窗。
- 列表顯示每個事件包的「發生時間」「觸發原因」「大小」與「狀態」。「狀態」為「收集中」表示事件發生後的 10 分鐘還沒結束,完成後變成「完成」。
- 按該列的 下載,把檔案交給技術支援分析。沒有任何事件包時顯示「目前沒有事件包」。
視窗裡的「重新整理」可以重新載入列表。事件包超過大小上限時,列表會在該筆標示「* 事件包超過大小上限,已先捨棄較不重要的訊息。」。讀不到黑盒子時顯示「讀不到黑盒子(服務沒有在執行)。」。
| 項目 | 說明 |
|---|---|
| 軟體更新、恢復出廠設定 | 事件包會保留(原廠重置本身也會留下一個事件包) |
| 數量與容量上限 | 最多 20 個、合計 50 MiB。超過時自動刪除最舊的 |
日誌上傳
導覽路徑:設定 → 系統 → 日誌上傳
開啟後,這台裝置的系統日誌會送到公司的日誌伺服器,讓技術支援能快速找出問題。密碼等敏感內容會先遮蔽再送出。預設為關閉,關閉時完全不會送出。
在「日誌上傳」那一列開啟對話框,打開「日誌上傳」開關,填好下列欄位後按「儲存」(儲存成功顯示「已儲存」):
| 欄位 | 說明 |
|---|---|
| 上傳位址 | 日誌伺服器的網址 |
| 環境名稱 | 用來分辨這台裝置屬於哪個環境的名稱 |
按「測試連線」可以確認伺服器收得到。成功顯示「測試成功,伺服器已收下」;失敗顯示「測試失敗:{原因}」。
對話框與設定列會顯示目前狀況:
| 項目 | 說明 |
|---|---|
| 狀態 | 「正常」:送出順利。「連線中」:正在嘗試連上。「無法連線」:連不到伺服器,並附上原因(「最後錯誤」) |
| 最後成功時間 | 最後一次成功送出的時間,例如「剛剛」「5 分鐘前」;從未成功顯示「從未成功」 |
| 已送出行數、省略行數、丟棄行數 | 已送出:成功送到伺服器的行數。省略:同一個服務短時間內輸出太多行,超出部分不送,避免洗版。丟棄:伺服器連不上太久、裝置上暫存滿了,最舊的行被捨棄 |
連不上伺服器時
伺服器暫時連不上時,裝置會放慢速度持續重試,不影響其他功能。關閉「日誌上傳」就會停止所有送出。
注意事項
- 日誌時間以裝置時間記錄。裝置時間不正確時,日誌時間也會不正確,請先確認時間設定。
- 軟體更新、原廠重置過程的詳細紀錄不在這裡(那時管理程式本身已停止),由技術支援人員另外查看。
- 恢復出廠設定會清除所有系統日誌。
提供日誌給技術支援
- 記下問題發生的大概時間。
- 按 下載完整日誌,把下載的檔案傳給技術支援。
- 連同問題描述、裝置資訊截圖一起提供。