本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 探索 Grafana 第 9 版
****
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。
Grafana 的儀表板 UI 提供建立儀表板以進行視覺化的功能。*探索*儀表板和面板選項的分割，讓您可以專注於查詢。它可協助您反覆執行，直到您有工作查詢為止，然後您可以從查詢建置儀表板。
**注意**
如果您只想探索資料，但不想建立儀表板，Explore 會讓您更輕鬆。如果您的資料來源支援圖形和資料表資料，則 Explore 會將結果顯示為圖形和資料表。這可讓您同時查看資料中的趨勢和更多詳細資訊。
## 開始探索
**注意**
若要存取探索，您必須擁有編輯器或管理員角色。
**存取探索**
1. 在 Grafana 工作區中，從左側選單列中選擇探索選單項目。
開啟空的探索索引標籤。
或者，若要從面板中的現有查詢開始，請從面板功能表中選擇探索選項。這會從面板中開啟具有查詢的探索索引標籤，並可讓您在儀表板外部的查詢中調整或反覆執行。
1. 從左上角的下拉式清單中選擇您的資料來源。[Prometheus](prometheus-data-source.md) 具有自訂探索實作，其他資料來源使用其標準查詢編輯器。
1. 在查詢欄位中，撰寫您的查詢以探索您的資料。查詢欄位旁有三個按鈕：清除按鈕 (X)、新增查詢按鈕 (＋) 和移除查詢按鈕 (-)。就像一般查詢編輯器一樣，您可以新增和移除多個查詢。
如需查詢的詳細資訊，請參閱 [查詢和轉換資料](v9-panels-query-xform.md)。
## 分割和比較
分割檢視提供簡單的方法來side-by-side比較圖形和資料表，或在同一頁面上一起查看相關資料。
**頂端開啟分割檢視**
1. 在探索檢視中，選擇**分割**按鈕以複製目前的查詢，並將頁面分割成兩個side-by-side查詢。
**注意**
您可以為新查詢選取另一個資料來源，例如，可讓您比較兩個不同伺服器的相同查詢，或比較預備環境與生產環境。
在分割檢視中，可以透過選取連接到其中一個計時字元的時間同步按鈕來連結兩個面板的計時字元 （如果您變更一個，另一個也會變更）。連結分片檢視查詢的開始和結束時間會保持同步。它可確保您在兩個分割面板中查看相同的時間間隔。
1. 若要關閉新建立的查詢，請按一下關閉分割按鈕。
## 共用縮短的連結
共用縮短連結功能可讓您建立較小且更簡單的格式 /goto/：uid URLs，而不是搭配查詢參數使用較長URLs。若要建立查詢結果的縮短連結，請選取探索工具列中的**共用**選項。未使用的縮短連結會在七 (7) 天後自動刪除。
# 探索中的查詢管理
****
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。
為了協助偵錯查詢，Explore 可讓您透過查詢檢查器調查查詢請求和回應，以及查詢統計資料。此功能類似於面板檢查器任務 [檢查查詢效能](v9-panels-panel-inspector.md#v9-panels-query-performance)和[檢查查詢請求和回應資料](v9-panels-panel-inspector.md#v9-panels-query-request-response)。
## 查詢歷史記錄
查詢歷史記錄是您在探索中使用的查詢清單。歷史記錄會存放在 Grafana 資料庫中，而且不會與其他使用者共用。歷史記錄中查詢的保留期為兩週。超過兩週的查詢會自動刪除。若要開啟並與您的歷史記錄互動，請選取探索中的**查詢歷史記錄**按鈕。
**注意**
Starred （偏好） 查詢不受兩週保留期的限制，而且不會刪除。
**檢視查詢歷史記錄**
查詢歷史記錄可讓您檢視查詢的歷史記錄。對於每個個別查詢，您可以：
+ 執行查詢。
+ 建立和/或編輯註解。
+ 將查詢複製到剪貼簿。
+ 將包含查詢的縮短連結複製到剪貼簿。
+ Star （我的最愛） 查詢。
**管理我的最愛查詢**
在查詢歷史記錄索引標籤中以星號顯示的所有查詢都會顯示在 Starred 清單中。這可讓您更快地存取您最愛的查詢，並重複使用這些查詢，而無需從頭開始輸入。
**排序查詢歷史記錄**
根據預設，查詢歷史記錄會顯示最新的查詢。您可以依日期或資料來源名稱以遞增或遞減順序來排序歷史記錄。
**排序查詢歷史記錄**
1. 選取**依欄位排序查詢**。
1. 選取以下其中一個選項：
+ 最新優先
+ 最舊的先
**篩選查詢歷史記錄**
您可以在查詢歷史記錄和 Starred 索引標籤中篩選特定資料來源的查詢歷史記錄。
**篩選資料來源的歷史記錄**
1. 選取**特定資料來源的篩選條件查詢 （篩選）** 欄位。
1. 選取您要篩選歷史記錄的資料來源。您可以選取多個資料來源。
在**查詢歷史記錄**索引標籤中，也可以使用滑桿依日期篩選查詢：
+ 使用垂直滑桿依日期篩選查詢。
+ 拖曳頂端控點以調整開始日期。
+ 拖曳頂端控點來調整結束日期。
**在查詢歷史記錄中搜尋**
您可以在查詢和註解之間搜尋歷史記錄。您可以在查詢歷史記錄索引標籤和 Starred 索引標籤中搜尋查詢。
**在查詢歷史記錄中搜尋**
1. 選取**搜尋查詢**欄位。
1. 在搜尋欄位中輸入您要搜尋的詞彙。
**查詢歷史記錄設定**
您可以在設定索引標籤中自訂查詢歷史記錄。選項如下表所述。
| 設定 | 預設值 |
| --- | --- |
| 變更預設作用中標籤 | 查詢歷史記錄索引標籤 |
**注意**
查詢歷史記錄設定是全域的，並套用到分割模式中的兩個面板。
## Prometheus 特定功能
探索 Prometheus 的自訂查詢體驗功能。查詢執行時，實際上會執行兩個查詢，即圖形的一般 Prometheus 查詢和資料表的*即時查詢*。Instant Query 會傳回每個時間序列的最後一個值，顯示圖形中所示資料的良好摘要。
**指標瀏覽器**
在查詢欄位的左側，選擇**指標**以開啟指標總管。這會顯示階層式功能表，其中包含依其字首分組的指標。例如，所有 Alertmanager 指標都會在`alertmanager`字首下分組。如果您只想探索可用的指標，這是很好的起點。
**查詢欄位**
查詢欄位支援指標名稱和函數的自動完成，與標準 Prometheus 查詢編輯器相當。您可以按 Enter 鍵建立新的行，按 Shift\$1Enter 執行查詢。
按 Ctrl\$1Space 可觸發自動完成功能表。自動完成功能表包含新的歷史記錄區段，其中包含最近執行的查詢清單。
建議會出現在查詢欄位 - 選取它們以使用建議的變更更新您的查詢。
+ 對於計數器 （月度增加指標），將會建議速率函數。
+ 對於儲存貯體，將建議直方圖函數。
+ 對於錄製規則， 可以展開規則。
**資料表篩選條件**
選取資料表面板**標籤**欄中的篩選條件按鈕，將篩選條件新增至查詢表達式。您也可以為多個查詢新增篩選條件 - 系統會為所有查詢新增篩選條件。
# 探索中的日誌
****
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。
除了指標之外，Explore 還可讓您調查下列資料來源中的日誌：
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)
在基礎設施監控和事件回應期間，您可以深入了解指標和日誌，以找出原因。探索也可讓您side-by-side檢視指標和日誌來建立關聯。這會建立新的除錯工作流程。
1. 接收提醒。
1. 向下切入並檢查指標。
1. 再次向下切入並搜尋與指標和時間間隔 （以及未來分散式追蹤） 相關的日誌。
## 記錄視覺化
日誌查詢的結果在圖形中顯示為長條圖，而個別日誌會在下列各節中說明。
如果資料來源支援完整範圍的日誌磁碟區長條圖，則會自動顯示所有輸入日誌查詢的日誌分佈圖形。OpenSearch 和 Loki 資料來源目前支援此功能。
**注意**
在 Loki 中，此完整範圍的日誌磁碟區長條圖是由指標查詢轉譯，根據查詢的時間範圍，這可能會很昂貴。此查詢對於較小的 Loki 安裝處理特別具有挑戰性。為了緩解這種情況，我們建議在 Loki 前面使用 [nginx](https://www.nginx.com/) 之類的代理來設定這些查詢的自訂逾時 （例如 10 秒）。可以透過使用值`X-Query-Tags`為 的 HTTP 標頭尋找查詢來識別日誌磁碟區長條圖查詢`Source=logvolhist`；Grafana 會將這些標頭新增至所有日誌磁碟區長條圖查詢。
如果資料來源不支援載入完整範圍日誌磁碟區長條圖，則日誌模型會根據自動計算時間間隔儲存貯體的日誌資料列計數來計算時間序列，然後第一個日誌資料列的時間戳記會從結果錨定長條圖的開始。時間序列的結尾會錨定至時間挑選器的**收件人**範圍。
**日誌層級**
對於指定關卡標籤的日誌，Grafana 會使用標籤的值來判斷日誌關卡並相應地更新顏色。如果日誌未指定關卡標籤，則會嘗試查明其內容是否符合任何支援的表達式 （如需詳細資訊，請參閱下方）。日誌層級一律由第一個相符項目決定。如果 Grafana 無法判斷日誌層級，則會使用未知的日誌層級將其視覺化。
**提示**
如果您使用 Loki 資料來源，且 `level`位於您的日誌列中，請使用剖析器 (JSON、logfmt、regex.) 將關卡資訊擷取到用於判斷日誌關卡的關卡標籤。這將允許長條圖在不同的長條中顯示各種日誌層級。
**支援的日誌層級和日誌層級縮寫和表達式的映射：**
| 支援的表達式 | 日誌層級 | 顏色 |
| --- | --- | --- |
| emerg | 關鍵 | 紫色 |
| 嚴重 | 關鍵 | 紫色 |
| 提醒 | 關鍵 | 紫色 |
| crit | 關鍵 | 紫色 |
| 關鍵 | 關鍵 | 紫色 |
| 錯誤 | error | 紅色 |
| 錯誤 | error | 紅色 |
| error | error | 紅色 |
| 警告 | warning | 黃色 |
| warning | warning | 黃色 |
| info | info | 綠色 |
| 資訊 | info | 綠色 |
| 通知 | info | 綠色 |
| dbug | 偵錯 | 藍色 |
| 偵錯 | 偵錯 | 藍色 |
| 追蹤 | 追蹤 | 淺藍色 |
| \$1 | 不明 | 灰色 |
## 日誌導覽
日誌導覽介面位於日誌行旁，可用來請求更多日誌。您可以選取導覽底部的**較舊**日誌按鈕來執行此操作。當您達到行限制並想要查看更多日誌時，您可以使用它來擷取更多日誌。每個請求在導覽中顯示為單獨的頁面。每個頁面都會顯示傳入日誌行的往返時間戳記。您可以按一下要檢視的頁面來查看先前的結果。探索會快取從日誌導覽中執行的最後五個請求，因此在按一下這些頁面時不會重新執行相同的查詢。
## 視覺化選項
您可以自訂日誌的顯示方式，然後選取要顯示的資料欄。
**Time (時間)**
顯示或隱藏時間欄。這是從資料來源回報的與日誌行相關聯的時間戳記。
**唯一標籤**
顯示或隱藏僅包含非常見標籤的唯一標籤欄。所有常用標籤都會顯示在上方。
**包裝線**
如果您想要顯示器使用換行，請將此設定為 True。如果設定為 False，則會導致水平捲動。
**Prettify JSON**
將此設為 `true`可列印所有 JSON 日誌。此設定不會影響 JSON 以外的任何格式日誌。
**重複資料刪除**
日誌資料可以非常重複，探索可以透過隱藏重複的日誌行來提供幫助。您可以使用幾個不同的重複資料刪除演算法：
+ **完全相符** – 完全相符，但日期欄位除外。
+ **數字** – 在分割出持續時間、IP 地址等數字之後，在行上相符。
+ **Signature** – 最積極的重複資料刪除，這會在剩餘的空格和標點符號上刪除所有字母和數字以及相符項目。
**翻轉結果順序**
您可以將收到日誌的順序從預設的遞減順序 （最新先） 變更為遞增順序 （最舊先）。
**標籤和偵測到的欄位**
每個日誌列都有一個可擴展的區域，其中包含其標籤和偵測到的欄位，以進行更強大的互動。對於所有標籤，我們新增了篩選 （正篩選條件） 和篩選出 （負篩選條件） 選取標籤的功能。每個欄位或標籤也都有一個統計資料圖示，以顯示與所有顯示日誌相關的統計資料。
**逸出新行**
探索會自動偵測日誌行中某些未正確逸出的序列，例如換行 (`\n`、`\r`) 或標籤 ()`\t`。當它偵測到這類序列時，Explore 會提供「逸出新行」選項。
探索可以自動修正偵測到的錯誤逸出序列
**自動修正逸出序列**
1. 選取**逸出新行**以取代序列。
1. 手動檢閱替換項目以確認其正確性。
探索會取代這些序列。這麼做時， 選項會從**逸出新行**變更為**移除逸出**。評估變更，因為剖析可能無法根據收到的輸入準確。您可以選取**移除逸出**來還原替換項目。
**資料連結**
透過使用資料連結，您可以將日誌訊息的任何部分轉換為內部或外部連結。建立的連結會在**日誌詳細資訊**檢視內的**連結**區段中顯示為按鈕。
**切換欄位可見性**
展開日誌行，然後按一下眼睛圖示以顯示或隱藏欄位。
## Loki 特定功能
Loki 是來自 Grafana Labs 的開放原始碼日誌彙總系統。Loki 的設計符合成本效益，因為它不會為日誌的內容編製索引，而是為每個日誌串流建立一組標籤。查詢 Loki 日誌的方式與使用 Prometheus 中的標籤選擇器進行查詢的方式類似。它會使用標籤來將日誌串流分組，以便與 Prometheus 標籤相符。如需 Grafana Loki 的詳細資訊，請參閱 [Grafana Loki](https://github.com/grafana/loki) Github。
如需詳細資訊，請參閱 [Loki](using-loki-in-AMG.md) 了解如何查詢日誌資料。
**從指標切換至日誌**
如果您從 Prometheus 查詢切換到日誌查詢 （您可以先執行分割，讓您的指標和日誌並排），則會保留存在於日誌中查詢的標籤，並使用這些標籤來查詢日誌串流。例如，如果您有下列 Prometheus 查詢：
```
grafana_alerting_active_alerts{job="grafana"}
```
切換到 Logs 資料來源後，它會變更為：
```
{job="grafana"}
```
這會傳回所選時間範圍中可搜尋的日誌區塊。
## 日誌範例
如果選取的資料來源實作日誌範例，並同時支援日誌和指標查詢，則對於指標查詢，您可以自動查看導致視覺化指標的日誌行範例。Loki 資料來源目前支援此功能。
**即時結尾**
使用即時結尾功能，查看支援資料來源的即時日誌。
選取探索工具列中的**即時**按鈕，以切換至即時尾部檢視。
在即時結尾檢視中，新日誌將來自畫面底部，並將淡入對比背景，以便您可以追蹤新內容。選取**暫停**按鈕或捲動日誌檢視，以暫停即時結尾並探索先前的日誌，而不會中斷。選取**繼續**按鈕以繼續即時結尾，或選取**停止**按鈕以結束即時結尾，然後返回標準探索檢視。
# 探索中的追蹤
****
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。
探索可讓您從追蹤資料來源視覺化追蹤。
支援下列資料來源。
+ [Jaeger](jaeger-data-source.md)
+ [Tempo](tempo-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)
如需有關如何為上述資料來源設定查詢的資訊，請參閱特定資料來源的文件。
## 追蹤檢視說明
本節說明追蹤檢視儀表板的元素。
**標頭**
追蹤檢視的 標頭具有下列元素
+ 標題標題：顯示根範圍和追蹤 ID 的名稱。
+ 搜尋：反白顯示包含搜尋文字的跨度。
+ 中繼資料：有關追蹤的各種中繼資料。
**最小映射**
顯示精簡檢視或追蹤時間軸。將指標拖曳到小地圖上，以放大較小的時間範圍。縮放也會更新主要時間軸，因此很容易看到較短的跨度。將滑鼠游標暫留在小地圖上，縮放時會顯示重設選擇按鈕，以重設縮放。
**時間軸**
顯示追蹤內的跨度清單。每個跨度列都包含下列元件：
+ 展開子系按鈕：展開或摺疊所選範圍的所有子系。
+ 服務名稱：記錄跨度的服務名稱。
+ 操作名稱：此跨度代表的操作名稱。
+ 範圍持續時間列：追蹤內操作持續時間的視覺化表示。
**跨度詳細資訊**
按一下跨度列上的任意位置會顯示跨度詳細資訊，包括下列項目。
+ 操作名稱
+ 跨度中繼資料
+ 標籤：與此跨度相關聯的任何標籤。
+ 程序中繼資料：記錄此範圍之程序的中繼資料。
+ 日誌：此範圍所記錄的日誌清單和相關聯的金鑰值。如果是 Zipkin 日誌區段，會顯示 Zipkin 註釋。
**節點圖形**
您可以選擇性地展開所顯示追蹤的節點圖形。根據資料來源，這可以在圖表中將追蹤的範圍顯示為節點，或新增一些額外的內容，包括基於目前追蹤的服務圖表。
**追蹤至日誌**
您可以從追蹤檢視中的範圍直接導覽至與該範圍相關的日誌。這適用於 Tempo、Jaeger 和 Zipkin 資料來源。如需如何設定每個資料來源的說明，請參閱其相關文件。
按一下文件圖示，以使用設定的資料來源在探索中開啟分割檢視，並查詢範圍的相關日誌。
## 服務圖表檢視
Service Graph 檢視可視覺化跨度指標 （針對速率、錯誤率和持續時間 (RED) 追蹤資料） 和服務圖表。設定需求後，即可立即使用此預先設定的檢視。
如需詳細資訊，請參閱 [Tempo](tempo-data-source.md) 資料來源頁面。您也可以在 *Tempo 文件*中查看[服務圖表檢視頁面](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)。
# 探索中的檢查器
****
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。
檢測器可協助您了解查詢並進行疑難排解。您可以檢查原始資料、將該資料匯出至逗號分隔值 (CSV) 檔案、以 TXT 格式匯出日誌結果，以及檢視查詢請求。
## Inspector UI
檢測器具有下列標籤：
+ **統計資料索引標籤** – 顯示查詢需要多少時間，以及傳回多少。
+ **查詢索引標籤** – 顯示 Grafana 查詢資料來源時傳送至伺服器的請求。
+ **JSON 索引標籤** – 可讓您檢視和複製資料 JSON 和資料框架結構 JSON。
+ **資料索引標籤** – 顯示查詢傳回的原始資料。
+ **錯誤索引標籤** – 顯示錯誤。只有在查詢傳回錯誤時才會顯示。
## Inspector 任務
您可以在探索檢查器中執行各種任務。
**開啟檢查器**
執行您要檢查的查詢之後，請選取**檢查器**按鈕。
檢測器窗格會在畫面底部開啟。
*檢查原始查詢結果*
您可以檢視原始查詢結果，這是資料表中查詢傳回的資料。
在**檢查程式**索引標籤中，按一下**資料**索引標籤。
對於多個查詢或查詢多個節點，還有其他選項。
+ **顯示資料框架：**選取您要檢視的結果集資料。
+ **依時間聯結的序列：**一次檢視所有查詢的原始資料，每欄一個結果集。您可以按一下欄標題來排序資料。
**將原始查詢結果下載為 CSV**
檢視原始查詢結果之後，您可以產生結果的 CSV 檔案。您將看到結果的 CSV 檔案，因此請務必在產生 CSV 檔案之前縮小結果範圍，以取得您想要的結果。
若要產生 CSV 檔案，請在**檢查工具**標籤中選取**下載 CSV**。
若要下載專為 Excel 格式化的 CSV 檔案，請展開**資料選項**，然後在選取下載 **CSV** 選項之前開啟**下載 Excel** 切換。
*將日誌結果下載為 TXT*
您可以在 **Inspector** 索引標籤中選取**下載**日誌，以產生您目前檢視之日誌的 TXT 檔案。
**下載追蹤結果**
根據資料來源類型，Grafana 可以其中一個支援的格式產生追蹤結果的 JSON 檔案：Jaeger、Zipkin 或 OTLP 格式。
若要下載追蹤，請選取 **Inspector **索引標籤上的**下載追蹤**。
**檢查查詢效能**
**統計資料**索引標籤會顯示統計資料，告訴您查詢需要多長時間、傳送多少查詢，以及傳回的資料列數。此資訊可協助您對查詢進行疑難排解，尤其是在任何數字意外過高或過低的情況下。
統計資料為唯讀。
**檢視 JSON 模型**
您可以探索和匯出資料以及資料框架 JSON 模型。
**檢視 JSON 模型**
1. 在檢查工具面板中，按一下 **JSON** 索引標籤。
1. 從**選取來源**下拉式清單中，選擇下列其中一個選項：
+ **資料** – 顯示 JSON 物件，代表傳回給探索的資料。
+ **DataFrame 結構** – 顯示原始結果集。
1. 您可以展開或摺疊 JSON 的部分，以檢視個別區段。您也可以選取**複製到剪貼簿**選項，以複製 JSON 內文並將其貼到另一個應用程式。
**檢視對資料來源的原始請求和回應**
當您使用 Explore 和 Inspector 索引標籤時，您可以檢視使用查詢產生的原始請求和回應資料。在檢查器中，選取**查詢**索引標籤，然後選擇**重新整理**以查看原始資料。
Grafana 會將查詢傳送至伺服器並顯示結果。您可以向下切入查詢的特定部分、展開或摺疊所有部分，或將資料複製到剪貼簿，以便在其他應用程式中使用。