?️URL: https://grafana.com/docs/grafana/latest/explore/trace-integration/
?Description:
Tracing in Explore
Explore 允許你將 tracing 資料來源的痕跡視覺化。這在 Grafana v7.0+中可用。
支援的資料來源有。
關於如何為上述資料來源配置查詢的資訊，請參考特定資料來源的文件。
- 標題。顯示根 span 的名稱和 trace ID。
- 搜尋。突出包含搜尋文字的 span。
- 後設資料。關於追蹤的各種後設資料。
Minimap
顯示濃縮的檢視或跟蹤時間線。在最小地圖上拖動你的滑鼠可以放大到更小的時間範圍。縮放也將更新主時間線，所以很容易看到較短的時間跨度。當放大時，將滑鼠懸停在最小地圖上，將顯示重置選擇按鈕，以重置縮放。
Timeline（時間線）
顯示 trace 中的 span 列表。每個 span 行由這些元件組成。
- 展開子 span 按鈕。展開或摺疊選定 span 的所有子 span。
- 服務名稱：記錄該 span 的服務的名稱。
- 操作名稱：該 span 所代表的操作的名稱。
- span 持續時間欄。trace 中操作持續時間的視覺化表示。
在 span 行的任何地方點選，顯示跨度的細節。
Span 細節
- 操作名稱
- span 後設資料
- Tags。與此 span 相關的任何標籤。
- 程式後設資料。關於記錄此跨度的程式的後設資料。
- 日誌。此 span 所記錄的日誌列表和相關的鍵值。如果是 Zipkin 日誌，則顯示 Zipkin 的註釋。
Node graph
你可以選擇為所顯示的 trace 展開節點圖 (node graph)。根據資料來源的不同，這可以將 trace 的 span 顯示為圖中的節點，或者顯示一些額外的上下文，如基於當前 trace 的 service graph。
Trace to logs
Note: 在 Grafana 7.4 及更高版本中可用。
你可以從 trace 檢視中的 span 直接導航到與該 span 相關的日誌。目前，這對 Tempo、Jaeger 和 Zipkin 資料來源是可用的。關於如何配置這個功能，請參考他們的相關文件。
點選文件圖示，在 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
Grafana 系列文章
三人行, 必有我師; 知識共享, 天下為公. 本文由東風微鳴技術部落格 EWhisper.cn 編寫.