1)非容器化專案,啟動鏈路追蹤功能步驟簡化
2)支援關閉鏈路追蹤功能
維運平台提供「呼叫鏈路」功能,但該功能的啟動需要進行前置準備。
本文講解使用鏈路追蹤功能之前,需要對維運平台、維運專案的
1)僅標準版維運平台支援鏈路追蹤功能,基礎版維運平台不支援鏈路追蹤功能
2)鏈路追蹤功能僅對FineReport、FineBI專案生效,FineDataLink不支援此功能
3)鏈路追蹤功能僅支援對專案中的fr、bi和nginx組件進行鏈路追蹤。
基礎版維運平台不支援鏈路追蹤相關功能,如左上角顯示「基礎版」字樣,請重裝「標準版」維運平台。
詳情請參見:部署維運平台
鏈路追蹤功能,由這些維運組件提供:elasticSearch、skywalking_oap。
如需使用「鏈路追蹤」功能,必須先確定已啟動這些組件。否則提示「鏈路追蹤組件未啟動,請在維運組件目錄中啟動elasticsearch以及skywalking_oap」。
管理者登入維運平台,點選「維運管理>維運組件」,先啟動elasticSearch組件,再啟動skywalking_oap組件。
請確定FineOps維運平台所在分割槽,已使用磁碟空間不足90%,否則無法啟動鏈路追蹤功能。
在正式使用鏈路追蹤相關功能前,請先配置好全局設定項。此配置項對維運平台中的所有維運專案生效。
管理者登入維運平台,點選「設定>鏈路追蹤」,配置全局設定項,點選「儲存」即可。
支援的設定項說明如下:
鏈路資料留存的天數,預設5天
增加天數需要確定磁碟有充足的空間,當磁碟空間不足時會自動停止資料獲取
建議按照「專案數*增加的資料留存天數*10G」來評估磁碟增量
注:磁碟空間不足時,可點選「全局設定>關閉鏈路追蹤」中的「清空」按鈕清空鏈路資料。
3秒內同一端點的採集次數限制
預設值-1,表示不限制
輸入範圍為-1~10000
不進行採集的端點,如有多個端點,使用逗號分割
預設不進行採集的端點包括:
/webroot/decision/metrics/schedule
/webroot/decision/system/health
/webroot/decision/metrics/once
採集單個端點的最大跨度(span)數量,超出的將被捨棄
預設值300
輸入範圍為0~10000
對部分異常概率較低的資訊提高採集門檻,如連結前校驗,有助於凸顯關鍵資訊
預設值5ms
-1表示不限制
作為鏈路追蹤、健康巡檢-範本效能的慢請求指標
預設值為10000ms
請輸入1000及以上整數
3. 維運專案要求
管理者登入工程,點選「管理系統>註冊管理>版本資訊」,可查看工程的小版本號。
請確定維運專案版本符合:FineReport 11.0.12 及以上 / FineBI 6.0.9 及以上 / FineDataLink 4.2.1.1 及以上。
使用者必須確定維運專案可用,否則提示「專案狀態異常,請恢復專案後使用或查看其他專案」。
維運平台的skywalking_oap組件,負責鏈路追蹤的資料上報和分析整理服務。
因此必須確定 FineReport/FineBI 專案所在伺服器,支援存取維運平台的 skywalking_oap 組件埠。
skywalking_oap 組件預設埠為:11800、12800
如果維運專案由當前維運平台部署,該維運專案可預設啟動鏈路追蹤。無需執行本章操作。
如果維運專案是使用其他維運平台部署,或者非維運平台部署,然後接入當前維運平台。該維運專案需要手動「啟動鏈路追蹤」。
1)啟動鏈路追蹤
管理者登入維運平台,選擇待啟動鏈路追蹤的維運專案,點選「鏈路追蹤」。
介面顯示「當前未啟動鏈路追蹤」,點選「啟動鏈路追蹤」。
跳出提示「請手動重啟專案,該專案在開啟鏈路追蹤後需手動重啟」,點選「我知道了」,開始自動啟動鏈路追蹤。
2)自動配置
啟動鏈路追蹤後:
維運平台會自動傳輸 skywalking-java-agent 檔案到 FineReport/FineBI 工程的 WEB-INF 資料夾下。
維運平台會自動為 FineReport/FineBI 工程新增 skywalkingAgent 相關的啟動參數。
3)手動重啟工程
參考 關閉或重啟FineBI工程 / 關閉或重啟FineReport工程 文檔,重啟FineReport/FineBI專案。
即可將該非容器化部署的 FineReport/FineBI 專案,接入鏈路追蹤功能。
注1:FineReport/FineBI工程下的所有節點,都需要依次進行以上操作。
注2:skywalking-java-agent 檔案會持續更新升級。管理者登入維運平台時會自動檢查專案的檔案是否需要更新。
如需更新,會自動進行更新。更新成功後,仍需要重啟FineReport/FineBI專案才能生效。
若更新了檔案但未重啟專案,使用該容器化專案的鏈路追蹤功能時,提示「當前專案的鏈路追蹤功能存在更新,請重啟專案完成更新」。
1)管理者登入維運平台,選擇待啟動鏈路追蹤的維運專案,點選「鏈路追蹤」。介面顯示「當前未啟動鏈路追蹤」。
2)點選「啟動鏈路追蹤」,跳出提示「專案xxx將自動重啟。對該專案開啟鏈路追蹤後,專案會自動重啟,耗時3-5分鐘,是否繼續?」
3)點選「重啟專案並繼續」,開始自動重啟,重啟成功後啟動鏈路追蹤。
對於非維運平台部署的專案,skywalking-java-agent 檔案會持續更新升級。
管理者登入FineOps維運平台時,會自動檢查專案是否存在 skywalking-java-agent 檔案更新。
若需要更新,會自動進行更新。更新成功後,仍需要重啟FineReport/FineBI專案才能生效。
FineOps維運平台支援對專案停用鏈路追蹤功能。
1)管理者登入維運平台,點選「設定>鏈路追蹤」。
2)選擇待關停鏈路追蹤的專案,點選「關閉」按鈕,點選「確定」。
3)使用者需要手動重啟維運專案,方可生效。
對於維運平台部署的專案,可在「專案管理>維護>組件管理」中重啟fr/bi6組件。
對於非維運平台部署的專案,可參考 關閉或重啟FineBI工程 / 關閉或重啟FineReport工程 文檔,重啟FineReport/FineBI專案。
鏈路追蹤功能啟動後,會對鏈路資料進行留存,預設留存5天的資料。
但當磁碟空間不足時,會自動停止鏈路資料獲取,此時需要清理歷史鏈路資料。
2)選擇指定專案,點選「清空」按鈕,即可清理歷史鏈路資料。