平台日誌

1.1 版本

1.2 功能簡介

管理者登入FineReport系統，點選「管理系統>智慧維運>平台日誌」，可看到多項日誌記錄。

平台日誌是對系統運作的各項情況進行監視分析，透過此功能可以查看到系統運作狀態的各種指標。如下圖所示：

1.3 使用前提

非超管使用者如需查看平台日誌，需要擁有「智慧維運」模組和「平台日誌」子模組的使用權限。

超管登入FineReport系統，點選「管理系統>權限管理>普通權限配置」，選中對應使用者。

1）為使用者開通「管理系統>智慧維運」模組的使用權限。

1）為使用者開通「管理系統>智慧維運>平台日誌」子模組的使用權限。

存取統計分為三個方面：系統存取次數、伺服器使用情況、範本存取明細，可簡單分析範本的使用率。

2.1 系統存取次數

「系統存取次數」以指標卡和折線圖的方式介紹系統存取量、被存取範本數、活躍客戶數。

• 支援按照月份篩選存取時間

• 對於多節點叢集工程，從任一節點存取，均可查看整個叢集的日誌資訊

• 如為FineBI和FineReport整合工程，支援篩選統計物件：報表範本、BI範本

2.1.1 資料來源

「系統存取次數」中的資料是過濾 LogDB 資料庫 fine_record_execute 表中的資料。

當「統計物件」選擇「報表範本、BI範本」時，過濾出 fine_record_execute 表中 type 在下表範圍內的資料進行圖表中的指標統計。

注1：fine_record_execute 表欄位具體介紹請參見：LogDB 表結構 。

注2：當「統計物件」選擇「報表範本+BI範本」時，過濾出下表所示的全部資料。

注3：「統計物件」按照範本名稱進行統計。若一張儀表板修改名稱後，改名前和改名後會分為兩個「統計物件」。

2.1.2 計算邏輯

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

2.2 伺服器使用情況

2.2.1 當前系統線上人數

• 沒有連上 Websocket ，當前系統線上人數無法正確顯示，使用者登入不計算在當前系統線上人數中，具體請參見：WebSocket 埠未開放提醒

• 同一個瀏覽器登入兩個帳號，後一個使用者資訊會改寫前一個使用者資訊，只算一個使用者。

• 必須要透過登入頁進入平台，才會被算入當前系統線上人數（單點登入同樣適用），只存取範本，不存取平台，不會計入。

• 有新使用者登入查看當前系統線上人數時，記得重新整理頁面再查看。

2.2.2 具體列表說明

「伺服器使用情況」列表中介紹「XX使用者在XX時間XX地點存取了平台中的XX範本」。

• 這個明細列表中顯示的是當前正在被預覽的報表範本，不考慮是否連上 Websocket ，因此可能與當前系統線上人數不一致。

• 普通使用者登入查看範本，該範本的存取資訊會實時顯示在這個明細列表中。

• 普通使用者關閉正在存取的範本，重新整理平台，明細列表中該範本的存取資訊消失。

2.3 範本存取明細

「範本存取明細」記錄「XX使用者在XX時間XX地點以XX方式存取了系統中的XX範本」，工程下所有範本的存取記錄都會展示在此處。

詳細介紹報表被存取時間，存取的 IP，操作（什麼方式存取的報表如：分頁預覽、填報預覽、資料分析等），角色（登入帳號的角色），帳號。

2.3.1 查詢方法

管理者可選擇某個時間段，預設為「前一日」到「當日」，點選「查詢」，即可查詢該時間段下的明細。

管理者可勾選「進階查詢條件」，選擇需要查詢的內容，再點選查詢，即可查詢出特定設定條件下的明細。

支援篩選操作使用者為空的日誌，支援篩選範本名稱為空的範本。

2.3.2 匯出存取明細

查詢後，管理者可匯出日誌檔案，如下圖所示：

支援匯出範本存取明細，點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。

注：最多只可匯出1W條日誌資料。

2.3.3 操作類型

日誌儲存在 logdb 的 fine_record_execute 表中，詳情請參見：LogDB 表結構 。

操作欄位在 log 裏為數字，對應報表存取方式，已定義的日誌資訊類型如下表所示：

使用者行為分為範本業務和登入登出兩個方面，可獲取使用者具體的操作資訊並進行簡單分析。

3.1 範本業務

1）在「使用者行為>範本業務」介面，支援篩選：操作時間、操作使用者

2）查詢後，以明細表展示指定時間段內使用者對範本的查看次數、匯出次數、列印次數和總操作次數

3）點選帳號超連結，可跳轉到該使用者行為明細表

