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

# 探索
<a name="explore"></a>

****  
本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 12.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 12 版](using-grafana-v12.md)。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。

 在 Grafana 工作區中，儀表板 UI 提供工具來建置儀表板以進行視覺化。*探索*所有儀表板和面板選項的分割，讓您可以專注於查詢。反覆運算，直到您有正常運作的查詢，然後規劃並建置儀表板。

 對於基礎設施監控和事件回應，您不再需要切換到其他工具來偵錯錯誤。您可以使用探索來深入了解指標和日誌，以找出原因。

 探索可讓您更輕鬆地檢視資料，而無需建立儀表板。如果您的資料來源支援圖形和資料表資料，Explore 會將結果顯示為圖形和資料表。這可協助您同時查看資料中的趨勢和更多詳細資訊。

## 開始探索
<a name="start-exploring"></a>

**注意**  
 根據預設，具有檢視器角色的使用者無法編輯，也無法存取探索。

 左側選單上的**探索**圖示會開啟空的探索索引標籤。

 若要從面板中的現有查詢開始，請從**面板**功能表中選擇**探索**選項。這會開啟探索索引標籤，其中包含面板中的查詢。然後，您可以在儀表板外部的查詢中調整或重複。

 從左上角的下拉式清單中選擇您的資料來源。Prometheus 具有自訂探索實作。其他資料來源使用其標準查詢編輯器。

 在查詢欄位中，您可以撰寫查詢並探索資料。查詢欄位旁有三個按鈕：清除按鈕 (X)、新增查詢按鈕 (＋) 和移除查詢按鈕 (-)。如同面板查詢編輯器，您可以新增和移除多個查詢。

## 分割和比較
<a name="split-and-compare"></a>

 分割檢視功能是side-by-side比較圖形和資料表，或在同一頁面上一起查看相關資料的一種方式。選擇**分割**以複製目前的查詢，並將頁面分割成兩個side-by-side查詢。您可以選擇為新查詢選取不同的資料來源。這可讓您比較兩個不同伺服器的相同查詢，或比較預備環境與生產環境。

 在分割檢視中，可以透過選擇連接至時間挑選器的其中一個時間同步按鈕來連結兩個面板的時間挑選器 （如果您變更一個，另一個也會變更）。連結時間挑選器有助於保持分割檢視查詢的開始和結束時間同步，以便您在兩個分割面板中查看相同的時間間隔。

 您可以選擇關閉**分割來關閉**新建立的查詢。

## 共用縮短的連結
<a name="share-shortened-link"></a>

 使用**共用縮短連結**功能來建立格式較小且更簡單的 URLs，`/goto/:uid`而不是共用包含複雜查詢參數URLs。您可以在探索工具列中選擇**共用**選項，以建立縮短的連結。任何從未使用的縮短連結都會在 7 天後自動刪除。

## 查詢歷史記錄
<a name="query-history"></a>

 查詢歷史記錄是您在探索中使用的查詢清單。歷史記錄是瀏覽器的本機，不會共用。若要開啟並與您的歷史記錄互動，請在探索中選擇**查詢歷史記錄**。

### 檢視查詢歷史記錄
<a name="view-query-history"></a>

 FIn查詢歷史記錄中，您可以執行下列動作：
+  執行查詢。
+  建立或編輯註解。
+  將查詢複製到剪貼簿。
+  將包含查詢的縮短連結複製到剪貼簿。
+  將查詢設為 Star。

### 管理我的最愛查詢
<a name="manage-favorite-queries"></a>

 在查詢歷史記錄索引標籤中以星號顯示的所有查詢都會顯示在 Starred 索引標籤上。您可以更快地存取您最愛的查詢，並重複使用這些查詢，而無需重新輸入它們。

### 排序查詢歷史記錄
<a name="sort-query-history"></a>

 根據預設，查詢歷史記錄會顯示最新的查詢。您可以依日期或資料來源名稱以遞增或遞減順序來排序歷史記錄。

在查詢歷史記錄的右側，在下拉式清單中，選擇下列其中一個選項： 欄位。
+  最新優先 
+  最舊的先 
+  資料來源 A-Z 
+  資料來源 Z-A 

**注意**  
 如果您位於分割檢視中，排序模式僅適用於作用中的面板。

### 篩選查詢歷史記錄
<a name="filter-query-history"></a>

 在**查詢歷史記錄**和 **Starred** 索引標籤上，您可以依資料來源名稱篩選查詢歷史記錄。

1. 針對**特定資料來源選擇篩選查詢 （篩選）**。

1. 選取您要用來篩選歷史記錄的資料來源。您可以選取多個資料來源。

在**查詢歷史記錄**索引標籤上，您可以使用垂直滑桿依日期篩選查詢：
+ 拖曳下方控點以調整開始日期。
+ 拖曳上方控點以調整結束日期。

**注意**  
如果您位於分割檢視中，篩選條件只會套用至作用中的面板。

### 在查詢歷史記錄中搜尋
<a name="search-in-query-history"></a>

 您可以在查詢和註解之間搜尋歷史記錄。您可以在查詢**歷史記錄和 Starred 索引標籤中搜尋查詢**。 ****

