平台日志

1.1 版本

1.2 功能簡介

系統情況是對系統運行的各項情況進行監控分析，通過此功能可以查看到系統運行狀态的各種指标，包括訪問統計、用戶行爲、模板熱度、性能監控、管理日志、出錯日志。如下圖所示：

進入數據決策系統，選擇管理系統>智能運維>平台日志，點擊全局設置圖标；

設置界面如下圖，包括系統日志級别、日志清理 。如下圖所示：

2.1 系統日志級别

調節%FR_HOME%\logs的日志級别，僅影響系統日志的輸出，不影響操作日志。默認爲 ERROR 。如下圖所示：

分爲五種：

• DEBUG：指出細粒度信息事件，對調試應用程序非常有幫助，主要用於開發過程中打印一些運行信息。

• INFO：消息在粗粒度級别上突出強調應用程序的運行過程。打印一些你感興趣或重要的信息，這個可以用於生産環境中輸出程序運行的一些重要信息，但是不能濫用，避免打印過多的日志。

• WARNING：表明會出現潛在的情形，有些信息不是錯誤信息，但是也要給程序員的一些提示。

• ERROR：指出雖然發生錯誤事件，但仍然不影響系統的繼續運行。打印錯誤和異常信息，如果不想輸出太多的日志，可以使用這個級别。

• FATAL：指出每個嚴重的錯誤事件将會導緻應用程序的退出。這個級别計較高，重大錯誤，這種級别就可以直接停止程序了。

其中，日志級别大小排序（嚴重程度）：FATAL>ERROR>WARN>INFO>DEBUG

日志詳細程度排序：FATAL<ERROR<WARN<INFO<DEBUG

用戶可在%FR_HOME%\logs文件夾下的 fanruan.log 文件中查看日志，如下圖所示：

2.2 日志清理

對%FR_HOME%\webapps\webroot\logs\cubes中的日志文件進行清理，可以設置自動清理和手動清理。

1）自動清理：每隔 3 個月自動清理一次，保留近 3 個月的數據。最少會保留3個月，最多實際上會有6個月。

2）手動清理：默認保留近 3 個月的數據，可選擇 0天、1天、1周、1個月、3個月、6個月、12個月。

注1：近 3 個月是指當前日期往前 3 個月的數據，例如 2019-8-19 日手動清理，默認保留 2019-5-19 ~ 2019-8-19 日的數據。

注2：清理日志後發現 cubes 文件夾占用空間仍然很大，原因在於只是清理文件夾裏面的文件，不會清理文件夾，該目錄下文件夾特别多，而且占用比較大的空間。

注3：清理後顯示的「當前日志大小」不是磁盤占用空間的概念，而是實際所有文件的大小。詳情參見：

Windows：windows系統中文件大小和占用空間不同的原因解析 

Linux：du和ls查看文件大小的區别

如下圖所示：

3）清理預警

日志文件過大時通知相關用戶，相關用戶可對日志進行手動清理，減小日志文件大小。

開啓預警功能，設置觸發條件，例如日志文件大於 xxxM。

短信提醒需要「開啓短信功能」，詳細設置請查看 短信 ，同時郵件提醒也需要配置發件人，詳細設置請查看 郵箱 。

然後勾選短信提醒、平台消息、郵件提醒，再分别設置設置收件人，設置完成後點擊保存，如下圖所示：

1）短信提醒效果如下圖所示：

2）平台消息效果如下圖所示：

3）郵件提醒效果如下圖所示：

詳細查看哪個目錄下面的報表被訪問了及使用什麽方式被訪問，還可統計報表被訪問了多少次，爲了查看每個報表的使用率是怎樣的。

統計查看包括系統訪問次數的統計和報表訪問明細兩個方面的信息查看。

注：部署集群後，從任一節點訪問，均可查看整個集群的日志信息。

以折線圖的方式顯示報表訪問的動态信息。點擊管理系統>智能運維>平台日志，「訪問統計」 Tab 頁面如下圖所示：

3.1 系統訪問次數

FineReport 集成到 FineBI 時，「系統訪問次數」界面如下圖所示：

3.1.1 數據來源

「系統訪問次數」中的數據是過濾 LogDB 數據庫fine_record_execute表中的數據。

當「統計對象」選擇報表模板、BI模板時，過濾出fine_record_execute表中type在下表範圍内的數據進行圖表中的指标統計：

注1：fine_record_execute 表字段具體介紹請參見：報表日志 LogDB 數據庫 文檔的 2.3.1 節内容。

注2：當「統計對象」選擇報表模板+BI模板時，過濾出下表所示的全部數據。

