Grafana 系列文章(七):Grafana Explore 中的 Tracing
???URL: https://grafana.com/docs/grafana/latest/explore/trace-integration/
??Description:
Tracing in Explore
Explore 允許你將 tracing 數據源的痕跡可視化。這在 Grafana v7.0+中可用。
支持的數據源有。
關于如何為上述數據源配置查詢的信息,請參考特定數據源的文檔。
- 標題。顯示根 span 的名稱和 trace ID。
- 搜索。突出包含搜索文本的 span。
- 元數據。關于追蹤的各種元數據。
Minimap
顯示濃縮的視圖或跟蹤時間線。在最小地圖上拖動你的鼠標可以放大到更小的時間范圍??s放也將更新主時間線,所以很容易看到較短的時間跨度。當放大時,將鼠標懸停在最小地圖上,將顯示重置選擇按鈕,以重置縮放。
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 編寫.