1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
| 11.0.2 | 插件功能轉內建 新增日誌儲存位置查看功能 支援叢集跨節點下載日誌 |
1.2 應用場景
1）當使用者遇到需要使用日誌的場景時，部分公司對機房管控較嚴格，申請進機房流程繁瑣，日誌獲取費時費力。
2）遇到較緊急且又需要日誌定位的問題時，日誌獲取困難可能會影響使用者的使用。
3）使用者向帆軟提產品bug時，需要提供一些必要的客戶環境資訊，但是客戶系統環境資訊因為種種原因獲取耗費時間較大。
1.3 功能簡介
透過「下載日誌」插件：
1）管理者可以按照「操作時間」和「日誌類型」篩選匯出日誌檔案。
2）管理者可以一鍵查看日誌檔案儲存位置。
3）管理者可以一鍵獲取並匯出報表工程環境資訊。
2. 插件簡介
2.1 插件安裝
注：11.0.2 及之後版本，「下載日誌」功能已直接內建，無需安裝插件。
舊版本升級後，已安裝的插件自動禁用，啟用內建功能。
點選下載插件：下載日誌插件
設計器插件安裝方法參照：設計器插件管理
伺服器安裝插件方法參照：伺服器插件管理
2.2 介面介紹
插件安裝完成後，管理者登入數據決策系統，點選「管理系統>智慧維運>平台日誌」，新增「下載日誌」Tab，如下圖所示：
3. 下載日誌
注：叢集環境下，頁面右上角有叢集選擇框，管理者可以直接選擇叢集節點進行下載相應節點日誌。
3.1 操作時間
管理者可選擇需要下載的日誌內容的操作時間範圍。支援「年月日」和「動態時間」。若日期超出當前存在的日誌檔案範圍，則僅下載現有檔案。
年月日：支援直接選擇具體的年月日，例如 2020-01-01。
動態時間：支援根據當前時間推算一個日期，例如今天之前一季度的季初。
3.2 日誌類型
支援匯出多種類型的debug日誌：
注：根據伺服器作業系統和部署方式的不同，可獲取的日誌類型可能不完全相同。
| 日誌 | 說明 |
|---|---|
fanruan.log | 帆軟應用運作日誌 |
| fanruan.gc.log | 帆軟當機日誌 |
| BIEvent.log | 僅 FineBI 專案支援查看和下載該日志 FineBI 配置操作記錄 |
| access.log | Nginx 存取日誌的存取日誌檔案，用於記錄使用者存取網站的請求資訊，如存取時間、IP 地址、請求方法、存取路徑、HTTP 狀態碼等 |
| catalina.log | Tomcat 自己運作的一些日誌，主要記錄 Tomcat 在啟動和暫停時的運作內容 |
| catalina.out | Tomcat 的標準匯出和標準出錯，所有匯出到這兩個位置的都會進入 catalina.out，這裏包含 Tomcat 運作自己匯出的日誌以及應用裏向 console 匯出的日誌 |
| localhost_access_log.txt | Tomcat 的請求存取日誌，請求的時間，請求的類型，請求的資源和傳回的狀態碼都有記錄 |
3.3 效果預覽
點選「一鍵下載」，解壓下載的壓縮包，例如匯出的fanruan.Log日誌內容如下圖所示：
4. 查看儲存位置
點選「查看儲存位置」按鈕，可查看各種日誌的儲存位置，如下圖所示：
5. 匯出環境資訊
點選「一鍵匯出」按鈕，即可匯出環境資訊。如下圖所示：
注：叢集環境下，頁面右上角有叢集選擇框，管理者可以自行選擇需要下載日誌的具體節點。
匯出的檔案格式為xml，內容如下表所示：
| 類別 | 說明 | 範例 |
|---|---|---|
| jar版本 | 當前客戶伺服器系統使用的jar包版本 | 20200608 |
| 工件系統 | 當前客戶伺服器所用工件系統及其版本 | centos7.0 |
| 分配記憶體 | 當前配置的最大堆內記憶體 | 16G |
| 部署方式 | 當前部署的web容器類型及其版本 | Tomcat8.0/Jboss7.0 壓縮部署/非壓縮部署 |
| 是否FRBI整合 | 是否為FRBI整合環境 | 是/否 |
| JDK版本 | 當前應用所使用的JDK版本 | 1.8.0_181 |
| 內建庫是否遷移 | 判斷當前內建庫是否遷移外置庫 | 是/否 |
| 遷移資料庫類型 | 外接資料庫遷移類型 | oracle 11g |
注1：Mac設計器無法獲取部署方式，顯示為unkown。
Windows/Linux設計器獲取的部署方式是tomcat。
注2：支援獲取的部署容器種類如下，其他不支援的均傳回unknown
GERONIMO("geronimo")
GLASSFISH("glassfish")
JBOSS("jboss")
JETTY("jetty")
JONAS("jonas")
OC4J("oc4j")
RESIN("resin")
TOMCAT("tomcat")
WEBLOGIC("weblogic")
WEBSPHERE("websphere")
WILDFLY("wildfly")
UNKNOWN("unknown")
