本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
追蹤
本文件主題是針對支援 Grafana 10.x 版的 Grafana 工作區所設計。
如需支援 Grafana 9.x 版的 Grafana 工作區,請參閱。在 Grafana 第 9 版中工作
如需支援 Grafana 8.x 版的 Grafana 工作區,請參閱。在 Grafana 第 8 版中工作
追蹤視覺效果可讓您在基礎結構中的服務周遊時遵循要求。追蹤視覺效果會在圖表中顯示追蹤資料,讓您輕鬆解譯它。
如需有關追蹤及如何使用追蹤的詳細資訊,請參閱下列文件:
新增包含追蹤視覺效果的面板
一旦您的 Grafana 堆疊中有可用的追蹤資料,您就可以將追蹤面板新增至 Grafana 儀表板。
使用儀表板變數traceID
,可讓您建立查詢,以顯示指定追蹤 ID 的特定追蹤。如需有關儀表板變數的詳細資訊,請參閱變數文件。
先決條件
開始之前,您需要:
-
一個 Amazon 受管的 Grafana 工作空間。
-
連接至工作區的 Tempo 資料來源。
若要在儀表板中檢視和分析追蹤資料,您需要將追蹤視覺化新增至儀表板,並使用面板編輯器定義查詢。查詢會決定視覺效果中顯示的資料。如需有關面板編輯器的詳細資訊,請參閱面板編輯器文件。
此程序使用儀表板變數和範本,可讓您輸入追蹤 ID,然後將其視覺化。您將使用名為的變數,traceId
並將其新增為範本查詢。
若要新增追蹤視覺化查詢
-
在您的工作區中,創建一個新的儀表板或轉到要添加跟踪可視化的現有儀表板。
-
從新儀表板選擇「新增視覺效果」,或選擇現有儀表板上的「新增面板」。
-
選取適當的追蹤資料來源。
-
在面板編輯器的右上角,選擇「視覺效果」標籤,然後選取「繪線」。
-
在 「面板」選項下,輸入描圖面板的「標題」。如需面板編輯器的詳細資訊,請參閱設定面板選項。
-
在查詢編輯器中,選取 Trac EQL 查詢類型索引標籤。
-
${traceId}
在 TraceQL 查詢欄位中輸入以建立儀表板變數。此變數會用作範本查詢。 -
在面板編輯器中選擇「套用」,將面板加入至管控面板。
-
轉到儀表板 「設置」
traceId
,然後添加一個名為「自定義」變量類型的新變量,如果需要,為其提供一個標籤。選擇「套用」,將變數新增至控制面板。 -
透過使用用於追蹤面板之資料來源的有效追蹤 ID,並在管控面板變數中編輯 ID,以確認面板是否正常運作。
添加 TracSQL 與表可視化
雖然您可以將追蹤視覺化新增至儀表板,但必須手動新增追蹤 ID,因為儀表板變數非常麻煩。而是能夠使用 TracEQL 查詢搜索特定類型的跟踪,然後從匹配的結果中選擇適當的跟踪更有用。
先決條件
此程序假設您已完成先前的程序。
若要使用表格視覺效果新增 TracSQL
-
在您新增追蹤視覺效果的同一儀表板中,選擇「新增面板」 以新增視覺化面板。
-
選取您在上一節中使用的相同追蹤資料來源。
-
在面板編輯器的右上角,選取「視覺效果」標籤,然後選擇「表格」。
-
在查詢編輯器中,選擇 Trac EQL 索引標籤。
-
在 「面板」選項下,輸入描圖面板的「標題」。
-
新增適當的 TraceQL 查詢,以搜尋您想要在儀表板中以視覺化方式呈現的追蹤。例如,這裡是一個簡單的,從一個名為
我
的服務器的靜態查詢。{ .service.name = "
my-server
" && .http.status_code=500 }您可以將 TraceQL 查詢撰寫為範本查詢,以利用其他儀表板變數 (如果存在的話)。這可讓您根據這些變數建立動態查詢。
從查詢傳回結果時,結果會呈現在面板的資料表中。
追蹤視覺化中的結果包括轉譯追蹤之「探索」頁面的連結。選取後,您可以將其他連結新增至表格中填入traceId
儀表板變數的追蹤,以便在同一儀表板中視覺化追蹤。
若要在面板中建立一組資料連結,請使用下列步驟。
使用變數將其他連結加入至追蹤的步驟
-
在右側功能表的 [資料連結] 下,選擇 [新增連結]。
-
加入資料連結的標題。
-
在呈現完整儀表板時,查看瀏覽器的地址欄,以查找儀表板的路徑。由於這是相同 Grafana 堆疊中儀表板的連結,因此只需要儀表板的路徑。
例如,如果您的路徑是:
https://g-example.grafana-workspace.us-east-1.amazonaws.com
/d/1234abcd5/my-dashboard?orgId=1
然後,儀表板的路徑為:
/d/1234abcd5/my-dashboard?orgId=1
-
在 URL 欄位中,對包含兩個面板的管控面板進行自我參考。此自我參照會使用表格中所選追蹤的值來填入圖標板變數。使用上一個步驟的儀表板路徑,然後填入
traceId
使用 TraceQL 表格中所選結果的值。追蹤 ID 會使用傳回結果中的traceID
資料欄位公開,因此請將其用作儀表板變數的值。例如:/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
-
選擇「儲存」以儲存資料連結。
-
從面板編輯器中選擇「套用」,將面板套用至管控面板。
-
儲存儀表板。
現在,您應該會在表格視覺效果中看到符合追蹤的清單。選取 TracE ID 或 spanID 欄位時,您可以選擇開啟「瀏覽」頁面以視覺化追蹤或追蹤資料連結,選取任何其他欄位 (例如Start time
Name
、或Duration
) 會自動跟隨資料連結,填入traceId
儀表板變數,然後在追蹤面板中顯示相關追蹤。