當機處理

1.1 版本

1.2 應用場景

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

FineBI提供「當機處理」功能。透過此功能，BI 工程可以自動生成 DUMP 檔案、同時可重新開機系統。

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

1.3 功能簡介

「當機處理」功能實質上是一個當機自動處理工具，有平台入口和用戶端入口。

1）平臺端：內建在平台的部分主要為工具運作環境監測和一些設定項，分別為當機自助嚮導、運作監測、當機處理、記憶體堆疊匯出記錄、伺服器重啟記錄。

2）用戶端：用戶端主要監控工程運作狀況。

注1：對於非 Tomcat 容器部署以及設計器自帶的工程，不支援「當機處理」功能。

注2：報表與 BI 集成的使用者在使用此功能時，優先呼叫 BI 工程的「當機處理」功能，禁用報表工程的「當機處理」功能，以保證不影響 BI 工程的運作。

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

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

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

2.1 當機自助嚮導

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

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

2.2 執行檢測

如需使用 2.3 節的當機處理功能，必須確保「執行檢測」的每一項都符合要求。

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

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

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

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

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

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

消息提醒內容為：檢測到部分系統組態缺失或不合理，當機自動處理工具不可用，為保證功能正常運作，建議你及時處理。

2.3 當機處理

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

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

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

2.3.1 當機自動處理

當系統組態滿足「運作監測」中的運作條件時，工具自動運作，此開關預設開啟。

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

• 在工作時段（6:00-23:00），當工程主進程關閉5分鐘後，當機自動處理工具也跟隨關閉。

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

2.3.2 自動匯出記憶體堆疊

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

• 若「當機自動處理」開啟，此項默認關閉，開啟後當發生當機時，會自動匯出當機日誌

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

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

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

2.3.3 當機自動重啟

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

• 若「當機自動處理」開啟，此項默認關閉，開啟後當發生當機時會自動重啟工程。

開關開啟時，會對工具狀態和當前系統情況做檢測。檢測是否為 Windows 作業系統，是否為 Windows 服務形式。

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

點選確定和關閉按鈕後彈窗關閉，開關不開啟。

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

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

檢測時，若以上問題同時存在，僅提示當前問題中主要度最高的一個，重要度排序為：該功能暫不支援當前系統>當前系統可能會存在重啟失敗。

2.3.4 當機通知

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

2.3.5 埠設定

「當機處理工具」默認的埠為 12100，當 12100 埠異常時，可以在此處配置其他埠號。

埠號範圍要在1024 到 65535 之間，推薦12100。否則「當機處理工具」無法啟動，「當機處理」頁面無法開啟，且跳出錯誤提示：請輸入1024-65535 之間的數字，推薦12100。

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

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

2.4 處理記錄

「記憶體堆疊匯出記錄」和「伺服器重啟記錄」分別記錄了自動生成 DUMP 檔案記錄和伺服器重啟的記錄。其中包括匯出（重啟）的開始時間、時長、是否成功、如果失敗，失敗的原因等。如下圖所示：

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

伺服器工程以管理者權限啟動後，管理者在瀏覽器端輸入http://IP:埠（當機自動處理工具默認埠為12100，若修改了埠，此處為修改後的埠），便可以進入當機工具用戶端介面，如下圖所示：

超管使用帳號密碼登入後可進入使用者端介面，登入失敗 5 次登入鎖定，限制 60 分鐘內不可登入；登入有效期為 15 分鐘，超時自動退出。

注：若使用者在當機時被登入鎖定，需要使用者手動殺掉進程。

使用者端介面， 主要有工程運作情況監視和匯出堆棧兩個功能，右上角有「註銷登入」按鈕，點選可跳出登入。如下圖所示：

3.1 運作監控

工程運作監控中，若伺服器正常運作，則畫面顯示：正常運作中。如下圖所示：

若發生當機，則畫面顯示：已當機，正在處理中。如下圖所示：

當機後，工具自動處理時，使用者可手動終止工具對於當機問題的處理，進行終止後，頁面顯示：已終止當機自動處理，請及時手動重啟系統。如下圖所示：

當機後，小工具重啟工程時，若小工具重啟工程失敗，頁面顯示：當機自動重啟失敗，請及時手動重啟系統。如下圖所示：

3.2 輸出堆疊

使用者可以在「輸出堆疊」處，匯出執行緒堆疊和記憶體堆疊檔案，點選相應位置匯出即可。如下圖所示：

匯出成功後提示：輸出成功，否則提示輸出失敗，輸出的堆疊檔案位置為：%Tomcat%\logs\FineLog\日期