1. 概述
1.1 版本
| 維運平台版本 | 功能變更 |
|---|---|
| V1.5.5 | - |
| V1.5.7 | 1）支援單次下載叢集多節點日誌 2）支援選擇指定服務類型的日誌 |
| V1.5.9 | 1）「維運日誌」支援查看「日誌基礎資訊」 2）「維運日誌」下載時，支援選擇下載日誌類型 |
| V1.13.0 | 維運平台日誌下載，支援下載更多維運組件相關日誌 |
| V2.0.0 | 交互優化，功能入口位置調整 |
| V2.1.0 | 在專案不可用情況下，仍支援下載維運日誌 |
| V2.3.0 | 新增支援匯出兩種日誌： 1）exporter.log：指標採集日誌 2）FineOperation.log：當機自助處理工具日誌 |
1.2 應用場景
當使用者遇到需要使用日誌的場景時，部分公司對機房管控較嚴格，申請進機房流程繁瑣，日誌獲取費時費力。
FineOps維運平台，支援前端快速定位並下載維運專案的debug日誌。
1.3 日誌簡介
當使用者遇到需要使用日誌的場景時，部分公司對機房管控較嚴格，申請進機房流程繁瑣，日誌獲取費時費力。
FineOps維運平台，支援查看維運日誌儲存位置，支援下載維運日誌，包括以下類型的debug日誌：
| 日誌 | 說明 |
|---|---|
fanruan.log | 帆軟應用運作日誌 |
| standard.log | 僅 FineBI 專案支援查看和下載該日誌 FineBI 叢集日誌資訊，一般預設存放在 logs/cluster 路徑下 |
| eventlog | 僅 FineBI 專案支援查看和下載該日志 記錄了資料集更新在 spark 引擎中計算的具體資訊，用於分析 spark 執行慢問題 |
| BIEvent.log | 僅 FineBI 專案支援查看和下載該日志 FineBI 配置操作記錄 |
| polars.log | 僅 FineBI 專案支援查看和下載該日志 儀表板和資料集編輯涉及的計算日誌 |
| operator_calculate.log | 僅 FineBI 專案支援查看和下載該日志 儀表板和資料集編輯涉及的計算日誌 |
| access.log | Nginx 存取日誌的存取日誌檔案，用於記錄使用者存取網站的請求資訊，如存取時間、IP 地址、請求方法、存取路徑、HTTP 狀態碼等 |
| catalina.out | Tomcat 的標準匯出和標準出錯，所有匯出到這兩個位置的都會進入 catalina.out，這裏包含 Tomcat 運作自己匯出的日誌以及應用裏向 console 匯出的日誌 |
| catalina.log | Tomcat 自己運作的一些日誌，主要記錄 Tomcat 在啟動和暫停時的運作內容 |
| localhost_access_log.txt | Tomcat 的請求存取日誌，請求的時間，請求的類型，請求的資源和傳回的狀態碼都有記錄 |
| messages.txt | Linux 系統中的系統日誌檔案，用於記錄系統中發生的各種事件和錯誤資訊，如啟動、關機、硬體故障、軟體當機等。這些資訊可以幫助管理者即時發現和解決系統問題，保障系統的穩定運作。 |
agent.log | ops-agent 組件日誌 |
| exporter.log | 指標採集日誌，記錄專案指標資訊採集相關情況 |
| FineOperation.log | 當機自助處理工具日誌，記錄當機自助處理定時任務相關資訊和執行情況 |
2. 查看日誌基礎資訊
操作步驟：
1）管理者登入維運平台，選擇維運專案，點選「日誌>維運日誌」。
2）在「儲存位置」中，點選「查看」按鈕，即可查看該維運專案中各個工程節點的維運日誌儲存位置。
注意事項：
1）容器化部署的維運專案，如安裝elasticsearch組件，用於日誌儲存，則此處不顯示儲存位置，提示「elasticsearch日誌服務」
2）如不存在某種類型的日誌，則不展示該日誌的儲存位置。
3. 下載維運日誌
| 序號 | 操作步驟 | 注意事項 |
|---|---|---|
| 1 | 管理者登入維運平台，選擇維運專案，點選「日誌>維運日誌」。 | |
| 2 | 選擇時間範圍 | 可選範圍：15天前~當前日期，所選時間跨度不可超過2天 預設時間：當天 |
| 3 | 選擇服務類型 | 支援類型：BI、FR 可選範圍：所選時間記憶體在的服務類型，預設全選 注意事項： 1）非容器化維運專案不支援選擇服務類型 2）如不存在任一類型，則不出現該選項 |
| 4 | 選擇節點 | 可選範圍：所選維運專案中的所有節點，預設全選 |
| 5 | 選擇需下載的日誌 | 支援類型：可參見1.3節表格 注意事項： 1）如不存在某種類型的日誌，則不支援下載該類型日誌 2）容器化部署的維運專案，如安裝elasticsearch組件用於日誌儲存，則不顯示該項，直接全量下載 |
| 6 | 點選「下載」，生成維運日誌檔案到本地電腦 | 1）若檔案大小超過5G，則無法匯出該日誌，提示「以下日誌大小超過上限（5GB），不支援下載：xxx」 2）若該類型日誌檔案不存在，則無法匯出該日誌，提示「以下日誌不存在：xxx」 3）日誌下載時，檔案需要進行壓縮，若等待時間過長，使用者可點選「取消下載」按鈕停止下載 4）下載的檔案解壓後，按照「節點-日期-服務類型-日誌類型」結構存放 |
4. 注意事項
4.1 compress FanruanLog error
問題描述：下載日誌時，出現報錯：壓縮失敗 compress FanruanLog error
原因分析：磁碟空間不足
解決方案：請對維運專案掛載目錄對應磁碟進行擴容，確定提供足夠的空間供生成壓縮檔案
4.2 系統維運子進程連結失敗
問題描述：管理者登入維運平台，點選維運專案，存取「日誌>維運日誌」介面，報錯「系統維運子進程連結失敗」
排查步驟：
1）管理者登入帆軟應用，點選「管理系統>智慧維運>當機處理」，確認開啟「自動匯出記憶體堆疊」功能。
2）使用curl命令，確定維運平台與專案伺服器間網路連通。
3）如果維運平台和專案配置了SSL，確定雙方憑證未過期。
4）禁用系統維運插件，再開啟該插件，重新配置維運平台與維運專案之間的對接。