當前為5.1版本文檔,更多實例內容將在最新幫助文檔中展現,點選跳轉至 最新版幫助文檔

日誌簡介

1. 概述

1.1 版本

BI 伺服器版本功能變更
5.1
-
5.1.15

2.3節,「清理系統日誌」功能新增防刷屏機制

3.3節,「日誌清理」更名為「操作日誌清理」

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 設定日誌級別

超級管理員登入資料決策系統,點選「管理系統>智慧維運>平台日誌」,點選「全局設定」,可根據需求自行調整日誌級別。如下圖所示:

注:調節日誌級別,僅影響系統日誌的輸出,不影響操作日誌。

2.3 清理系統日誌

    1)版本 5.1.11 之前

    系統不自動清理%BI_HOME%\logs\fanruan.log檔案。系統日誌預設級別為「ERROR」。

    若安裝「BI日誌自動清理」外掛,則系統日誌預設級別修改為「INFO」,每日凌晨系統自動檢測%BI_HOME%\logs\fanruan.log檔案,僅保留最近1個月的logs檔案。

    2)版本 5.1.11 及之後

    產品內建「BI日誌自動清理」外掛,系統日誌預設級別為「INFO」。每日凌晨系統自動檢測%BI_HOME%\logs\fanruan.log檔案,僅保留最近1個月的logs檔案。

    如需取消自動清理系統日誌,請解除安裝「系統管理>外掛管理」中的「BI日誌自動清理」外掛。

    注:為了避免重複日誌輸出導致日誌檔案資訊冗餘,佔用過大,V1.0.2 及以上版本的「BI日誌自動清理」外掛增加日誌防重複功能。

    • 需要列印的日誌內容相同則視作重複日誌。

    • 對無堆棧資訊的日誌, 記錄歷史日誌資訊20條(不重複)。

    • 對有堆棧資訊的日誌, 記錄歷史日誌資訊10條(不重複)。

    • 新列印的日誌在歷史記錄中, 且重複列印次數超過3次, 則不列印到日誌檔案中。

    • 重複不列印的日誌資訊, 重複次數超過一定限度, 到第5/10/整十/整百/整千/整萬次會列印帶有重複次數的日誌資訊。

    3. 操作日誌

    3.1 檢視操作日誌

    操作日誌預設儲存在%BI_HOME%\webapps\webroot\logs\cubes資料夾中,不支援修改儲存位置。

    • 常用的操作日誌,系統已主動為您分析,詳情請參見:平臺日誌 。

    • 全部的操作日誌,儲存在cubes資料夾中,可通過資料連線進行查詢分析。詳情請參見:報表日誌 LogDB 資料庫 。

    3.2 修改儲存位置

    操作日誌預設儲存在%BI_HOME%\webapps\webroot\logs\cubes資料夾中,5.1.7 及之後版本的工程支援修改儲存位置。

    1)Windows 修改%Tomcat%/bin目錄下的 catalina.bat 檔案,增加配置,配置完成後重啟工程修改。

    等於號“=”後面指定路徑,相對路徑會自動在bin目錄下生成logs資料夾,也可使用絕對路徑。

    SET JAVA_OPTS="$JAVA_OPTS -DSWIFT_HOME=logs”"

    2)Linux/Unix 修改%Tomcat%/bin目錄下的 catalina.sh 檔案,增加配置,配置完成後重啟工程。

    等於號“=”後面指定路徑,相對路徑會自動在bin目錄下生成logs資料夾,也可使用絕對路徑。

    JAVA_OPTS="$JAVA_OPTS -DSWIFT_HOME=logs"

    3.3 清理操作日誌

    超級管理員登入資料決策系統,點選「管理系統>智慧維運>平台日誌」,點選「全局設定」,可對操作日誌檔案進行清理,可以設定「自動清理」和「手動清理」。

    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:清理後顯示的「當前日誌大小」不是磁碟佔用空間的概念,而是實際所有檔案的大小。詳情參見:

    如下圖所示:

    3)清理預警

    日誌檔案過大時通知相關使用者,相關使用者可對日誌進行手動清理,減小日誌檔案大小。

    開啟預警功能,設定觸發條件,例如日誌檔案大於 xxxM。

    簡訊提醒需要「開啟簡訊功能」,詳細設定請檢視 簡訊 ,同時郵件提醒也需要配置發件人,詳細設定請檢視 郵箱 

    然後勾選「簡訊提醒、平台訊息、郵件提醒」,再分別設定設定收件人,設定完成後點選「儲存」,如下圖所示:

    簡訊提醒效果如下圖所示:

    平台訊息效果如下圖所示:

    郵件提醒效果如下圖所示:

    附件列表


    主題: 管理员指南
    已經是第一篇
    已經是最後一篇
    • 有幫助
    • 沒幫助
    • 只是瀏覽
    • 评价文档,奖励 1 ~ 100 随机 F 豆!