Grafana 系列文章（七）：Grafana Explore 中的 Tracing

???URL: https://grafana.com/docs/grafana/latest/explore/trace-integration/

??Description:

Tracing in Explore

Explore 允許你將 tracing 數據源的痕跡可視化。這在 Grafana v7.0+中可用。

支持的數據源有。

Jaeger
Tempo
X-Ray
Zipkin

關于如何為上述數據源配置查詢的信息，請參考特定數據源的文檔。

trace 視圖的截圖

trace 視圖 header 的截圖

標題。顯示根 span 的名稱和 trace ID。
搜索。突出包含搜索文本的 span。
元數據。關于追蹤的各種元數據。

Minimap

trace view minimap 截圖

顯示濃縮的視圖或跟蹤時間線。在最小地圖上拖動你的鼠標可以放大到更小的時間范圍?？s放也將更新主時間線，所以很容易看到較短的時間跨度。當放大時，將鼠標懸停在最小地圖上，將顯示重置選擇按鈕，以重置縮放。

Timeline（時間線）

Screenshot of the trace view timeline

顯示 trace 中的 span 列表。每個 span 行由這些組件組成。

展開子 span 按鈕。展開或折疊選定 span 的所有子 span。
服務名稱：記錄該 span 的服務的名稱。
操作名稱：該 span 所代表的操作的名稱。
span 持續時間欄。trace 中操作持續時間的可視化表示。

在 span 行的任何地方點擊，顯示跨度的細節。

Span 細節

Screenshot of the trace view span details

操作名稱
span 元數據
Tags。與此 span 相關的任何標簽。
進程元數據。關于記錄此跨度的進程的元數據。
日志。此 span 所記錄的日志列表和相關的鍵值。如果是 Zipkin 日志，則顯示 Zipkin 的注釋。

Node graph

你可以選擇為所顯示的 trace 展開節點圖 (node graph)。根據數據源的不同，這可以將 trace 的 span 顯示為圖中的節點，或者顯示一些額外的上下文，如基于當前 trace 的 service graph。

Node graph

Trace to logs

Note: 在 Grafana 7.4 及更高版本中可用。

你可以從 trace 視圖中的 span 直接導航到與該 span 相關的日志。目前，這對 Tempo、Jaeger 和 Zipkin 數據源是可用的。關于如何配置這個功能，請參考他們的相關文檔。

Screenshot of the trace view in Explore with icon next to the spans

點擊文檔圖標，在 Explore 中用配置的數據源打開一個分割視圖，并查詢 span 的相關日志。

Data API

這個可視化需要從數據源返回一個特定的數據結構，以便正確顯示它。

數據源需要返回數據框架并設置frame.meta.preferredVisualisationType = 'trace'。.

Data frame structure（數據框架結構）

必備字段：

字段名	類型	描述
traceID	string	整個 trace 的標識符。數據框中應該只有一個跟蹤。
spanID	string	當前 span 的標識符。SpanIDs 應該在每個 trace 中是唯一的。
parentSpanID	string	父 span 的 SpanID，用于在 trace 視圖中創建子 span 關系。對于沒有父級的根 span，可以是 `undefined`。
serviceName	string	這個 span 的服務名稱。
serviceTags	TraceKeyValuePair[]	與該服務有關的標簽列表。
startTime	number	span 的開始時間，以毫秒為單位的紀元時間 (epoch time)。
duration	number	span 的持續時間，以毫秒計。

可選字段

字段名	類型	描述
logs	TraceLog[]	與當前 span 相關的日志列表。
tags	TraceKeyValuePair[]	與當前 span 相關的標簽列表。
warnings	string[]	與當前 span 相關的警告列表。
stackTraces	string[]	與當前 span 相關的堆棧 trace 的列表。
errorIconColor	string	如果 span 被標記為`error: true`，錯誤圖標的顏色。

有關類型的詳細信息，請參閱 TraceSpanRow、TraceKeyValuePair 和 TraceLog