1. 概述
1.1 版本
| FineBI伺服器版本 | 功能變更 |
|---|---|
| 6.0 | - |
1.2 功能簡介
FineBI 工程運作時，會生成相關日誌檔案進行記錄。
| 日誌類型 | 日誌儲存 | 日誌內容 |
|---|---|---|
| 系統日誌 | 預設儲存在%BI_HOME%\logs\fanruan.log 不允許修改日誌儲存位置 | 記錄系統運作程式中的一些資訊 記錄自助資料集/儀錶板中的資料計算執行日誌 |
| 操作日誌 | 儲存在%BI_HOME%\webapps\webroot\logs\cubes 允許修改日誌儲存位置 | 記錄普通使用者和管理者的使用動作 記錄數據決策系統使用情況、使用者行為、範本存取情況等統計日誌 |
2. 系統日誌
系統日誌記錄系統運作程式中的一些資訊。
日誌儲存在%BI_HOME%\logs\fanruan.log檔案裏，Tomcat伺服器的日誌檔案catalina.out裏也會生成。不支援修改伺服器工程日誌儲存位置。
2.1 日誌級別簡介
系統日誌匯出級別分為五種：DEBUG、INFO、WARN、ERROR、FATAL。
日誌級別大小排序（嚴重程度）：FATAL>ERROR>WARN>INFO>DEBUG
日誌詳細程度排序：FATAL<ERROR<WARN<INFO<DEBUG
| Log級別 | 簡介 |
|---|---|
| DEBUG（除錯） | 指出細粒度資訊事件對除錯應用程式是非常有幫助的，主要用於開發程式中列印一些運作資訊。 注：若將日誌匯出級別設定為 DEBUG 模式，可能會由於日誌列印過多而導致 BI 啟動後沒有控制台顯示或者控制台黑屏。若需要使用 DEBUG 模式，建議將 BI 部署在 tomcat 上。 |
| INFO（資訊） | 在粗粒度級別上突出強調應用程式的運作程式，列印一些感興趣的或者重要的資訊。 可以用於生產環境中匯出程式運作的一些重要資訊，但是不能濫用，避免列印過多的日誌。 |
| WARN（警告） | 表明會出現潛在錯誤的情形，有些資訊不是錯誤資訊，但是也要給程式員的一些提示。 |
| ERROR（錯誤） | 指出雖然發生錯誤事件，但仍然不影響系統的繼續運作。列印錯誤和異常資訊。 如果不想匯出太多的日誌，可以使用這個級別。 |
| FATAL（致命） | 指出每個嚴重的錯誤事件將會導致應用程式的跳出。 這個級別比較高，屬於重大錯誤，可以直接停止程式了。 |
2.2 設定日誌級別
超級管理者登入數據決策系統，點選「管理系統>智慧維運>平台日誌」，點選「全局設定」，可根據需求自行調整日誌級別。如下圖所示：
注：調節日誌級別，僅影響系統日誌的匯出，不影響操作日誌。
3. 操作日誌
3.1 查看操作日誌
操作日誌預設儲存在%BI_HOME%\webapps\webroot\logs\cubes資料夾中，不支援修改儲存位置。
常用的操作日誌，系統已主動為您分析，詳情請參見：平台日誌 。
全部的操作日誌，儲存在cubes資料夾中，可透過資料連結進行查詢分析。詳情請參見：平台日誌 LogDB 資料庫 。
3.2 修改儲存位置
操作日誌預設儲存在%BI_HOME%\webapps\webroot\logs\cubes資料夾中，6.0版本的、Tomcat伺服器部署的工程支援修改儲存位置。
Windows：進入%Tomcat_HOME%\bin目錄。尋找名為setenv.bat的檔案。如果檔案不存在，可以建立一個新的setenv.bat檔案。在檔案中新增以下行來設定，配置完成後重啟工程。
SET "JAVA_OPTS=%JAVA_OPTS% -DSWIFT_HOME=D:\path\logs"
Linux：進入%Tomcat_HOME%\bin目錄。尋找名為setenv.sh的檔案。如果檔案不存在，可以建立一個新的setenv.sh檔案。在檔案中新增以下行來設定，配置完成後重啟工程。
JAVA_OPTS="$JAVA_OPTS -DSWIFT_HOME=\home\path\logs"
3.3 備份操作日誌
FineBI工程支援操作日誌的實時備份和還原。
對於維運平台部署的工程，如在部署時勾選了ElasticSearch組件，ElasticSearch會更換swift（logdb）作為日誌儲存。
如在工程「管理系統>系統管理>標準」介面看到「ElasticSearch連結配置」，說明已啟動ElasticSearch作為日誌儲存。
此時「日誌備份」功能無效，請自行對ElasticSearch資料進行備份
3.3.1 實時備份操作日誌
管理者登入數據決策系統，點選「管理系統>智慧維運>平台日誌」，點選「全局設定」，可開啟「操作日誌實時備份」按鈕，如下圖所示：
操作日誌實時備份的表包括：
fine_record_execute
fine_record_operate
fine_record_email
fine_record_write
fine_schedule_record
開啟「操作日誌實時備份」後，在%BI_HOME%\webapps\webroot\logs\swift_backup下生成備份檔案，按照時間戳來分別儲存，如20211105。如下圖所示：
操作日誌每寫入一筆資料，備份檔案中記錄一筆資料。
備份檔案會跟隨 3.4 節操作日誌的清理邏輯來清理。
3.3.2 還原操作日誌
僅當開啟了「操作日誌實時備份」按鈕後，方可進行操作日誌的還原。
點選「操作日誌備份還原」按鈕，跳出日期選擇框。選擇需要還原的操作日誌日期區間，點選「確定」。
耐心等待一段時間後，跳出「備份還原成功」彈窗。操作日誌即可成功還原，如下圖所示：
注1：若還原程式中重新整理頁面，再次點選「操作日誌備份還原」按鈕，會跳出「正在備份」彈窗，請耐心等待即可。
注2：若還原時檢查到記憶體不足，會跳出提示使用者清理磁碟
注3：若還原時檢查到備份檔案損壞，會提示備份檔案損壞，不進行備份。
3.4 清理操作日誌
超級管理者登入數據決策系統，點選「管理系統>智慧維運>平台日誌」，點選「全局設定」，可對操作日誌檔案進行清理，可以設定「自動清理」和「手動清理」。
1）自動清理：每隔 3 個月自動清理一次，保留近 3 個月的資料。最少會保留3個月，最多實際上會有6個月。
2）手動清理：預設保留近 3 個月的資料，可選擇 0天、1天、1週、1個月、3個月、6個月、12個月。
注1：「操作日誌清理」設定僅影響操作日誌的清理，不影響系統日誌。
注2：近 3 個月是指當前日期往前 3 個月的資料，例如 2019-8-19 日手動清理，預設保留 2019-5-19 ~ 2019-8-19 日的資料。
注3：清理日誌後發現 cubes 資料夾佔用空間仍然很大，原因在於只是清理資料夾裏面的檔案，不會清理資料夾，該目錄下資料夾特別多，而且佔用比較大的空間。
注4：清理後顯示的「當前日誌大小」不是磁碟佔用空間的概念，而是實際所有檔案的大小。詳情參見：
Windows：windows系統中檔案大小和佔用空間不同的原因解析
Linux：du和ls查看檔案大小的差別
如下圖所示：
3）清理預警
日誌檔案過大時通知相關使用者，相關使用者可對日誌進行手動清理，減小日誌檔案大小。
開啟預警功能，設定觸發條件，例如日誌檔案大於 xxxM。
簡訊提醒需要「開啟簡訊功能」，詳細設定請查看 簡訊 ，同時郵件提醒也需要配置寄件人，詳細設定請查看 信箱 。
然後勾選「簡訊提醒、平台訊息、郵件提醒」，再分別設定設定收件人，設定完成後點選「儲存」，如下圖所示：
簡訊提醒效果如下圖所示：
平台訊息效果如下圖所示：
郵件提醒效果如下圖所示：