4）支援匯出日誌，最多只可匯出1W條日誌資料。

點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。

3.2 登入登出

11.0.13 版本新增「登入登出」日誌記錄功能，記錄使用者的每個登入、登出請求，便於檢驗使用者登入情況。

記錄範圍包括：預設登入、跨域登入、遠端設計、第三方和行動端。

3.2.1 查詢方法

1）在「使用者行為>登入登出」介面，支援篩選：

• 操作時間：某個時間段，預設為「前一日」到「當日」

• 操作使用者：執行登入登出操作的平台帳號，預設全選

• 操作類型：登入、註銷、逾時登出、保持登入，預設全選

• 操作結果：成功、失敗，預設全選

2）點選「查詢」，即可查詢該時間段下使用者的登入登出記錄

3）查詢後，管理者可匯出日誌檔案，最多只可匯出1W條日誌資料。

• 點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。

3.2.2 計算邏輯

登入登出日誌儲存在 logdb 的 fine_record_login 表中，對應的說明如下表所示，詳情請參見：LogDB 表結構 。

支援範本存取量分析，以便管理者瞭解業務熱點。

1）在「範本熱度」介面，支援篩選：操作時間、範本名稱

2）點選「查詢」，以明細表形式展示指定時間段內，各個範本的查看次數、匯出次數、列印次數和總操作次數。

• 明細表以總操作次數降冪展示。

• 範本名稱是目錄管理中配置的目錄名稱。如果透過非平台目錄（範本 URL 或鑽取）查看範本，範本名稱為空。

• 被存取資源，為範本在工程中的存放路徑。

• 同一張範本，如果掛載在平台多個目錄中，將分為多條記錄進行統計。

• 同一張範本，如果透過URL 查看，或者透過鑽取查看，將分為多條記錄進行統計。

3）點選被存取資源超連結，跳轉展示該範本的明細存取情況，按時間先後展示明細資料。

4）查詢後，管理者可匯出日誌檔案，最多只可匯出1W條日誌資料。

點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。

支援範本的回应效能分析，為管理者優化系統提供參考。

展示已完成使用者請求的範本，最長回应時間，最短回应時間，平均耗時，記憶體佔用。設定日期參數，同時設定操作行為類別參數，如下圖所示：

勾選「詳細資訊」，效果如下圖所示：

查詢後，管理者可匯出日誌檔案，如下圖所示：

支援匯出日誌，點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。

注：最多只可匯出1W條日誌資料。

同存取統計，點選查詢，顯示出日誌資訊：平台模組、平台設定項，操作使用者、操作IP、操作時間、被存取資源、操作類型，如下圖所示：

操作類型包含：

勾選「進階查詢條件」，如下圖所示：

查詢後，管理者可匯出日誌檔案，如下圖所示：

支援匯出日誌，點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。

注：最多只可匯出1W條日誌資料。

11.0.1 及之後版本的報表工程，新增「範本報錯」功能。

7.1 範本報錯功能

點選查詢，匯總統計範本使用中的錯誤，包括：範本名稱、被存取資源，錯誤程式碼、錯誤內容、出現次數、總存取次數，如下圖所示：

1）如果透過非平台目錄（範本 URL 或鑽取）查看範本，範本名稱顯示為非掛載存取。

2）同一張範本，如果掛載在平台多個目錄中，將分為多條記錄進行統計。

     同一張範本，如果透過URL 查看，或者透過鑽取查看，將分為多條記錄進行統計。

3）篩選欄中僅顯示有報錯記錄的範本。

點選「錯誤詳情」，顯示對應範本對應報錯類別下的詳細報錯及查詢情況，包括：帳號稱、錯誤詳情、查詢參數、報錯時間、範本預覽結果。

注：為避免報錯資訊冗餘，單次存取僅會記錄出現的前5次報錯

查詢後，管理者可匯出範本報錯日誌檔案，如下圖所示：

支援匯出日誌，點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。

注：最多只可匯出1W條日誌資料。

7.2 範本報錯通知

管理者登入數據決策系統，點選「管理系統>智慧維運>平台日誌」，點選「全局設定」，支援開啟「範本報錯通知」，如下圖所示：

若開啟了「範本報錯通知」，系統將在每日凌晨 2 點檢查前一天的報錯範本，存在報錯範本時可透過簡訊提醒、平台訊息、郵件提醒三種形式通知管理者。

注：

1）簡訊提醒：需要開啟簡訊平台，詳細點選 簡訊

2）郵件提醒：需要配置郵件伺服器，詳細點選 郵箱

3）平台訊息：需要在負載均衡層面配置websocket埠並且開放，相關文檔：Websocket簡介