1. 概述
1.1 版本
| 維運平台版本 | 功能變更 |
|---|---|
| V1.5.5 | - |
| V1.5.7 | 1）查詢介面新增「重置」按鈕，方便重置查詢 2）呼叫鏈路列表展示優化，支援展開收起，方便放大記錄明細區 |
| V1.6.0 | 1）優化「收起側邊列表」按鈕交互 2）支援點選複製traceID |
| V1.7.0 | 對於使用elasticsearch套件獲取和儲存日誌的維運專案，在查看鏈路詳情時，支援獲取日誌到本地 |
| V1.8.0 | 查詢介面新增篩選項：端點、狀態、實體 |
| V1.11.0 | 1）呼叫鏈路詳情新增「分析匯總」檢視表，幫助使用者快速洞察耗時分佈，匯總展示鏈路span資訊 2）呼叫鏈路詳情新增「鏈路資訊」按鈕，匯總展示鏈路關鍵資訊，減少查詢時間 3）呼叫鏈路列表新增「FGC」標識，標記鏈路時間範圍內是否發生FullGC |
| V1.12.0 | 若某個呼叫鏈路所在session有相關首屏鏈路資料，則支援聯動跳轉「查看首屏鏈路」 |
| V1.14.0 | 1）呼叫鏈路詳情「列表」檢視表下，鏈路資訊中，新增「自助資料集」欄位，若有即可查看 2）呼叫鏈路詳情「列表」檢視表，新增「span關鍵字查詢」功能，支援搜尋包含指定關鍵字的span 3）呼叫鏈路詳情「分析匯總」檢視表下，支援點選span名稱跳轉至「列表」檢視表下，以名稱作為關鍵詞進行搜尋 |
| V1.15.0 | 1）支援自訂鏈路追蹤資料留存天數，滿足個性化分析訴求 2）支援手動清空維運專案鏈路資料，防止磁碟不足引起異常 |
| V2.0 | 支援匯出鏈路資料 |
| V2.16.0 | 鏈路追蹤支援查看FineBI「引擎執行詳情」 |
1.2 功能簡介
當儀表板/報表出現卡慢情況時，管理者無需被動的等待使用者反饋問題，可使用「鏈路追蹤」功能，幫助使用者對查詢請求中的鏈路明細進行採集和分析。
支援根據ID、時間等，篩選請求，進一步定位分析慢的請求，可以進行問題定位，精確到網路波動、資料庫效能、配置庫、複雜資源、資源不足等問題。
2. 使用前提
使用鏈路追蹤功能前，請先確定開啟鏈路追蹤、配置全局設定等。
詳情請參見：鏈路追蹤使用前提
3. 配置查詢條件
1）管理者登入維運平台，選擇維運專案。點選「鏈路追蹤>呼叫鏈路」。
2）選擇專案組件，僅支援對專案中的fr、bi和nginx組件進行鏈路追蹤。
3）點選「篩選」，配置查詢條件，點選「查詢」即可。
支援的查詢條件如下表所示：
| 查詢條件 | 簡介 |
|---|---|
| 查詢時間 | 說明：篩選所有在此時間範圍內開始的查詢 可選項：支援選擇當前日期過去5天範圍內，但查詢區間跨度不得大於3天 預設值：當前時間前半小時內 |
| 查詢ID | 說明：尋找對應session相關記錄 可選項：時間範圍內的所有sessionID 預設值：為空，即展示全部 |
| 呼叫鏈路ID | 說明：尋找對應traceID的呼叫鏈路 可選項：時間範圍內的所有traceID 預設值：為空，即展示全部 |
| 使用者 | 說明：篩選該使用者觸發的所有查詢 可選項：所有有記錄的使用者 預設值：為空，即展示全部 |
| 存取內容 | 說明：篩選查詢物件對應的查詢記錄 可選項：
預設值：為空，即展示全部 |
| 端點耗時 | 說明：篩選呼叫鏈路耗時在區間內的查詢記錄 可選項：非負整數，為空則表示不限制上限/下限 預設值：為空，即展示全部 |
| 端點 | 說明：篩選呼叫鏈路類型 可選項：時間範圍內的所有端點 預設值：為空，即展示全部 |
| 狀態 | 說明：篩選呼叫鏈路成功/失敗的情況 可選項：
預設值：為空，即展示全部 |
| 實體 | 說明：篩選維運專案中的節點對應的鏈路，僅叢集工程支援該篩選項 可選項：選擇叢集中的各個節點 預設值：為空，即展示全部 |
| 更多 | 說明：篩選所有標籤等於所選值條件的查詢 可選項：sessionId、reportId、dec.user.name、fr.domain、fr.cmd、db.type、http.method、http.status_code、db.instance（後五項不可同時選中） 預設值：為空，即展示全部 |
| 重置 | 說明：點選該按鈕，即可一鍵清空以上所有查詢條件 |
4. 鏈路結果展示
查詢後的介面如下圖所示：
| 序號 | 說明 | |
|---|---|---|
| 1 | 鏈路排序方式 | 支援對查詢所得的鏈路結果進行排序：
|
| 2 | 資料下載按鈕 | 對於內網使用者，可將鏈路資料匯出給帆軟技術支援，協助排查問題 點選可匯出 排序後的前100條鏈路資料 |
| 3 | 鏈路列表 | 展示每一條呼叫鏈路的縮略資訊： 存取內容：post/get請求、URL 鏈路耗時：黃色代表請求超過10s，紅色代表請求報錯，其他為灰色 FGC標識：標記鏈路時間範圍內是否發生FullGC 時間：鏈路發生時間 |
| 4 | 列表摺疊按鈕 | 點選該按鈕，支援摺疊展開左側鏈路列表區域 |
| 5 | 單條鏈路詳情 | 1）檢視表切換 以列表/分析匯總檢視表展示每條span的詳情，左上角支援切換檢視表 2）呼叫鏈路ID 右上角顯示鏈路ID，點選即可複製 3）獲取日誌 使用前提：該維運專案使用elasticsearch套件獲取和儲存日誌 使用說明：點選按鈕將下載包含對應TraceID的維運日誌到本地 4）查看首屏鏈路 若某個呼叫鏈路所在session有相關首屏鏈路資料，則支援聯動跳轉查看首屏鏈路 |
4.1 列表
1）traceID複製按鈕：點選可快速複製traceID，用於日誌查詢。
2）獲取日誌按鈕
使用前提：該維運專案使用elasticsearch套件獲取和儲存日誌
使用說明：點選按鈕將下載包含對應TraceID的維運日誌到本地
3）耗時篩選：支援使用元件篩選滿足耗時範圍的鏈路
4）span關鍵字查詢：支援搜尋包含指定關鍵字的span
5）以明細表形式展示該鏈路的明細span資訊，點選可展示每條span的更詳細資訊。
6）點選「鏈路資訊」按鈕，無需逐條查看span，即可展示系統自動提煉的呼叫鏈路的最關鍵資訊。
4.2 分析匯總
分析匯總介面分為兩個部分：
1）耗時分佈：幫助使用者一眼看到耗時分佈的情況
分為兩類：按peer取數耗時、其他
點選具體類別可以聯動篩選下面的span匯總
2）span匯總：以匯總維度展示鏈路span的匯總資訊
| 內容 | 說明 |
|---|---|
| span | span資訊 |
| 呼叫次數 | 呼叫的次數 |
| 總耗時 | 所有呼叫的耗時總和，單位ms |
| 平均耗時 | 總耗時/呼叫次數，單位ms |
| 耗時佔比 | 在所有耗時中，該span的耗時佔比 按照鏈路耗時佔比降冪排列 |
| 類型 | peer取數耗時/其他 |
3）支援點選span名稱跳轉至「列表」檢視表下，以名稱作為關鍵詞進行搜尋。