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

# 探索中的追蹤
<a name="v10-explore-tracing"></a>

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

您可以使用探索來視覺化來自追蹤資料來源的追蹤。

支援下列資料來源。
+ [Tempo](tempo-data-source.md) （支援的擷取格式：OpenTelemetry、Jaeger 和 Zipkin)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

如需有關如何為上述資料來源設定查詢的資訊，請參閱特定資料來源的文件。

## 查詢編輯器
<a name="v10-explore-trace-queryeditor"></a>

您可以使用資料來源的查詢編輯器來查詢和搜尋追蹤資料。

每個資料來源都可以有自己的查詢編輯器。Tempo 資料來源的查詢編輯器與 Jaeger 資料來源的查詢編輯器略有不同。

如需查詢每個資料來源的資訊，請參閱其文件。
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## 追蹤檢視說明
<a name="v10-explore-trace-view"></a>

本節說明追蹤檢視儀表板的元素。

**標頭**

追蹤檢視的 標頭具有下列元素：
+ 標題 – 顯示根範圍和追蹤 ID 的名稱。
+ 搜尋 – 反白包含搜尋文字的範圍。
+ 中繼資料 – 有關追蹤的各種中繼資料。

**最小映射**

顯示精簡檢視或追蹤時間軸。將指標拖曳到小地圖上，以放大較小的時間範圍。縮放也會更新主要時間軸，因此很容易看到較短的跨度。將滑鼠游標移到小地圖上時，縮放時會顯示**重設選擇**按鈕，以重設縮放。

**跨度篩選條件**

使用跨度篩選條件，您可以在追蹤時間軸檢視器中篩選您的跨度。您新增的篩選條件越多，篩選的範圍就越具體。

您可以新增下列一或多個篩選條件：
+ 資源服務名稱
+ 範圍名稱
+ 持續時間
+ 標籤 （包括標籤、程序標籤和日誌欄位）

若要僅顯示您已相符的範圍，請選擇**僅顯示相符**項目切換。

**時間軸**

顯示追蹤內的跨度清單。每個跨度列都包含下列元件：
+ 展開子項按鈕 – 展開或摺疊所選範圍的所有子項。
+ 服務名稱 – 記錄跨度的服務名稱。
+ 操作名稱 – 此跨度代表的操作名稱。
+ 範圍持續時間列 – 追蹤內操作持續時間的視覺化表示。

**跨度詳細資訊**

選擇跨度列會顯示跨度詳細資訊，包括下列項目。
+ 操作名稱
+ 跨度中繼資料
+ 標籤 – 與此跨度相關聯的任何標籤。
+ 程序中繼資料 – 記錄此範圍之程序的中繼資料。
+ 日誌 – 此範圍所記錄的日誌清單和相關聯的索引鍵值。如果是 Zipkin 日誌區段，會顯示 Zipkin 註釋。

**追蹤至日誌**

您可以從追蹤檢視中的範圍直接導覽至與該範圍相關的日誌。這適用於 Tempo、Jaeger 和 Zipkin 資料來源。如需如何設定每個資料來源的說明，請參閱其相關文件。

選擇文件圖示，以使用設定的資料來源在探索中開啟分割檢視，並查詢範圍的相關日誌。

**追蹤指標**

**注意**  
此功能目前為 Beta 版

您可以在追蹤檢視中直接導覽到與該範圍相關的指標。此功能適用於 Tempo、Jaeger 和 Zipkin 資料來源。如需組態的詳細資訊，請參閱其相關文件。

**追蹤至設定檔**

使用追蹤至設定檔，您可以新增功能以在追蹤和設定檔之間連結，藉此使用 Grafana 關聯不同訊號的能力。

## 節點圖形
<a name="v10-explore-trace-node-graph"></a>

您可以選擇性地展開所顯示追蹤的節點圖形。根據資料來源，這可以在圖表中將追蹤的範圍顯示為節點，或新增一些額外的內容，包括基於目前追蹤的服務圖表。

## 服務圖表檢視
<a name="v10-explore-trace-graph"></a>

Service Graph 檢視可視覺化跨度指標 （針對速率、錯誤率和持續時間 (RED) 追蹤資料） 和服務圖表。設定需求後，即可立即使用此預先設定的檢視。

如需詳細資訊，請參閱 [Tempo](tempo-data-source.md) 資料來源頁面。您也可以在 *Grafana Labs Tempo 文件中*查看[服務圖表檢視頁面](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)。

## Data API (資料 API)
<a name="v10-explore-trace-dataapi"></a>

此視覺化需要從資料來源傳回特定形狀的資料，才能正確顯示資料。

資料來源需要傳回資料框架並設定 `frame.meta.preferredVisualisationType = 'trace'`。

**資料框架結構**

必要欄位；


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
| traceID | string | 整個追蹤的識別符。資料框架中應該只有一個追蹤。 | 
| spanID | string | 目前跨度的識別符。每個追蹤SpanIDs 應該是唯一的。 | 
| parentSpanID | string | 父系範圍的 SpanID，以在追蹤檢視中建立子系父系關係。可以undefined用於沒有父系的根跨度。 | 
| serviceName | string | 此範圍所屬服務的名稱。 | 
| serviceTags | TraceKeyValuePair【】 | 與服務相關的標籤清單。 | 
| startTime | number | 跨度的開始時間，以毫秒 epoch 時間為單位。 | 
| 持續時間 | number | 跨度的持續時間，以毫秒為單位。 | 

 選用欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
| 日誌 | TraceLog【】 | 與目前範圍相關聯的日誌清單。 | 
| 標籤 | TraceKeyValuePair【】 | 與目前範圍相關聯的標籤清單。 | 
| warnings | string【】 | 與目前範圍相關聯的警告清單。 | 
| stackTraces | string【】 | 與目前範圍相關聯的堆疊追蹤清單。 | 
| errorIconColor | string | 使用 標記跨度時的錯誤圖示顏色error: true。 | 

如需類型的詳細資訊，請參閱 GitHub 上的 [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28)、[TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4) 和 [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)。