鏈路追蹤使用前提

  • 最後修改時間:2025-02-14
  • 1. 概述

    1.1 版本

    維運平台版本功能變更
    V1.5.5
    -
    V1.5.7

    1)非容器化專案,啟動鏈路追蹤功能步驟簡化

    2)支援關閉鏈路追蹤功能

    V2.1.0全局設定新增「慢請求標準」配置項
    V2.15.0鏈路追蹤支援FineDataLink專案

    1.2 功能簡介

    維運平台提供「呼叫鏈路」功能,但該功能的啟動需要進行前置準備。

    本文講解使用鏈路追蹤功能之前,需要對維運平台、維運專案的

    1.3 注意事項

    1)僅標準版維運平台支援鏈路追蹤功能,基礎版維運平台不支援鏈路追蹤功能

    2)鏈路追蹤功能僅對FineReport、FineBI專案生效,FineDataLink不支援此功能

    3)鏈路追蹤功能僅支援對專案中的fr、bi和nginx組件進行鏈路追蹤。

    2. 維運平台要求

    2.1 使用標準版維運平台

    基礎版維運平台不支援鏈路追蹤相關功能,如左上角顯示「基礎版」字樣,請重裝「標準版」維運平台。

    詳情請參見:部署維運平台

    2.2 啟動維運組件

    鏈路追蹤功能,由這些維運組件提供:elasticSearch、skywalking_oap。

    如需使用「鏈路追蹤」功能,必須先確定已啟動這些組件。否則提示「鏈路追蹤組件未啟動,請在維運組件目錄中啟動elasticsearch以及skywalking_oap」。

    管理者登入維運平台,點選「維運管理>維運組件」,先啟動elasticSearch組件,再啟動skywalking_oap組件。

    2.3 磁碟可用空間充足

    請確定FineOps維運平台所在分割槽,已使用磁碟空間不足90%,否則無法啟動鏈路追蹤功能。


    2.4 配置鏈路追蹤全局設定

    在正式使用鏈路追蹤相關功能前,請先配置好全局設定項。此配置項對維運平台中的所有維運專案生效。

    管理者登入維運平台,點選「設定>鏈路追蹤」,配置全局設定項,點選「儲存」即可。

    支援的設定項說明如下:

    設定項
    說明
    資料留存天數

    鏈路資料留存的天數,預設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. 維運專案要求

    3.1 確認維運專案版本

    管理者登入工程,點選「管理系統>註冊管理>版本資訊」,可查看工程的小版本號。

    請確定維運專案版本符合:FineReport 11.0.12 及以上 / FineBI 6.0.9 及以上 / FineDataLink 4.2.1.1 及以上。

    3.2 確認維運專案可用

    使用者必須確定維運專案可用,否則提示「專案狀態異常,請恢復專案後使用或查看其他專案」。

    3.3 確認埠互通

    維運平台的skywalking_oap組件,負責鏈路追蹤的資料上報和分析整理服務。

    因此必須確定 FineReport/FineBI 專案所在伺服器,支援存取維運平台的 skywalking_oap 組件埠。

    skywalking_oap 組件預設埠為:11800、12800

    4. 啟動鏈路追蹤

    如果維運專案由當前維運平台部署,該維運專案可預設啟動鏈路追蹤。無需執行本章操作。

    如果維運專案是使用其他維運平台部署,或者非維運平台部署,然後接入當前維運平台。該維運專案需要手動「啟動鏈路追蹤」。

    4.1 非維運平台部署的專案

    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專案才能生效。

             若更新了檔案但未重啟專案,使用該容器化專案的鏈路追蹤功能時,提示「當前專案的鏈路追蹤功能存在更新,請重啟專案完成更新」。

    4.2 維運平台部署的專案

    1)管理者登入維運平台,選擇待啟動鏈路追蹤的維運專案,點選「鏈路追蹤」。介面顯示「當前未啟動鏈路追蹤」。

    2)點選「啟動鏈路追蹤」,跳出提示「專案xxx將自動重啟。對該專案開啟鏈路追蹤後,專案會自動重啟,耗時3-5分鐘,是否繼續?」

    3)點選「重啟專案並繼續」,開始自動重啟,重啟成功後啟動鏈路追蹤。

    5. 注意事項

    5.1 升級鏈路追蹤依賴檔案

    對於非維運平台部署的專案,skywalking-java-agent 檔案會持續更新升級。

    管理者登入FineOps維運平台時,會自動檢查專案是否存在 skywalking-java-agent 檔案更新。

    若需要更新,會自動進行更新。更新成功後,仍需要重啟FineReport/FineBI專案才能生效。

    若更新了檔案但未重啟專案,使用該容器化專案的鏈路追蹤功能時,提示「當前專案的鏈路追蹤功能存在更新,請重啟專案完成更新」。

    5.2 關閉鏈路追蹤

    FineOps維運平台支援對專案停用鏈路追蹤功能。

    1)管理者登入維運平台,點選「設定>鏈路追蹤」。

    2)選擇待關停鏈路追蹤的專案,點選「關閉」按鈕,點選「確定」。

    3)使用者需要手動重啟維運專案,方可生效。

    5.3 清空鏈路資料

    鏈路追蹤功能啟動後,會對鏈路資料進行留存,預設留存5天的資料。

    但當磁碟空間不足時,會自動停止鏈路資料獲取,此時需要清理歷史鏈路資料。

    1)管理者登入維運平台,點選「設定>鏈路追蹤」。

    2)選擇指定專案,點選「清空」按鈕,即可清理歷史鏈路資料


    附件列表


    主題: 專案管理
    已經是第一篇
    已經是最後一篇
    • 有幫助
    • 沒幫助
    • 只是瀏覽