探索中的追蹤 - Amazon Managed Grafana
查詢編輯器追蹤檢視說明節點圖服務圖視圖Data API (資料 API)

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

探索中的追蹤

本文件主題是針對支援 Grafana 10.x 版的 Grafana 工作區所設計。

如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱。在 Grafana 第 9 版中工作

如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱。在 Grafana 第 8 版中工作

您可以使用「瀏覽」視覺化追蹤資料來源的追蹤。

支援下列資料來源。

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

查詢編輯器

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

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

有關查詢每個資料來源的資訊，請參閱其文件。

追蹤檢視說明

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

標頭

追蹤視圖的標頭包含下列元素：

  • 標頭標題 — 顯示根範圍的名稱和追蹤 ID。

  • 搜尋 — 反白顯示包含搜尋文字的範圍。

  • 中繼資料 — 關於追蹤的各種中繼資料。

迷你地圖

顯示壓縮檢視或追蹤時間軸。將指標拖曳至迷你地圖上，以縮放至較小的時間範圍。縮放也會更新主時間軸，因此很容易看到較短的跨度。將游標懸停在小地圖上，當縮放時，會顯示「重設選擇」按鈕，重置縮放。

跨度篩選器

使用跨度過濾器，您可以在跟踪時間軸查看器中過濾跨度。您新增的篩選器越多，篩選的範圍就越明確。

您可以新增下列一或多個篩選器：

  • 資源服務名稱

  • 範圍名稱

  • 持續時間

  • 標籤 (包括標籤、處理程序標籤和記錄欄位)

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

時間軸

顯示軌跡內的跨距清單。每個跨距列都由下列元件組成：

  • 展開子項按鈕 — 展開或收合所選範圍的所有子項範圍。

  • 服務名稱 — 記錄跨度的服務名稱。

  • 作業名稱 — 此範圍所代表之作業的名稱。

  • 跨度持續時間列 — 追蹤內作業持續時間的視覺化表示。

跨度細節

選擇範圍列會顯示範圍詳細資訊，包括下列項目。

  • 操作名稱

  • 跨中繼資料

  • 標籤 — 與此範圍相關聯的任何標籤。

  • 處理中繼資料 — 記錄此範圍之程序的相關中繼資料。

  • 防護記錄 — 此範圍記錄的記錄清單和關聯的索引鍵值。在 Zipkin 日誌部分的情況下，顯示 Zipkin 註釋。

追蹤記錄

您可以直接從追蹤檢視中的範圍導覽至與該範圍相關的記錄。這適用於節奏、積分和 Zipkin 資料來源。如需有關如何配置每個資料來源的指示，請參閱其相關文件。

選擇文件圖示，以使用已設定的資料來源在 Explore 中開啟分割檢視，並查詢該範圍的相關記錄。

追蹤指標

注意

此功能目前處於測試階段

您可以在跟踪視圖中直接導航到與該範圍相關的指標。此功能適用於「速度」、「積分」和「Zipkin」資料來源。如需有關組態的詳細資訊，請參閱其相關文件。

追蹤設定檔

使用 Trace 至描述檔，您可以透過新增追蹤和描述檔之間連結的功能，來使用 Grafana 關聯不同信號的功能。

節點圖

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

服務圖視圖

「服務圖」檢視會以視覺化方式呈現跨度指標 (追蹤速率、錯誤率和持續時間 (RED) 的資料) 和服務圖表。設定需求之後，即可立即使用此預先設定的檢視。

有關詳情，請參閱 Tempo 資料來源頁面。您還可以看到在 Grafana 實驗室節奏文檔服務圖視圖頁面。

Data API (資料 API)

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

數據源需要返回數據幀並設置frame.meta.preferredVisualisationType = 'trace'。

資料框架結構

必填欄位；

欄位名稱 Type 描述
追蹤 ID string 整個追蹤的識別碼。數據幀中應該只有一個跟踪。
西班牙 string 目前範圍的識別碼。每個跟踪西班牙語應該是唯一的。
父系跨 string 父範圍的 spanId，以在跟踪視圖中創建子父關係。可以undefined用於沒有父項的根跨度。
serviceName string 此範圍所屬之服務的名稱。
服務標籤 TraceKeyValuePair[] 與服務相關的標籤清單。
startTime number 跨度的開始時間 (以毫秒紀元時間為單位)。
持續時間 number 跨度的持續時間，以毫秒為單位。

選擇性欄位：

欄位名稱 Type 描述
日誌 TraceLog[] 與目前範圍相關聯的記錄清單。
標籤 TraceKeyValuePair[] 與目前範圍相關聯的標籤清單。
warnings 字符串 [] 與目前範圍相關聯的警告清單。
堆棧跟踪 字符串 [] 與當前跨度關聯的堆棧跟踪列表。
errorIconColor string 如果跨度被標記為錯誤圖標的顏色error: true。

有關類型的詳細資訊 TraceSpanRow，請參閱，TraceKeyValuePair和 TraceLog（詳見） GitHub。