注3：「統計對象」按照模板名稱進行統計。若一張儀表板修改名稱後，改名前和改名後會分爲兩個「統計對象」。

3.1.2 計算邏輯

各數值計算邏輯如下表所示：

3.2 服務器使用情況

3.2.1 當前系統在線人數

• 沒有連上 Websocket ，當前系統在線人數無法正确顯示，用戶登錄不計算在當前系統在線人數中，具體請參見：WebSocket 端口未開放提醒

• 同一個浏覽器登錄兩個賬号，後一個用戶信息會覆蓋前一個用戶信息，只算一個用戶。

• 必須要通過登錄頁進入平台，才會被算入當前系統在線人數（單點登錄同樣适用），只訪問模板，不訪問平台，不會計入。

• 有新用戶登錄查看當前系統在線人數時，記得刷新頁面再查看。

3.2.2 具體列表說明

• 這個明細列表中顯示的是當前正在被預覽的報表模板。

• 普通用戶登錄查看模板，該模板的訪問信息會實時顯示在這個明細列表中。

• 普通用戶關閉正在訪問的模板，刷新平台，明細列表中該模板的訪問信息消失。

3.3 模板訪問明細

展示所有訪問模板的記錄。

詳細介紹哪個目錄下面的報表被訪問，訪問時間，訪問的 IP，操作（什麽方式訪問的報表如：分頁預覽、填報預覽、數據分析等），角色（登錄用戶名的角色），用戶名。

選擇某個時間段，默認爲「前一日」到「當日」，點擊「查詢」，即可查詢該時間段下的明細，如下圖所示：

也可勾選「高級查詢條件」，選擇需要查詢的内容，再點擊查詢，即可查詢出特定設置條件下的明細，如下圖所示：

若點擊導出，可将明細導出 log 文件，如下圖所示：

操作字段在 log 裏爲數字，對應報表訪問方式，已定義的日志信息類型如下表所示：

支持查看指定時間段内用戶的訪問頻次以及操作行爲，包括查看、導出等操作。

按用戶分組展現訪問數據，設置日期區間參數、用戶參數，客戶可查詢指定時間段内不同用戶的報表訪問情況，如下圖所示：

點擊用戶名超鏈，點擊用戶名後跳轉到該用戶操作行爲明細，如下圖所示：

支持模板訪問量分析，以便管理員了解業務熱點。統計指定時間段内的模板被訪問頻次，包括查看、導出、打印等訪問操作。

展現時以總操作次數降序展現，模板名稱以平台中配置的名稱顯示，路徑爲模板的路徑，如下圖所示：

點擊模板路徑超鏈，點擊後展示該模板的明細訪問情況，按時間先後展示明細數據。如下圖所示：

支持模板的響應性能分析，爲管理員優化系統提供參考。

展示已完成用戶請求的模板，最長響應時間，最短響應時間，平均耗時，内存占用。設置日期參數，同時設置操作行爲類别參數，如下圖所示：

勾選詳細信息，效果如下圖所示：

同訪問統計，點擊查詢，顯示出日志信息：操作用戶、被訪問資源、操作類型等，如下圖所示：

操作類型包含

• 目錄管理-節點／模板／鏈接／上報标簽：添加／更新／删除

• 用戶管理-全局設置／用戶／部門／部門下職位／職位／職位下人員／角色／角色下人員／平台使用用戶／移動平台用戶：添加／更新／删除

• 權限管理-全局設置／權限設置／權限複用：添加／更新／删除

• 系統管理-登錄／常規／打印／短信／郵箱：打開／關閉／更新

• 備份還原-全局配置／平台配置／報表模板／jar包／插件／更新升級：打開／關閉／添加／更新／删除／還原

• 平台日志-日志設置／訪問明細／用戶行爲／模板熱度／性能監控：更新／導出

• 内存管理-智能預警／内存會話／智能釋放／模板限制／生命周期：結束／更新

• 數據連接：添加／更新／删除

• 注冊信息：更新

• 安全管理-sql防注入／全局水印：打開／關閉／更新

• 定時調度-定時任務／全局設置：添加／更新／删除

• 多級上報-上報流程／上報任務：添加／更新／删除

• 移動平台-移動平台／授權設備／二維碼配置：打開／關閉／更新

• 模板認證-全局設置／權限設置：添加／更新／删除

• 遠程設計權限-權限設置：更新

• 插件管理：安裝/删除/啓用/禁用/更新

勾選高級查詢條件，如下圖所示：

點擊查詢按鈕，查看出錯的日志信息：簡單的出錯信息、時間、模板等，如下圖所示：

注：若想連接到報表日志數據庫可參見：報表日志 LogDB 數據庫