1. 概述
1.1 版本
报表服务器版本 | 功能变更 |
---|---|
11.0 | - |
11.0.4 | 新增操作日誌實時備份功能 |
1.2 功能简介
FineReport 工程运行时,会生成相关日志文件进行记录。
日誌类型 | 日誌存储 | 日誌内容 |
---|---|---|
系统日誌 | 預設儲存在%FR_HOME%\logs\fanruan.log 設計器端允許修改日誌儲存位置 伺服器端不允許修改日誌儲存位置 | 記錄系統運作過程中的一些資訊 |
操作日誌 | 儲存在%FR_HOME%\webapps\webroot\logs\cubes 允許修改日誌儲存位置 11.0.4及之後版本支援實時備份 | 記錄普通使用者和管理者的使用動作 |
补充日誌 | 儲存在%FR_HOME%\bin\error.txt 不允許修改日誌儲存位置 | 記錄設計器預期外的報錯 |
2. 系统日誌
系統日誌記錄系統運作過程中的一些資訊。
2.1 日誌级别
系統日誌匯出級別分為五種:DEBUG、INFO、WARN、ERROR、FATAL。
日誌級別大小排序(嚴重程度):FATAL>ERROR>WARN>INFO>DEBUG
日誌詳細程度排序:FATAL<ERROR<WARN<INFO<DEBUG
Log级别 | |
---|---|
DEBUG(除錯) | 指出細粒度資訊事件對除錯應用程式是非常有幫助的,主要用於開發過程中列印一些運作資訊。 |
INFO(資訊) | 在粗粒度級別上突出強調應用程式的運作程式,列印一些感興趣的或者重要的資訊。 |
WARN(警告) | 表明會出現潛在錯誤的情形,有些資訊不是錯誤資訊,但是也要程式員的一些提示。 |
ERROR(错误) | 指出雖然發生錯誤事件,但仍然不影響系統的繼續運作。列印錯誤和異常資訊。 如果不想匯出太多的日誌,可以使用這個級別。 |
FATAL(致命) | 指出每個嚴重的錯誤事件將會導致應用程式的跳出。 這個級別比較高,屬於重大錯誤,可以直接停止程式了。 |
2.2 設計器端
設計器端系統日誌,記錄設計器本地工程運作時的相關日誌。
若設計器遠端連結伺服器工程,日誌並不記錄到設計器日誌中,而是記錄到伺服器端日誌中。
2.2.1 設定日誌級別&儲存位置
設計器預設日誌級別為ERROR,預設儲存在%FR_HOME%\logs\fanruan.log檔案中。
開啟設計器,點選「檔案>選項>進階」,如下圖所示:
在「log匯出配置」處可修改匯出日誌儲存位置。在「log級別設定」處可根據需求自行調整日誌級別。
2.2.2 查看系統日誌
使用者可在設計器右上角點選開啟日誌摺疊框,然後可在彈出框中查看日誌。支援設定日誌顯示型別,支援清空日誌顯示介面,支援全選日誌方便複製。
設計器日誌查看介面預設顯示全部日誌,使用者可自行選擇只顯示「警告」/「錯誤」日誌,如下圖所示:
注:日誌查看介面的清空/顯示,不會導致日誌檔案內的記錄被刪除。
2.3 伺服器端
設計器端系統日誌,記錄伺服器端工程運作時的相關日誌。
若設計器遠端連結伺服器工程,日誌並不記錄到設計器日誌中,而是記錄到伺服器端日誌中。
2.3.1 设置日誌级别
系统日志默认级别为「ERROR」。
超级管理员登录数据决策系统,点击「管理系统>智能运维>平台日志」,点击「全局设置」,可根据需求自行调整日志级别。如下图所示:
2.3.2 日誌存储位置
報表工程部署在伺服器上,例如 tomcat 伺服器,日誌儲存在%FR_HOME%\logs\fanruan.log檔案裏,Tomcat伺服器的日誌檔案catalina.out裏也會生成。
不支援修改伺服器工程日誌儲存位置,不支援自動清理%FR_HOME%\logs\fanruan.log檔案。
用升級工具升級或直接安裝 JAR 包為 2019-05-20 及之後的版本的客戶,每日 0 點定時將 fanruan.log 壓縮,用以節省磁碟空間。
透過更換 JAR 升級的客戶,可直接刪除log4j.properties檔案實現日誌檔案定時壓縮功能。
如需自訂 log4j 配置需求的使用者,請參考文檔進行設定:fanruan.log優化
3. 操作日誌
3.1 查看操作日誌
操作日誌預設儲存在%FR_HOME%\webapps\webroot\logs\cubes不支持修改儲存位置。
常用的操作日志,系统已主动为您分析,详情请参见:平台日誌
全部的操作日誌,儲存在cubes資料夾中,可透過資料連結進行查詢分析。詳情請參見:報表日誌LogDB資料庫
3.2 修改儲存位置
操作日誌預設儲存在%FR_HOME%\webapps\webroot\logs\cubes資料夾中。11.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 備份操作日誌
11.0.4 及之後版本的工程,支援操作日誌的實時備份和還原。
3.3.1 實時備份操作日誌
管理者登入數據決策系統,點選「管理系統>智慧維運>平台日誌」,點選「全局設定」,可開啟「操作日誌實時備份」按鈕,如下圖所示:
操作日誌實時備份的表包括:
fine_record_execute
fine_record_operate
fine_record_email
fine_record_write
fine_schedule_record
開啟「操作日誌實時備份」後,在%FR_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:11.0.4 清理日誌時會同時刪除對應的資料夾。
注4:清理后显示的「当前日志大小」不是磁盘占用空间的概念,而是实际所有文件的大小。详情参见:
Windows:windows系統中檔案大小和佔用空間不同的原因解析
Linux:du和ls查看檔案大小的差別
如下图所示:
3)清理预警
日誌檔案過大時通知相關使用者,相關使用者可對日誌進行手動清理,減小日誌檔案大小。
開啟預警功能,設定觸發條件,例如日誌檔案大於 xxxM。
簡訊提醒需要「開啟簡訊功能」,詳細設定請查看 短信 ,同時郵件提醒也需要配置發件人,詳細設定請查看同时邮件邮箱 。
然後勾選「簡訊提醒」、「平台訊息」、「郵件提醒」,再分別設定設定收件人,設定完成後點選「儲存」,如下圖所示:
簡訊提醒效果如下圖所示:
平台訊息效果如下圖所示:
郵件提醒效果如下圖所示:
4. 補充日誌
補充日志存儲在%FR_HOME%\bin\error.txt文件中,不支持修改存儲位置。
補充日志主要記錄設計器預期外的報錯。