平台日誌

1.1 版本

1.2 功能簡介

系統情況是對系統運作的各項情況進行監視分析，透過此功能可以查看到系統運作狀態的各種指標。
包括：存取統計、使用者行為、範本熱度、效能監視、管理日誌、範本報錯、下載日誌。如下圖所示：

詳細查看儀錶板的存取時間，存取次數，存取方式，存取使用者，幫助管理者瞭解每個儀錶板的使用率。
統計查看包括系統存取次數的統計和報表存取明細兩個方面的資訊查看。

2.1 系統存取次數

「系統存取次數」以折線圖的方式介紹系統存取次數、被存取範本數、活躍客戶數。FineReport 整合到 FineBI 時，「系統存取次數」介面如下圖所示：

• 存取時間：可按照月份篩選存取時間。

• 統計物件：可選擇報表範本/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範本」。

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

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

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

2.3 範本存取明細

「範本存取明細」記錄「XX使用者在XX時間XX地點以XX方式存取了系統中的XX範本」，工程下所有範本的存取記錄都會展示在此處。
「範本存取明細」詳細介紹哪個目錄下面的報表被存取，存取時間，存取的 IP，操作（什麼方式存取的 BI 如：分頁預覽、BI 查看、BI 編輯、EXCEL分頁匯出等），角色（登入帳號的角色），帳號等。

2.3.1 查詢方法

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

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

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

2.3.2 匯出存取明細

查詢後，管理者可匯出日誌檔案，如下圖所示：
點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。
注：最多只可匯出1W條日誌資料。

2.3.3 操作型別

部分操作欄位在 log 裏為數字，對應的日誌資訊型別如下表所示：
注：部分操作型別後顯示「？」，懸停可查看具體操作資訊。

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

3.1 範本業務

支援查看指定時間段內使用者的存取頻次以及操作行為，包括查看、匯出等操作。
按使用者分組展現存取資料，設定日期區間參數、使用者參數，客戶可查詢指定時間段內不同使用者的報表存取情況，如下圖所示：
注1：若使用公共連結存取，操作使用者為空。
注2：支援篩選操作帳號為空的日誌。

點選帳號超連結，點選帳號後跳轉到該使用者操作行為明細，如下圖所示：

查詢後，管理者可匯出日誌檔案，如下圖所示：
點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。
注：最多只可匯出1W條日誌資料。

3.2 登入登出

2023-02-21 及之後的 JAR 新增「登入登出」日誌記錄功能。
「登入登出」記錄使用者的每個登入、登出請求，記錄範圍包括：預設登入、跨域登入、遠端設計、第三方和行動端。
支援使用者登入行為分析，可對操作日期、操作結果、操作使用者和操作型別進行篩選，便於使用者檢驗系統的登入情況。

3.2.1 查詢方法

選擇某個時間段，預設為「前一日」到「當日」，點選「查詢」，即可查詢該時間段下的登入登出記錄，如下圖所示：

在複選框內選擇需要查詢的內容，再點選查詢，即可查詢出特定設定條件下的登入登出記錄，如下圖所示：

3.2.2 匯出登入登出日誌

查詢後，管理者可匯出日誌檔案，如下圖所示：
支援匯出日誌，點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。
注：最多只可匯出1W條日誌資料。

3.2.3 日誌查看說明

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

支援範本存取量分析，以便管理者瞭解業務熱點。統計指定時間段內的範本被存取頻次，包括查看、匯出、列印等存取操作。
展現時以總操作次數降冪展現，範本名稱以平台中配置的名稱顯示，路徑為範本的路徑，如下圖所示：

1）如果透過非平台目錄（範本 URL 或鑽取）查看範本，範本名稱為空。
2）同一張範本，如果掛載在平台多個目錄中，將分為多條記錄進行統計。
     同一張範本，如果透過URL 查看，或者透過鑽取查看，將分為多條記錄進行統計。
注1：支援篩選範本名稱為空的範本。
注2：查看次數包括查看BI範本、編輯BI範本、查看BI公共連結三種操作次數。

點選範本路徑超連結，點選後展示該範本的明細存取情況，按時間先後展示明細資料。如下圖所示：

查詢後，管理者可匯出日誌檔案，如下圖所示：
點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。
注：最多只可匯出1W條日誌資料。

支援範本的響應效能分析，為管理者優化系統提供參考。
展示已完成使用者請求的範本，最長響應時間，最短響應時間，平均耗時，記憶體佔用。設定日期參數，同時設定操作行為類別參數，如下圖所示：

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

查詢後，管理者可匯出日誌檔案，如下圖所示：
點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。
注：最多只可匯出1W條日誌資料。

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

操作型別包含：

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

查詢後，管理者可匯出日誌檔案，如下圖所示：
點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。
注：最多只可匯出1W條日誌資料。

7.1 範本報錯功能

點選「查詢」，彙總統計範本使用中的錯誤，包括：範本名稱、被存取資源，錯誤代碼、錯誤內容、出現次數、總存取次數，如下圖所示：
1）如果透過非平台目錄（範本 URL 或鑽取）查看範本，範本名稱顯示為非掛載存取。
2）同一張範本，如果掛載在平台多個目錄中，將分為多條記錄進行統計。
     同一張範本，如果透過URL 查看，或者透過鑽取查看，將分為多條記錄進行統計。
3）篩選欄中僅顯示有報錯記錄的範本。

、

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

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

查詢後，管理者可匯出範本報錯日誌檔案，如下圖所示：
支援匯出日誌，點選「匯出為log」按鈕可匯出 .txt 格式，點選「匯出為excel」可匯出 .xls 格式。
注：最多只可匯出1W條日誌資料。

7.2 範本報錯通知

管理者登入數據決策系統，點選「管理系統>智慧維運>平台日誌」，點選「全局設定」，支援開啓「範本報錯通知」，如下圖所示：
若開啓了「範本報錯通知」，系統將在每日淩晨 2 點檢查前一天的報錯範本，存在報錯範本時可透過簡訊提醒、平台訊息、郵件提醒三種形式通知管理者。

注：
1）簡訊提醒：需要開啓簡訊平台，詳細點選 簡訊
2）郵件提醒：需要配置郵件伺服器，詳細點選 郵箱
3）平台訊息：需要在負載均衡層面配置websocket埠並且開放，相關文檔：Websocket埠被佔用/無法使用