當機處理

1.1 版本

1.2 應用場景

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

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

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

注1：「當機處理」功能僅支援維運平台部署的工程，或Tomcat中間軟體下的工程。

         對於非 Tomcat 中間軟體部署的工程，或設計器自帶的工程，不支援「當機處理」功能。

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

1.3 功能簡介

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

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

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

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

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

如需使用第四章的當機處理功能，必須確定「執行檢查」的每一項都符合要求。

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

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

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

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

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

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

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

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

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

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

4.1 當機自動處理

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

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

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

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

4.2 自動匯出記憶體堆疊

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

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

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

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

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

4.3 當機自動重啟

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

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

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

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

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

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

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

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

4.4 當機通知

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

4.5 埠設定

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

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

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

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

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

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