當機處理

1.1 版本

1.2 應用場景

報表工程部署在伺服器上後，會因為各種原因導致當機。

當機後若直接重啟沒有抓取 DUMP 檔案 ，很難定位到真實原因，進而無法快速解決問題和做一些防止再發生的預防措施，造成的時間和精力損失無法估計，對伺服器維運非常不友好。

FineReport 內建「系統維運」插件，提供「當機自動處理」功能。

發生當機後，透過分析生成的 DUMP 檔案，可以快速定位當機原因，即時處理當機問題和做一些有效的預防措施，為使用者增加一道保險。

注1：「宕机处理」功能仅支持运维平台部署的工程，或Tomcat中间件下的工程。

         对于非 Tomcat 中间件部署的工程，或设计器自带的工程，不支持「宕机处理」功能。

注2：FineReport与FineBI集成的工程，在使用此功能时，优先调用FineBI的「宕机处理」功能，禁用FineReport的「宕机处理」功能，以保证不影响FineBI工程的运行。

1.3 功能入口

超管登入數據決策系統，點選「管理系統>智慧維運>當機處理」，就可以看到平台端對應的功能模組。如下圖所示：

模組下功能分為當機自助精靈、運作監測、當機處理、記憶體堆疊匯出記錄、伺服器重啟記錄 5 部分。

注：當機處理頁面在平台端開啟時，載入時間較長，請耐心等待。

記錄工程的當機時間和當機原因，並提供對應的推薦處理方案。如下圖所示：

常見的當機原因和推薦處理方案如下表所示：

如需使用第四章的宕机处理功能，必须确保「运行检测」的每一项都符合要求。

系統需要滿足一些條件，才能保證當機自動處理工具的正常執行。因此工程啟動後，會先對埠狀態、JDK環境、堆外記憶體、部署情況進行檢查。

檢查有問題則提醒使用者做相應修改或者禁用當機功能，無問題則持續穩定運作。如下圖所示：

「執行檢測」每項對應的檢查內容如下表所示：

注：若檢查結果為優，則提示「此項配置良好，無需調整」

當監測到工作系統、埠、JDK、堆外記憶體影響功能使用時，會透過「平台訊息」和平台右下角「彈窗訊息」提醒使用者。

點選「處理」即可跳轉到跳轉到「當機處理」平台配置頁面，進而對其進行相應的處理。

訊息提醒內容為：當前當機自動處理工具不可用，為保證功能正常運作，建議你點選處理查看詳情。

如需使用 「當機處理」功能，必須確定 2.2 節「運作檢查」的每一項都符合要求。

使用者可以在「當機處理」位置做一些配置設定，可設定的項為：當機自動處理、自動匯出記憶體堆疊、當機自動重啟、當機通知、埠設定。

如下圖所示：

以下所有設定修改後需點選「儲存」按鈕才會生效。

4.1 當機自動處理

使用說明：

開啟該按鈕，才支援進行下方功能的配置，否則全部不可用。

此開關預設開啟。

使用前提：

在工作時段（6:00-23:00），當應用主進程關閉5分鐘後，若當機自動處理無法成功重啟工程，則該工具跟隨關閉。

在非工作時段（0:00-6:00，23:00-24:00），即使應用主進程關閉，當機自動處理工具也不會跟隨關閉。

4.2 自動匯出記憶體堆疊

當系統配置滿足【執行檢測】中的運作條件時，工具自動運作，此開關預設開啟。

當系統配置不滿足運作條件時，開關圖示灰化，不能編輯修改。

使用說明：

開關開啟後，當發生當機時會自動匯出當機日誌。

支援匯出的當機日誌內容包括：堆疊、histo、dump

匯出位置為：當機節點所在伺服器下%Tomcat%logsFineLog日期資料夾內

注：開啟後自動匯出當機日誌。如果擔心dump匯出時間長影響效能，可只選擇匯出堆疊和histo日誌。

使用前提：

• 若「當機自動處理」未開啟，此項灰化處理，不能編輯修改。

• 若「當機自動處理」開啟，此項預設開啟。

4.3 當機自動重啟

使用說明：

開啟後，當高負載導致當機時，會自動重啟工程。

使用前提：

1）開啟「當機自動處理」

• 若「當機自動處理」未開啟，此項灰化處理，不能編輯修改。

• 若「當機自動處理」開啟，此項預設關閉。

2）系統情況

開關開啟時，會對當前系統情況做檢查。檢查是否為 Windows 工作系統，是否為 Windows 服務形式。

• 若系統為 Windows 工作系統且為 Windows 服務形式，彈窗提示：該功能暫不支援當前系統。如下圖所示：

       點選完成和關閉按鈕後彈窗關閉，開關不開啟。

• 若系統為 Windows 工作系統且非Windows 服務形式，彈窗提示：當前系統可能會存在重啟失敗。如下圖所示：

       點選完成或關閉按鈕後關閉彈窗，開關開啟。

4.4 進程自動恢復

使用說明：

開啟後，管理者可設定功能生效時間段。在指定時間段內，當應用進程消失時，會自動重啟工程。

使用前提：

1）開啟「當機自動處理」

• 若「當機自動處理」未開啟，此項灰化處理，不能編輯修改。

• 若「當機自動處理」開啟，此項預設關閉。

2）系統情況

開關開啟時，會對當前系統情況做檢查。檢查是否為 Windows 工作系統，是否為 Windows 服務形式。

• 若系統為 Windows 工作系統且為 Windows 服務形式，彈窗提示：該功能暫不支援當前系統。如下圖所示：

       點選完成和關閉按鈕後彈窗關閉，開關不開啟。

• 若系統為 Windows 工作系統且非Windows 服務形式，彈窗提示：當前系統可能會存在重啟失敗。如下圖所示：

       點選確認或關閉按鈕後關閉彈窗，開關開啟。

4.5 當機通知

若「當機自動處理」未開啟，此項灰化處理，不能編輯修改；若「當機自動處理」開啟，此項預設關閉，開啟後，可配置簡訊提醒、平台訊息提醒、郵箱提醒，當發生當機時會按配置的通知方式通知到使用者

4.6 埠設定

使用說明：

支援使用者設定當機處理工具佔用的埠，預設埠為 12100。

埠號範圍要在1024 到 65535 之間，否則「當機處理工具」無法啟動，「當機處理」頁面無法開啟。如下圖所示：

使用前提：

• 若「當機自動處理」未開啟，此項灰化處理，不能編輯修改。

• 若「當機自動處理」開啟，預設埠為 12100。

輸入新的埠號後，點選「測試」，若新的埠號存在異常，則彈窗提示：埠異常，請重新設定。如下圖所示：

若埠無異常，則彈窗提示：埠可用，儲存後當機自動處理工具將在新埠重啟。如下圖所示：

記錄自動生成 DUMP 檔案記錄。

包括匯出的匯出內容、開始時間、時長、是否成功、如果失敗，失敗的原因等。如下圖所示：

注：僅讀取最近一個月的當機處理記錄。

記錄伺服器重啟的記錄。

包括重啟的開始時間、時長、是否成功、如果失敗，失敗的原因等。如下圖所示：

注：僅讀取最近一個月的當機處理記錄。