追蹤 - Amazon Managed Grafana

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

追蹤

本文件主題是針對支援 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並將其新增為範本查詢。

若要新增追蹤視覺化查詢
  1. 在您的工作區中,創建一個新的儀表板或轉到要添加跟踪可視化的現有儀表板。

  2. 從新儀表板選擇「新增視覺效果」,或選擇現有儀表板上的「新增面板」

  3. 選取適當的追蹤資料來源。

  4. 在面板編輯器的右上角,選擇「視覺效果」標籤,然後選取「繪線」。

  5. 「面板」選項下,輸入描圖面板的「標題」。如需面板編輯器的詳細資訊,請參閱設定面板選項

  6. 在查詢編輯器中,選取 Trac EQL 查詢類型索引標籤。

  7. ${traceId}在 TraceQL 查詢欄位中輸入以建立儀表板變數。此變數會用作範本查詢。

  8. 在面板編輯器中選擇「套用」,將面板加入至管控面板。

  9. 轉到儀表板 「設置」traceId,然後添加一個名為「自定」變量類型的新變量,如果需要,為其提供一個標籤。選擇「套用」,將變數新增至控制面板。

  10. 透過使用用於追蹤面板之資料來源的有效追蹤 ID,並在管控面板變數中編輯 ID,以確認面板是否正常運作。

添加 TracSQL 與表可視化

雖然您可以將追蹤視覺化新增至儀表板,但必須手動新增追蹤 ID,因為儀表板變數非常麻煩。而是能夠使用 TracEQL 查詢搜索特定類型的跟踪,然後從匹配的結果中選擇適當的跟踪更有用。

先決條件

此程序假設您已完成先前的程序。

若要使用表格視覺效果新增 TracSQL
  1. 在您新增追蹤視覺效果的同一儀表板中,選擇「新增面板」 以新增視覺化面板。

  2. 選取您在上一節中使用的相同追蹤資料來源。

  3. 在面板編輯器的右上角,選取「視覺效果」標籤,然後選擇「表格」。

  4. 在查詢編輯器中,選擇 Trac EQL 索引標籤。

  5. 「面板」選項下,輸入描圖面板的「標題」。

  6. 新增適當的 TraceQL 查詢,以搜尋您想要在儀表板中以視覺化方式呈現的追蹤。例如,這裡是一個簡單的,從一個名為的服務器的靜態查詢。

    { .service.name = "my-server" && .http.status_code=500 }

    您可以將 TraceQL 查詢撰寫為範本查詢,以利用其他儀表板變數 (如果存在的話)。這可讓您根據這些變數建立動態查詢。

從查詢傳回結果時,結果會呈現在面板的資料表中。

追蹤視覺化中的結果包括轉譯追蹤之「探索」頁面的連結。選取後,您可以將其他連結新增至表格中填入traceId儀表板變數的追蹤,以便在同一儀表板中視覺化追蹤。

若要在面板中建立一組資料連結,請使用下列步驟。

使用變數將其他連結加入至追蹤的步驟
  1. 在右側功能表的 [資料連結] 下,選擇 [新增連結]。

  2. 加入資料連結的標題

  3. 在呈現完整儀表板時,查看瀏覽器的地址欄,以查找儀表板的路徑。由於這是相同 Grafana 堆疊中儀表板的連結,因此只需要儀表板的路徑。

    例如,如果您的路徑是:

    https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1

    然後,儀表板的路徑為:

    /d/1234abcd5/my-dashboard?orgId=1
  4. URL 欄位中,對包含兩個面板的管控面板進行自我參考。此自我參照會使用表格中所選追蹤的值來填入圖標板變數。使用上一個步驟的儀表板路徑,然後填入traceId使用 TraceQL 表格中所選結果的值。追蹤 ID 會使用傳回結果中的traceID資料欄位公開,因此請將其用作儀表板變數的值。例如:

    /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
  5. 選擇「儲存」以儲存資料連結。

  6. 從面板編輯器中選擇「套用」,將面板套用至管控面板。

  7. 儲存儀表板。

現在,您應該會在表格視覺效果中看到符合追蹤的清單。選取 TracE ID 或 spanID 欄位時,您可以選擇開啟「瀏覽」頁面以視覺化追蹤或追蹤資料連結,選取任何其他欄位 (例如Start timeName、或Duration) 會自動跟隨資料連結,填入traceId儀表板變數,然後在追蹤面板中顯示相關追蹤。