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

# 追蹤
<a name="v10-panels-traces"></a>

****  
本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 12.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 12 版](using-grafana-v12.md)。  
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

追蹤視覺化可讓您在請求周遊基礎設施中的服務時遵循請求。追蹤視覺化會在圖表中顯示追蹤資料，讓您輕鬆地解譯資料。

如需追蹤及其使用方式的詳細資訊，請參閱下列文件：
+ [探索中的追蹤](v10-explore-tracing.md)
+ [Tempo 資料來源](tempo-data-source.md)
+ *Grafana 實驗室* [Tempo 文件中的 Tempo 入門](https://grafana.com/docs/tempo/latest/getting-started/)。

## 新增具有追蹤視覺化效果的面板
<a name="v10-panels-traces-add"></a>

在 Grafana 堆疊中提供追蹤資料後，您可以將追蹤面板新增至 Grafana 儀表板。

使用儀表板變數 `traceID`可讓您建立查詢，以顯示指定追蹤 ID 的特定追蹤。如需儀表板變數的詳細資訊，請參閱[變數文件](v10-dash-variables.md)。

**先決條件**

開始之前，您需要：
+ Amazon Managed Grafana 工作區。
+ 連接到工作區的 [Tempo 資料來源](tempo-data-source.md)。

若要檢視和分析儀表板中的追蹤資料，您需要將追蹤視覺化新增至儀表板，並使用面板編輯器定義查詢。查詢會決定視覺效果中顯示的資料。如需面板編輯器的詳細資訊，請參閱[面板編輯器文件](v10-panels-editor-overview.md)。

此程序使用儀表板變數和範本，可讓您輸入可視覺化IDs。您將使用名為 的變數，`traceId`並將其新增為範本查詢。

**新增追蹤視覺化查詢**

1. 在工作區中，建立新的儀表板或前往您要新增追蹤視覺化效果的現有儀表板。

1. 選擇從新儀表板**新增視覺化**，或選擇現有儀表板上的**新增面板**。

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

1. 在面板編輯器的右上角，選擇**視覺化**索引標籤，然後選取**追蹤**。

1. 在**面板選項**下，輸入追蹤面板的**標題**。如需面板編輯器的詳細資訊，請參閱[設定面板選項](v10-panels-configure-panel-options.md)。

1. 在查詢編輯器中，選取 **TraceQL** 查詢類型索引標籤。

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

1. 在面板編輯器中選擇**套用**，將面板新增至儀表板。

1. 前往儀表板**設定**，並新增名為 `traceId`的變數類型 **Custom** 的新變數，並視需要為其提供標籤。選擇**套用**，將變數新增至儀表板。

1. 透過使用用於追蹤面板之資料來源的有效追蹤 ID，並在儀表板變數中編輯 ID，來驗證面板是否正常運作。

## 使用資料表視覺效果新增 TraceQL
<a name="v10-panels-traces-traceql"></a>

雖然您可以將追蹤視覺化新增至儀表板，但必須將追蹤 IDs 手動新增為儀表板變數很麻煩。改為能夠使用 TraceQL 查詢來搜尋特定類型的追蹤，然後從相符的結果中選取適當的追蹤，會比較有用。

**先決條件**

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

**使用資料表視覺效果新增 TraceQL**

1. 在您新增追蹤視覺化的相同儀表板中，選擇**新增面板**以新增新的視覺化面板。

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

1. 在面板編輯器的右上角，選取**視覺化**索引標籤，然後選擇**資料表**。

1. 在查詢編輯器中，選擇 **TraceQL** 標籤。

1. 在**面板選項**下，輸入追蹤面板的**標題**。

1. 新增適當的 TraceQL 查詢，以搜尋您要在儀表板中視覺化的追蹤。例如，以下是來自稱為 {{my-server}} 之伺服器的簡單靜態查詢。

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

   您可以撰寫 TraceQL 查詢做為範本查詢，以利用存在的其他儀表板變數。這可讓您根據這些變數建立動態查詢。

從查詢傳回結果時，結果會在面板的資料表中轉譯。

追蹤視覺化的結果包括轉譯追蹤的**探索**頁面連結。您可以將其他連結新增至資料表中的追蹤，在選取時填入`traceId`儀表板變數，以便在相同的儀表板中視覺化追蹤。

若要在面板中建立一組資料連結，請使用下列程序。

**使用變數將其他連結新增至追蹤**

1. 在右側選單**的資料連結**下，選擇**新增連結**。

1. 新增資料連結的**標題**。

1. 在轉譯完整儀表板時，查看瀏覽器的地址列，以尋找儀表板的路徑。由於這是相同 Grafana 堆疊中儀表板的連結，因此只需要儀表板的路徑。

   例如，如果您的路徑是：

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

   然後，儀表板的路徑為：

   ```
   /d/1234abcd5/my-dashboard?orgId=1
   ```

1. 在 **URL** 欄位中，自行參考包含兩個面板的儀表板。此自我參考會使用資料表中所選追蹤的值來填入儀表板變數。使用上一個步驟的儀表板路徑，然後填入`traceId`使用 TraceQL 資料表中所選結果的 值。追蹤 ID 會使用傳回結果中的`traceID`資料欄位公開，因此請使用 做為儀表板變數的值。例如：

   ```
   /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
   ```

1. 選擇**儲存**以儲存資料連結。

1. 從面板編輯器選擇**套用**，將面板套用至儀表板。

1. 儲存儀表板。

您現在應該會在資料表視覺化中看到相符追蹤的清單。選取 **TraceID** 或 **SpanID** 欄位時，可讓您選擇開啟**探索**頁面以視覺化追蹤或遵循資料連結，選取資料連結後面的任何其他欄位 （例如 `Name`、 `Start time`或 `Duration`)，填入`traceId`儀表板變數，然後在追蹤面板中顯示相關追蹤。