1.  選擇**搜尋查詢**欄位。

1.  在搜尋欄位中，輸入您的搜尋詞彙。

### 查詢歷史記錄設定
<a name="query-history-settings"></a>

 您可以在**設定**索引標籤中自訂查詢歷史記錄。下表列出可用的選項。


|  設定  |  預設值  | 
| --- | --- | 
|  指定 Grafana 將儲存查詢歷史記錄的時間長度。 |  1 週  | 
|  變更預設作用中標籤。 |  查詢歷史記錄索引標籤  | 
|  僅顯示目前在探索中作用中之資料來源的查詢。 |  True  | 
|  清除查詢歷史記錄。 |  （選擇清除查詢歷史記錄以永久刪除所有已儲存的查詢。)  | 

**注意**  
查詢歷史記錄設定是全域的，它們會以分割模式套用到兩個面板。

## Prometheus 特定功能
<a name="prometheus-specific-features"></a>

 探索的第一個版本具有 Prometheus 的自訂查詢體驗。當您執行查詢時，Grafana 實際上會執行兩個查詢：圖形的一般 Prometheus 查詢和資料表的即時查詢。Instant Query 會傳回每個時間序列的最後一個值，顯示圖形中所示資料的良好摘要。

### 指標瀏覽器
<a name="metrics-explorer"></a>

 在查詢欄位的左側，選擇**指標**以開啟指標總管。這會顯示階層式功能表，其中包含依其字首分組的指標。例如，所有 Alertmanager 指標都會在`alertmanager`字首下分組。這是探索哪些指標可用的良好起點。

### 查詢欄位
<a name="query-field"></a>

 查詢欄位支援指標名稱、函數的自動完成，且運作方式與標準 Prometheus 查詢編輯器大致相同。按 **Enter** 執行查詢。

 按 **Ctrl\+Space** 即可存取自動完成功能表。自動完成功能表包含新的歷史記錄區段，其中包含最近執行的查詢清單。

 建議會出現在查詢欄位下。選擇建議，以使用建議的變更更新您的查詢。
+  對於計數器 （單調增加指標），建議使用速率函數。
+  對於儲存貯體，建議使用長條圖函數。
+  對於錄製規則， 可以展開規則。

### 資料表篩選條件
<a name="table-filters"></a>

 選擇資料表面板**標籤**欄中的**篩選條件**按鈕，將篩選條件新增至查詢表達式。您也可以為多個查詢新增篩選條件。系統會為所有查詢新增篩選條件。

## 日誌整合
<a name="logs-integration"></a>

 您也可以使用探索來調查具有下列資料來源的日誌：
+  InfluxDB 
+  Elasticsearch 

### 記錄視覺化
<a name="logs-visualization"></a>

 日誌查詢的結果會在圖表中顯示為長條圖，而個別日誌會顯示在下方。如果資料來源未傳送請求時間範圍的長條圖資料，則日誌模型會根據自動計算的時間間隔所儲存的日誌資料列計數來計算時間序列。然後，長條圖的開始會由結果中第一個日誌列的時間戳記錨定。時間序列的結尾會錨定至時間挑選器的 **To** 範圍。

#### 日誌層級
<a name="log-level"></a>

 對於指定**關**卡標籤的日誌，Grafana 會使用標籤的值來判斷日誌關卡，並相應地更新顏色。如果日誌未指定關卡標籤，Grafana 會剖析日誌，以了解其內容是否符合任何支援的表達式。日誌層級一律由第一個相符項目決定。如果 Grafana 無法判斷日誌層級，則會使用**未知**的日誌層級將其視覺化。下表列出日誌層級和日誌層級縮寫和表達式的映射。


|  支援的表達式  |  日誌層級  |  顏色  | 
| --- | --- | --- | 
|  emerg  |  關鍵  |  紫色  | 
|  嚴重  |  關鍵  |  紫色  | 
|  提醒  |  關鍵  |  紫色  | 
|  crit  |  關鍵  |  紫色  | 
|  關鍵  |  關鍵  |  紫色  | 
|  錯誤  |  error  |  紅色  | 
|  錯誤  |  error  |  紅色  | 
|  error  |  error  |  紅色  | 
|  警告  |  warning  |  黃色  | 
|  warning  |  warning  |  黃色  | 
|  info  |  info  |  綠色  | 
|  資訊  |  info  |  綠色  | 
|  通知  |  info  |  綠色  | 
|  dbug  |  偵錯  |  藍色  | 
|  偵錯  |  偵錯  |  藍色  | 
|  追蹤  |  追蹤  |  淺藍色  | 
|  \*  |  不明  |  灰色  | 

### 視覺化選項
<a name="visualization-options"></a>

 您可以自訂日誌的顯示方式，並選取顯示的欄。

#### 時間
<a name="visualization-options-time"></a>

 此選項會顯示或隱藏時間欄。這是從資料來源回報的與日誌行相關聯的時間戳記。

