Skip to content

目前檢視:HTML | 下載完整功能說明 PDF

系統日誌 ​

導覽路徑:設定 → 系統 → 系統日誌

系統日誌記錄管理程式運作時的事件:刷圖、排程、休眠、錯誤等。遇到問題時,日誌是找出原因最重要的線索,技術支援也經常需要你提供日誌。

頁面說明 ​

標題旁顯示「共 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)」,關鍵字 取消休眠:查看裝置為什麼沒有進入休眠
  • 等級選「警告以上」,時間範圍選問題發生的那段時間:快速找出異常

下載完整日誌 ​

要向技術支援回報問題時,按頁面右上角的 下載完整日誌,把下載的檔案傳給技術支援就好,不必自己篩選或整理日誌。

  1. 按 下載完整日誌,開啟對話框。
  2. 按 打包並下載,等候約 30 秒(畫面顯示「正在打包完整日誌,大約需要 30 秒,請稍候…」)。
  3. 瀏覽器下載完成後,把檔案傳給技術支援人員。

檔案包含裝置上的完整日誌(系統紀錄、App 日誌、事件包)與目前的裝置狀態,不含任何密碼。內容不受畫面上的篩選條件影響,一定是完整的。產生失敗時稍候再試一次即可。

清除日誌 ​

導覽路徑:設定 → 系統 → 清除日誌

「清除日誌」已從系統日誌頁移到「系統設定」頁,避免回報問題前不小心刪掉。

  1. 在「系統設定」按 清除日誌。
  2. 在確認對話框確認「確定要清理過期日誌嗎?此操作無法復原。」,按 確定。
  3. 顯示清理了幾筆。

清理規則:

  1. 刪除超過 180 天的紀錄。
  2. 若仍超過約 500 MB,從最舊的開始刪除,直到低於上限。

日誌不會自動清理

日誌只有在你按下「清除日誌」時才會套用上述規則,平常不會自動刪除。長期使用的裝置,建議偶爾清理一次。要回報問題時,請先下載完整日誌再清除。

黑盒子事件包 ​

裝置平常會持續保留最近 10 分鐘的系統紀錄與運作狀態(這就是「黑盒子」)。發生下列狀況時,會自動存成一個「事件包」,內容包含出事前 10 分鐘、出事當下,以及之後最多 10 分鐘:

  • 某個程式當機,或一直重新啟動
  • 網路卡消失
  • 系統核心出現錯誤
  • 溫度、記憶體或儲存空間超過門檻
  • CMS 的圖片連續 3 次刷新失敗
  • CMS 元件消失
  • 軟體更新失敗,被還原回舊版
  • 原廠重置

查看與下載:

  1. 在「系統日誌」頁按右上角「下載完整日誌」旁的 ▼,選 黑盒子事件包,開啟視窗。
  2. 列表顯示每個事件包的「發生時間」「觸發原因」「大小」與「狀態」。「狀態」為「收集中」表示事件發生後的 10 分鐘還沒結束,完成後變成「完成」。
  3. 按該列的 下載,把檔案交給技術支援分析。沒有任何事件包時顯示「目前沒有事件包」。

視窗裡的「重新整理」可以重新載入列表。事件包超過大小上限時,列表會在該筆標示「* 事件包超過大小上限,已先捨棄較不重要的訊息。」。讀不到黑盒子時顯示「讀不到黑盒子(服務沒有在執行)。」。

項目說明
軟體更新、恢復出廠設定事件包會保留(原廠重置本身也會留下一個事件包)
數量與容量上限最多 20 個、合計 50 MiB。超過時自動刪除最舊的

日誌上傳 ​

導覽路徑:設定 → 系統 → 日誌上傳

開啟後,這台裝置的系統日誌會送到公司的日誌伺服器,讓技術支援能快速找出問題。密碼等敏感內容會先遮蔽再送出。預設為關閉,關閉時完全不會送出。

在「日誌上傳」那一列開啟對話框,打開「日誌上傳」開關,填好下列欄位後按「儲存」(儲存成功顯示「已儲存」):

欄位說明
上傳位址日誌伺服器的網址
環境名稱用來分辨這台裝置屬於哪個環境的名稱

按「測試連線」可以確認伺服器收得到。成功顯示「測試成功,伺服器已收下」;失敗顯示「測試失敗:{原因}」。

對話框與設定列會顯示目前狀況:

項目說明
狀態「正常」:送出順利。「連線中」:正在嘗試連上。「無法連線」:連不到伺服器,並附上原因(「最後錯誤」)
最後成功時間最後一次成功送出的時間,例如「剛剛」「5 分鐘前」;從未成功顯示「從未成功」
已送出行數、省略行數、丟棄行數已送出:成功送到伺服器的行數。省略:同一個服務短時間內輸出太多行,超出部分不送,避免洗版。丟棄:伺服器連不上太久、裝置上暫存滿了,最舊的行被捨棄

連不上伺服器時

伺服器暫時連不上時,裝置會放慢速度持續重試,不影響其他功能。關閉「日誌上傳」就會停止所有送出。

注意事項 ​

  • 日誌時間以裝置時間記錄。裝置時間不正確時,日誌時間也會不正確,請先確認時間設定。
  • 軟體更新、原廠重置過程的詳細紀錄不在這裡(那時管理程式本身已停止),由技術支援人員另外查看。
  • 恢復出廠設定會清除所有系統日誌。

提供日誌給技術支援 ​

  1. 記下問題發生的大概時間。
  2. 按 下載完整日誌,把下載的檔案傳給技術支援。
  3. 連同問題描述、裝置資訊截圖一起提供。

相關章節:裝置資訊與監控、疑難排解

Green Ideas Technology