專案接入維運平台異常排查

本文講解，在「接入已有專案」時，常見問題的排查步驟和解決方案。

Get versionAck failed

問題描述：

管理者在帆軟應用端發起對接請求，點選「儲存」後，提示「Get versionAck failed」

原因分析：

維運平台與帆軟應用的對接，依賴帆軟應用中的「系統維運」插件。兩者有版本匹配要求。

解決方案：

1）請確定FineReport/FineBI/FineDataLink應用安裝了「系統維運」插件。

• 如果應用配置了CAS單點登入，安裝「系統維運」插件後，需要重啟應用，方可正常與FineOps維運平台對接。

2）請根據FineOps維運平台版本，確認需要安裝的「系統維運」插件版本。

• 優先建議將維運平台與插件均升級到最新版本，再嘗試對接。

FineOps維運平台版本	工程需要安裝的「系統維運」插件版本
V2.0以下	V3.0.0以下
V2.x版本	V3.0.0及以上

Socket connect timeout

問題描述：

管理者在帆軟應用端發起對接請求，點選「儲存」後，提示「Socket connect timeout」

排查步驟：

1）檢查使用前提

請先參考「接入已有專案使用前提」文檔，逐一排查維運平台對接專案的使用前提。

尤其請檢查維運平台與「系統維運」插件的版本，建議直接升級到最新版本再進行嘗試。

尤其請檢查維運平台與帆軟應用網路是否互通，建議直接開放內網聯通。

2）檢查地址指向的伺服器

請檢查填寫的維運平台地址，其中的IP、或域名對應的IP，是否為維運平台ops組件所在伺服器

如果自行額外配置了負載均衡，請自行排查負載均衡轉發是否配置錯誤。

3）檢查域名對應SSL憑證

如果維運平台地址，是域名形式的

請檢查憑證、域名、伺服器IP三者一致。

請檢查憑證是否公有。如為私有憑證，請給帆軟應用節點配置信任。

不顯示發現新專案彈窗

問題描述：

管理者在帆軟應用端發起對接請求，儲存成功後顯示「待接入」。

但是登入維運平台，並沒有出現「發現新專案」彈窗。

解決方案：

1）檢查維運平台中已對接的專案，可能之前已經對接過了，無需確認。

2）重新整理瀏覽器視窗，重新存取維運平台。

The request authentication failed

問題描述：

專案已成功接入維運平台，專案可用，但狀態突然顯示為「不可用」

重新編輯測試接入時，報錯：The request authentication failed

排查方向一：

原因分析：維運專案被其他維運平台接入了

解決方案：

管理者登入帆軟應用，點選「管理系統>系統管理>標準」。在「維運平台連結設定」中，輸入「維運平台地址」，點選「儲存」。

2）請在五分鐘內，使用管理者帳號登入維運平台。

維運平台提示「發現新專案」。

點選「新增專案」，設定「專案名稱」，點選「確認」即可。

排查方向二：

原因分析：帆軟應用的配置庫出現了變更，在遷移外接庫的程式中，匯入了其他配置，導致維運平台讀取的專案ID發生了變更，收信確認為是其他專案。

解決方案：管理者需要在專案管理中，刪除該維運專案，重新接入該專案。

can not find cluster

報錯資訊：2024/07/15 11:25:18 http-nio-8080-exec-37 ERROR [standard] can not find clustercom.fr.ops.exception.ClusterNotFoundException: can not find cluster

原因分析：使用了不滿足條件的瀏覽器存取維運平台，並進行相關維運操作

解決方案：請使用以下版本的瀏覽器存取維運平台，否則可能導致介面展示和功能作業異常。