概述
版本
| 維運平台版本 | 功能變更 |
|---|---|
| V2.14.0 | - |
應用場景
為了優化資源使用和確定系統穩定，管理者時常需要自訂調整日誌匯出級別：
節省磁碟空間：降低日誌匯出級別，可減少日誌檔案大小，避免磁碟空間不足導致系統效能下降、服務中斷等問題
避免效能瓶頸：在高併發和繁忙的系統中，記錄過多的日誌，可能導致 I/O 操作頻繁，影響系統效能。
幫助故障診斷：在發生問題時，增加日誌詳細程度，幫助快速定位故障。
自動化維運：根據磁碟空間和系統負載動態調整日誌級別，確定系統穩定運作。
功能簡介
維運平台提供自動和手動調整專案日誌的功能。
透過適時調整日誌級別，系統可以兼顧日誌的詳盡性和資源的合理使用，進而提高穩定性、降低成本，並提升維運效率。
日誌類型簡介
| 日誌類型 | 說明 |
|---|---|
| 系統日誌 |
對於啟動 ElasticSearch 作為日誌記錄的專案，指 bi-web/fr 服務中的 fanruan 日誌 對於未啟動 ElasticSearch 作為日誌記錄的專案，指 fanruan.log 日誌
記錄帆軟應用的運作情況，包括系統啟動、功能執行等相關資訊 系統日誌反映了系統的整體運作狀態，可幫助管理者除錯和定位與應用相關的故障 |
日誌級別簡介
日誌的匯出級別分為五種：DEBUG、INFO、WARN、ERROR、FATAL。
日誌嚴重程度：FATAL>ERROR>WARN>INFO>DEBUG
日誌詳細程度：FATAL<ERROR<WARN<INFO<DEBUG
| Log級別 | 說明 |
|---|---|
| DEBUG（除錯） | 除記錄以下所有級別日誌外 會記錄最詳細的除錯資訊，幫助開發者追蹤程式執行流和除錯複雜問題 開發環節適用，該級別的日誌會記錄大量的系統資訊，請謹慎使用 |
| INFO（資訊） | 除記錄以下所有級別日誌外 額外記錄系統正常運作狀態下的一些資訊 生產環節適用，幫助管理者瞭解系統狀態 |
| WARN（警告） | 除記錄以下所有級別日誌外 額外記錄一些雖然不影響系統運作、但潛在的風險 |
| ERROR（錯誤） | 除記錄以下級別日誌外 額外記錄功能無法正常運作或失敗的錯誤 |
| FATAL（致命） | 僅記錄系統當機、致命錯誤等無法恢復的致命問題 |
手動調整日誌級別
在開發除錯、或精準記錄報錯時，可能需要手動調整日誌的匯出級別。
維運平台提供「日誌級別設定」功能：支援對系統日誌的匯出級別進行自訂調整。
操作步驟：
1）管理者登入維運平台，選擇維運專案，點選「日誌>維運日誌」。
2）在「日誌級別」設定中，支援對各種日誌類型設定日誌級別，點選「儲存」生效。
3）如調整日誌級別為DEBUG，會進行二次確認「確定更改？DEBUG級別的日誌，可能會產生大量日誌佔用空間，請謹慎選擇！」，確認後設定生效。
注意事項：
1）同一個專案中，不同節點的日誌類型會保持一致，修改後會對全部節點生效。
2）系統日誌預設日誌級別為INFO。
自動調整日誌級別
在高併發、高負載的系統中，磁碟空間的壓力往往較大，日誌檔案可能迅速增大。
維運平台提供「日誌匯出風險控制」功能：
在伺服器磁碟空間不足時，系統會自動調整日誌的匯出級別，以減少佔用磁碟空間，避免因日誌檔案過大導致伺服器磁碟滿溢問題
待伺服器磁碟空間恢復充足時，系統會自動恢復原來的日誌匯出級別，確定系統的正常運作與日誌的完整性
操作步驟：
1）管理者登入維運平台，選擇維運專案，點選「日誌>維運日誌」。
2）在「日誌匯出風險控制」設定中，開啟「控制開關」（預設開啟）。
3）點選「編輯」按鈕，設定編輯規則：
| 規則 | 說明 |
|---|---|
| 觸發調整為ERROR | 設定值：預設值10，支援輸入1~50的正整數，必須大於FATAL規則觸發值 觸發規則：每一分鐘檢查一次磁碟大小，只要檢查到磁碟剩餘空間≤設定值時，日誌級別自動調整為ERROR |
| 觸發調整為FATAL | 設定值：預設值5，支援輸入1~50的正整數，必須小於ERROR規則觸發值 觸發規則：每一分鐘檢查一次磁碟大小，只要檢查到磁碟剩餘空間≤設定值時，日誌級別自動調整為FATAL |
| 觸發恢復正常 | 日誌級別自動調整後， 每一分鐘檢查一次磁碟大小，如果連續三次檢查到磁碟剩餘空間＞ERROR觸發設定值，日誌級別自動恢復手動的設定 |