#### 唯一標籤
<a name="visualization-options-unique-labels"></a>

 此選項會顯示或隱藏唯一標籤欄，其中僅包含非常見標籤。所有常用標籤都會顯示在上方。

#### 包裝線
<a name="visualization-options-wrap-lines"></a>

 若要在顯示器中使用換行，請將此設定為 **True**。將此選項設定為 **False** 會導致水平捲動。

#### 降級
<a name="visualization-options-deduping"></a>

 日誌資料可以非常重複。探索可以透過隱藏重複的日誌行來提供幫助。您可以從不同的重複資料刪除演算法中選擇：
+  **完全相符** – 完全相符，但日期欄位除外。
+  **數字** – 在分割持續時間、IP 地址等數字之後，在行上完成比對。
+  **Signature** – 最積極的重複資料刪除，這會帶出所有字母和數字。比對會在剩餘的空格和標點符號上完成。

#### 翻轉結果順序
<a name="visualization-options-flip-results-order"></a>

 您可以將收到日誌的順序從預設的遞減順序 （最新先） 變更為遞增順序 （最舊先）。

### 標籤和偵測到的欄位
<a name="labels-and-detected-fields"></a>

 每個日誌列都有一個可延伸的區域，其中包含其標籤和偵測到的欄位，以進行更強大的互動。對於所有標籤，您可以篩選 （正篩選條件） 和篩選掉 （負篩選條件） 選取的標籤。每個欄位或標籤也都有一個統計資料圖示，以顯示與所有顯示日誌相關的一次性統計資料。

### 切換偵測到的欄位
<a name="toggle-detected-fields"></a>

 如果您的日誌以 JSON 或 logfmt 建構，您可以顯示或隱藏偵測到的欄位。展開日誌行，然後選擇眼睛圖示以顯示或隱藏欄位。

 {{< docs-imagebox img="/img/docs/explore/parsed-fields-7-2.gif" max-width="800px" caption="切換探索中偵測到的欄位" >}} 

## 追蹤整合
<a name="tracing-integration"></a>

 您可以在探索中視覺化追蹤資料來源的追蹤。目前支援的資料來源：
+ [連接至 Jaeger 資料來源](jaeger-data-source.md) 
+ [連線至 Tempo 資料來源](tempo-data-source.md) 
+ [連線至 AWS X-Ray 資料來源](x-ray-data-source.md) 
+ [連線至 Zipkin 資料來源](zipkin-data-source.md) 

 如需使用查詢編輯器的資訊，請參閱特定資料來源的文件。

### 標頭
<a name="explore-header"></a>

標頭包含下列項目：
+  標頭標題，顯示根範圍和追蹤 ID 的名稱 
+  搜尋，反白顯示包含搜尋文字的跨度 
+  有關追蹤的中繼資料 

### 最小映射
<a name="explore-minimap"></a>

 縮略圖顯示精簡檢視或追蹤時間軸。將滑鼠拖曳到小地圖上，以放大較小的時間範圍。縮放也會更新主要時間軸，因此很容易看到較短的跨度。如果您在小地圖上暫停，縮放時，您可以看到**重設選擇**按鈕，重設縮放。

### 時間軸
<a name="explore-timeline"></a>

 時間軸會顯示追蹤內的跨度清單。每個跨度列都包含下列元件：
+ **展開子**系按鈕：展開或摺疊所選範圍的所有子系 
+ 服務名稱：記錄跨度的服務名稱
+ 操作名稱：此跨度代表的操作名稱
+ 範圍持續時間列：追蹤內操作持續時間的視覺化表示

選擇跨度列上的任意位置會顯示跨度詳細資訊。

### 範圍詳細資訊
<a name="explore-span-details"></a>

範圍詳細資訊包括下列項目：
+  操作名稱 
+  跨度中繼資料 
+  標籤 （與此範圍相關聯的任何標籤） 
+  程序中繼資料 （記錄此範圍的程序中繼資料） 
+  日誌：此範圍所記錄的日誌清單和相關聯的金鑰值。如果是 Zipkin 日誌區段，會顯示 Zipkin 註釋。

## 在探索和儀表板之間導覽
<a name="navigating-between-explore-and-a-dashboard"></a>

 為了協助加速涉及定期從探索切換到儀表板的工作流程，反之亦然，我們新增了從面板下拉式清單導覽至探索之後返回原始伺服器儀表板的功能。

 導覽至探索之後，您應該會在探索工具列中看到「返回」按鈕。

 只需選擇按鈕即可返回原始伺服器儀表板，或者，如果您想要將探索中所做的變更帶回儀表板，只需選擇按鈕旁的箭頭，即可顯示「返回包含變更的面板」選單項目。

## 查詢檢查器
<a name="query-inspector"></a>

 為了協助偵錯查詢，Explore 可讓您透過查詢檢查器調查查詢請求和回應，以及查詢統計資料。此功能類似於面板檢查器**統計資料**索引標籤和**查詢**索引標籤。如需詳細資訊，請參閱[檢查查詢效能](inspect-a-panel.md#inspect-query-performance)及[檢視對資料來源的原始請求和回應](inspect-a-panel.md#view-raw-request-and-response-to-data-source)。