本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
探索
本文件主題是針對支援 Grafana 8.x 版的 Grafana 工作區所設計。
如需支援 Grafana 10.x 版的 Grafana 工作區,請參閱。在 Grafana 第 10 版工作
如需支援 Grafana 9.x 版的 Grafana 工作區,請參閱。在 Grafana 第 9 版中工作
在 Grafana 工作區中,儀表板 UI 提供了用於建立視覺化儀表板的工具。「探索」會刪除所有管控面板和面板選項,以便您可以專注於查詢。迭代,直到你有一個工作的查詢,然後計劃和構建儀表板。
對於基礎結構監控和事件回應,您不再需要切換到其他工具來偵錯錯誤。您可以使用「探索」深入研究指標和日誌以找出原因。
「瀏覽」可讓您更輕鬆地檢視資料,而無需建立儀表板。如果您的資料來源支援圖形和表格資料,「瀏覽」會將結果同時顯示為圖形和表格。這有助於您同時查看數據中的趨勢和更多詳細信息。
開始探索
注意
依預設,具有「檢視者」角色的使用者無法編輯,也無法存取「瀏覽器」。
左側功能表上的「瀏覽」圖示可開啟空白的「瀏覽」標籤。
若要從面板中的現有查詢開始,請從「面板」選單中選擇 「瀏覽」選項。這會開啟「瀏覽」標籤,其中包含來自面板的查詢。然後,您可以在儀表板外部的查詢中進行調整或迭代。
從左上角的下拉式清單中選擇您的資料來源。Prometheus 有一個自定義的探索實現。其他資料來源使用其標準查詢編輯器。
在查詢欄位中,您可以撰寫查詢並探索資料。查詢欄位旁有三個按鈕:清除按鈕 (X)、新增查詢按鈕 (+) 和移除查詢按鈕 (-)。如同在面板查詢編輯器中一樣,您可以新增和移除多個查詢。
拆分和比較
拆分視圖功能是一種比較圖形和表格 side-by-side 或在一個頁面上一起查看相關數據的方法。選擇「分割」以複製目前的查詢,並將頁面分割為兩個查 side-by-side 詢。您可以選擇為新查詢選取不同的資料來源。這讓您有機會比較兩個不同伺服器的相同查詢,或將暫存環境與生產環境進行比較。
在拆分視圖中,通過選擇時間選擇器附加到時間選擇器的其中一個時間同步按鈕,可以鏈接兩個面板的時間選擇器(如果更改其中一個,另一個也會更改)。鏈接時間選擇器有助於保持拆分視圖查詢的開始和結束時間同步,以便您在兩個拆分面板中查看相同的時間間隔。
您可以選擇「關閉分割」來關閉新建立的查詢。
分享縮短連結
您可以使用「共用縮短連結」功能來建立較小且較簡單的格式 URL,/goto/:uid
而不是共用包含複雜查詢參數的較長 URL。您可以在「瀏覽器」工具列中選擇「分享」選項來建立縮短連結。從未使用過的任何縮短連結會在 7 天後自動刪除。
查詢歷史
查詢歷史記錄是您在「瀏覽」中使用過的查詢列表。歷史記錄位於您的瀏覽器本地,不會共享。若要開啟您的歷史記錄並與其互動,請在「瀏覽」中選擇「查詢歷
檢視查詢歷史記錄
Fin 查詢歷史記錄,您可以執行以下操作:
-
執行查詢。
-
建立或編輯註解。
-
將查詢複製到剪貼簿。
-
將包含查詢的縮短連結複製到剪貼簿。
-
為查詢加上星號。
管理最愛查詢
在「查詢歷史記錄」標籤中加上星號的所有查詢都會顯示在「已加星號」標籤上。您可以更快地存取您最愛的查詢,並重複使用這些查詢,而無需重新輸入。
排序查詢歷史
依預設,查詢歷程記錄會顯示最近的查詢。您可以依日期或資料來源名稱,以遞增或遞減順序排序歷史記錄。
在查詢歷史記錄右側的下拉式清單中,選擇下列其中一個選項:欄位。
-
最新優先
-
最早的優先
-
資料來源 A-Z
-
資料來源 Z-A
注意
如果您在分割檢視中,排序模式只會套用至作用中的面板。
篩選查詢歷史
在「查詢歷史記錄」和「加星號」標籤上,您可以按資料來源名稱篩選查詢歷史記錄。
-
選擇 [篩選特定資料來源的查詢]。
-
選取您要用來篩選歷程記錄的資料來源。您可以選取多個資料來源。
在查詢歷史記錄標籤上,您可以使用垂直滑塊按日期過濾查詢:
-
拖曳下方控點以調整開始日期。
-
拖曳上方控點可調整結束日期。
注意
如果您在分割視圖中,篩選只會套用至作用中的面板。
在查詢歷史記錄中搜索
您可以跨查詢和評論在歷史記錄中進行搜索。「查詢歷史記錄」和「加星號」標籤中的查詢可以進行搜索。
-
選擇「搜尋查詢」欄位。
-
在搜尋欄位中,輸入您的搜尋字詞。
查詢記錄設定
您可以在「設定」頁籤中自訂查詢歷史記錄。下表列出可用的選項。
設定 | 預設值 |
---|---|
指定 Grafana 將儲存您的查詢歷史記錄的時間長度。 | 1 週 |
變更預設的作用中頁籤。 | 查詢歷史記錄頁 |
僅顯示「瀏覽器」中目前處於作用中狀態的資料來源的查詢。 | True |
清除查詢歷史記錄。 | (選擇 [清除查詢歷程記錄] 可永久刪除所有儲存的查詢。) |
注意
查詢歷程記錄設定是全域的,並且會以分割模式套用至兩個面板。
普羅米修斯特定功能
第一個版本的「探索」功能為 Prometheus 提供自訂查詢體驗。當您執行查詢時,Grafana 實際上會執行兩個查詢:圖形的正常 Prometheus 查詢和資料表的即時查詢。即時查詢返回每個時間序列的最後一個值,顯示在圖中顯示的數據的一個很好的摘要。
指標瀏覽器
在查詢欄位的左側,選擇「度量」以開啟「度量總管」。這會顯示階層式功能表,其中包含量度依其前置詞分組。例如,所有警報管理員量度都會分組在前置詞下alertmanager
。這是探索哪些量度可用的好起點。
查詢欄位
「查詢」欄位支援自動完成度量名稱、函數,且運作方式與標準 Prometheus 查詢編輯器大多相同。按 Enter 鍵執行查詢。
自動完成菜單可以通過按 Ctrl + 空格來訪問。「自動完成」選單包含新的「歷史記錄」區段,其中包含最近執行的查詢清單。
建議可以顯示在「查詢」欄位下方。選擇建議,以建議的變更來更新您的查詢。
-
對於計數器(單調增加量度),建議使用速率函數。
-
對於桶,建議使用直方圖函數。
-
對於記錄規則,可以擴展規則。
表格篩選器
在表格面板的標籤欄中選擇「篩選」按鈕,將篩選器新增至查詢運算式。您也可以為多個查詢添加過濾器。該過濾器被添加到所有查詢。
記錄檔整合
您也可以使用 Explore 調查具有下列資料來源的記錄檔:
-
資源分貝
-
Elasticsearch
日誌可視化
記錄查詢的結果會以長條圖的形式顯示在圖表中,個別的記錄顯示在下方。如果資料來源未傳送要求時間範圍的長條圖資料,則記錄模型會根據自動計算的時間間隔分段的記錄資料列計數來計算時間序列。然後,直方圖的開頭會以結果中第一個記錄資料列的時間戳記錨定。時間序列的結尾會錨定至時間選擇器的「到」範圍。
日誌層級
對於已指定層級標籤的記錄,Grafana 會使用標籤的值來決定記錄層級,並相應地更新顏色。如果記錄檔沒有指定層級標籤,Grafana 會剖析記錄檔,找出其內容是否符合任何支援的運算式。記錄層級永遠由第一個相符項目決定。如果 Grafana 無法確定日誌級別,它將以未知的日誌級別進行視覺化。下表列出記錄層級以及記錄層級縮寫和運算式的對映。
支援運算式 | 日誌層級 | 顏色 |
---|---|---|
突然出現 | 關鍵 | 紫色 |
致命的 | 關鍵 | 紫色 |
提醒 | 關鍵 | 紫色 |
暴擊 | 關鍵 | 紫色 |
關鍵 | 關鍵 | 紫色 |
錯誤 | error | 紅色 |
愛神 | error | 紅色 |
error | error | 紅色 |
警告 | warning | 黃色 |
warning | warning | 黃色 |
info | info | 綠色 |
資訊 | info | 綠色 |
注意 | info | 綠色 |
dbug | 偵錯 | 藍色 |
偵錯 | 偵錯 | 藍色 |
跟踪 | 跟踪 | 淺藍 |
* | 未知 | 灰色 |
視覺化選項
您可以自訂記錄的顯示方式,並選取要顯示哪些欄。
時間
此選項會顯示或隱藏時間欄。這是與資料來源報告的記錄行相關聯的時間戳記。
獨特的標籤
此選項會顯示或隱藏唯一標籤欄,其中僅包含非常見標籤。所有一般標示均顯示在上方。
折行
若要在顯示中使用換行,請將此選項設定為 True。將此選項設定為 False 會產生水平捲動。
去除重复
記錄檔資料可能非常重複。探索可以通過隱藏重複的日誌行來幫助。您可以選擇不同的重複資料刪除演算法:
-
完全相符 — 除了日期欄位以外,會在整行上完成完全相符。
-
數字 — 在刪除持續時間、IP 位址等數字之後,會在行上完成相符項目。
-
簽名 — 最具侵略性的刪除重複,這會剝去所有字母和數字。匹配是在剩餘的空白和標點符號完成。
翻轉結果順序
您可以將接收記錄的順序從預設遞減順序 (最新的優先順序) 變更為遞增順序 (最舊的優先順序)。
標籤和偵測到的欄位
每個日誌行都有一個帶有標籤和檢測到的字段的可擴展區域,以實現更強大的交互。對於所有標示,您可以篩選 (正篩選) 並篩選掉 (負片篩選) 選取的標籤。每個欄位或標籤也有一個統計資料圖示,可顯示與所有顯示記錄相關的一次性統計資料。
切換偵測的欄位
如果您的日誌結構為 JSON 或 logfmt,則可以顯示或隱藏檢測到的字段。展開記錄行,然後選擇眼睛圖示以顯示或隱藏欄位。
{{< 文檔圖像框 IMG =」/img/docs/explore/parsed-fields-7-2.gif「最大寬度 =" 800 像素」字幕 = "在瀏覽器中切換檢測到的字段」>}}
追蹤整合
您可以在「瀏覽器」中視覺化追蹤資料來源的追蹤。目前支援的資料來源:
如需有關使用查詢編輯器的資訊,請參閱特定資料來源的文件。
標頭
標題包括下列項目:
-
標頭標題,顯示根範圍的名稱和追蹤 ID
-
搜尋,反白顯示包含搜尋文字的範圍
-
關於追蹤的中繼資料
迷你地圖
迷你地圖會顯示精簡的檢視或追蹤時間軸。將滑鼠拖曳至迷你地圖上,以縮放至較小的時間範圍。縮放也會更新主時間軸,因此很容易看到較短的跨度。如果你在迷你地圖上暫停,縮放時,你會看到重置選擇按鈕,它重置縮放。
時間表
時間軸會顯示軌跡內的跨距清單。每個跨距列由下列元件組成:
-
展開子項按鈕:展開或收合所選範圍的所有子範圍
-
服務名稱:記錄範圍的服務名稱
-
作業名稱:此範圍代表的作業名稱
-
跨度持續時間列:追蹤內作業持續時間的視覺化表示
選擇範圍列上的任何位置會顯示範圍詳細資訊。
跨度細節
範圍詳細資訊包括下列項目:
-
操作名稱
-
跨中繼資料
-
標籤 (與此範圍相關聯的任何標籤)
-
處理中繼資料 (有關記錄此範圍之程序的中繼資料)
-
記錄:此範圍記錄的記錄清單和關聯的索引鍵值。在 Zipkin 日誌部分的情況下,顯示 Zipkin 註釋。
在瀏覽器和儀表板之間導覽
為了協助加速定期從「探索」切換到儀表板的工作流程,反之亦然,我們新增了從面板的下拉式清單導覽至「探索」後返回原始儀表板的功能。
導航到「探索」後,您應該會注意到「瀏覽」工具欄中的「上一頁」按鈕。
只要選擇按鈕,您就會返回原始儀表板,或者,如果您想要將您在「探索」中所做的變更帶回儀表板,只要選擇按鈕旁邊的箭頭,即可顯示「返回含有變更的面板」功能表項目。
查詢檢查器
為了協助您偵錯查詢,Explore 可讓您透過查詢檢查器調查查詢要求和回應,以及查詢統計資料。此功能類似於面板檢查器「統計資料」索引標籤和「查詢」頁籤。如需更多詳細資訊,請參閱 檢查查詢效能 及 檢視原始要求並回應資料來源。