

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

# 探索中的日誌
<a name="v10-explore-logs"></a>

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

探索可讓您調查不同資料來源中的日誌，包括：
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

在基礎設施監控和事件回應期間，您可以深入了解指標和日誌，以找出原因。探索也可讓您side-by-side檢視日誌與其他遙測訊號，例如指標、追蹤或設定檔。

日誌查詢的結果會以個別日誌行顯示，並以圖表顯示所選期間內的日誌磁碟區。

## 記錄磁碟區
<a name="v10-explore-logs-volume"></a>

使用支援完整範圍日誌磁碟區的資料來源時，Explore 會自動顯示圖表，顯示所有輸入日誌查詢的日誌分佈。OpenSearch 和 Loki 資料來源目前支援此功能。

**注意**  
在 Loki 中，此完整範圍日誌磁碟區是由指標查詢轉譯，根據查詢的時間範圍，可能很昂貴。對於處理較小的 Loki 安裝，此查詢可能特別具有挑戰性。若要緩解這種情況，您可以在 Loki 前面使用 [nginx](https://www.nginx.com/) 之類的代理來設定這些查詢的自訂逾時 （例如 10 秒）。可以透過使用值`X-Query-Tags`為 的 HTTP 標頭尋找查詢來識別日誌磁碟區長條圖查詢`Source=logvolhist`；Grafana 會將這些標頭新增至所有日誌磁碟區長條圖查詢。

如果資料來源不支援載入完整範圍日誌磁碟區，則日誌模型會計算日誌資料列來計算時間序列，並根據自動計算的時間間隔將它們組織到儲存貯體中。第一個日誌列的時間戳記用於錨定結果中日誌磁碟區的開始。時間序列的結尾會錨定至時間挑選器的**收件人**範圍。如此一來，即使資料來源不提供完整範圍支援，您仍然可以有效率地分析和視覺化日誌資料。

## 日誌
<a name="v10-explore-logs-overview"></a>

在下列各節中，您將找到如何在探索中視覺化並與個別日誌互動的詳細說明。

## 日誌導覽
<a name="v10-explore-logs-navigation"></a>

日誌行右側的日誌導覽可用來輕鬆請求其他日誌。您可以按一下導覽底部的**舊版日誌**按鈕來執行此操作。當您達到行限制並想要查看更多日誌時，這特別有用。從導覽執行的每個請求都會在導覽中顯示為個別頁面。每個頁面都會顯示傳入日誌行的 `from`和 `to`時間戳記。您可以按一下每個頁面來查看先前的結果。探索會快取從日誌導覽中執行的最後五個請求，因此您在按一下頁面時不會重新執行相同的查詢，從而節省時間和資源。

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

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


| 選項 | Description | 
| --- | --- | 
| Time (時間) | 顯示或隱藏時間欄。這是從資料來源回報的與日誌行相關聯的時間戳記。 | 
| 唯一標籤 | 顯示或隱藏僅包含非常見標籤的唯一標籤欄。所有常用標籤都會顯示在上方。 | 
| 包裝線 | true 如果您希望顯示器使用換行，請將此設為 。如果設定為 false，則會導致水平捲動。 | 
| Prettify JSON |  將此設為 true可列印所有 JSON 日誌。此設定不會影響 JSON 以外的任何格式日誌。 | 
| 重複資料刪除 | 日誌資料可以非常重複，探索可以透過隱藏重複的日誌行來提供幫助。您可以使用幾個不同的重複資料刪除演算法。完全相符項目會在整行完成，日期欄位除外。數字比對會在分割出持續時間、IP 地址等數字之後，在行上完成。Signature 是最積極的重複資料刪除，因為它會去除所有字母和數字，並在剩餘的空格和標點符號上進行比對。 | 
| 顯示結果順序 | 您可以將收到日誌的順序從預設的遞減順序 （最新先） 變更為遞增順序 （最舊先）。 | 

## 下載日誌行
<a name="v10-explore-download-log-lines"></a>

若要以 `txt`或 `json` 格式下載日誌結果，請使用**下載**按鈕。此功能可讓您儲存日誌資料以供進一步分析，或以方便且可存取的格式與他人共用。

## 日誌結果中繼資訊
<a name="v10-explore-log-result-meta-information"></a>

您可以在收到的日誌行上方找到基本中繼資訊，包括：
+ **收到的日誌數目** – 指出針對目前查詢或時間範圍收到的日誌總數。
+ **錯誤** – 在日誌結果中顯示可能的錯誤。
+ **一般標籤** – 顯示一般標籤。
+ **處理的總位元組**數 – 代表以位元組為單位處理的日誌資料的累積大小。

**注意**  
某些中繼資訊的可用性可能取決於資料來源，因此，您可能只會看到某些特定資料來源的詳細資訊。

## 逸出新行
<a name="v10-explore-log-escaping-newlines"></a>

探索會自動偵測日誌行中某些不正確逸出的序列，例如換行 (`\n`、`\r`) 或標籤 ()`\t`。當它偵測到這類序列時，Explore 會提供**逸出換行**選項。

**自動修正 Explore 偵測到的錯誤逸出序列**

1. 選擇**逸出新行**以取代序列。

1. 手動檢閱替換項目以確認其正確性。

探索會取代這些序列。這麼做時， 選項會從**逸出新行**變更為**移除逸出**。評估變更，因為剖析可能無法根據收到的輸入準確。您可以選取**移除逸出**來還原替換項目。

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

對於指定`level`標籤的日誌，我們會使用此標籤的值來決定日誌層級，並相應地更新每個日誌行的顏色。如果日誌沒有指定的層級標籤，我們會嘗試查明其內容是否符合任何支援的表達式 （如需詳細資訊，請參閱下表）。日誌層級一律由第一個相符項目決定。如果 Grafana 無法推斷日誌層級欄位，則會使用未知的日誌層級將其視覺化。

**注意**  
如果您使用 Loki 資料來源，且 `level`是日誌列的一部分，則可以使用剖析器 (JSON、logfmt、regex..) 將關卡資訊擷取到用於判斷關卡值的關卡標籤。這將允許長條圖將各種日誌層級顯示為單獨的長條。

**支援的日誌層級和日誌層級縮寫和表達式的映射：**


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

## 反白搜尋的單字
<a name="v10-explore-highlight-searched-words"></a>

當您的查詢包含要搜尋的特定單字或表達式時，Explore 會在日誌列中反白這些單字或表達式，以獲得更好的可見性。此反白功能可讓您更輕鬆地識別和專注於日誌中的相關內容。

**注意**  
反白搜尋字詞的功能可能會因資料來源而有所不同。對於某些資料來源，可能無法使用搜尋字詞的反白。

## 日誌詳細資訊檢視
<a name="v10-explore-log-details-view"></a>

在探索中，每個日誌行都有一個稱為*日誌詳細資訊*的可擴展區段，可以透過選擇日誌行開啟。日誌詳細資訊檢視以連接到日誌行*的欄位*和*連結*形式提供其他資訊和探索選項，從而實現更強大的互動和分析。

**欄位**

在日誌詳細資訊檢視中，您可以透過兩種方式篩選顯示的欄位：正面篩選條件 （專注於特定欄位） 和負面篩選條件 （排除特定欄位）。這些篩選條件會更新產生日誌行的對應查詢，並相應地新增等式和不等式表達式。如果資料來源支援，如同 Loki 和 OpenSearch 的情況，日誌詳細資訊會檢查目前查詢中是否已存在 欄位，顯示 和作用中狀態 （僅適用於正面篩選條件），允許您將其關閉查詢，或將篩選條件表達式從正面變更為負面。

您可以按一下眼睛圖示，選取要在日誌清單中視覺化的欄位子集，而不是完整的日誌行。每個欄位都有一個統計資料圖示，可顯示與所有顯示日誌相關的統計資料。

**連結**

Grafana 提供資料連結或相互關聯的功能，可讓您將日誌訊息的任何部分轉換為內部或外部連結。這些連結可用來導覽至相關資料或外部資源，提供無縫且方便的方式來探索進一步資訊。

## 日誌內容
<a name="v10-explore-log-context"></a>

日誌內容會顯示與特定搜尋查詢相符的日誌項目相關的額外內容行。這有助於了解日誌項目的內容，並且類似於 `grep`命令中的 `-C` 參數。

您可能會遇到長行文字，使得難以讀取和分析每個日誌項目的內容。這是**包裝線**切換可以方便使用的位置。透過啟用此切換，Grafana 將自動包裝長行文字，使其符合檢視器的可見寬度。這可讓您更輕鬆地閱讀和了解日誌項目。

 在**分割檢視中開啟**按鈕可讓您在探索檢視的分割畫面中執行日誌項目的內容查詢。選擇此按鈕會開啟新的探索窗格，其中包含與日誌項目一起顯示的內容查詢，讓您更輕鬆地分析和了解周圍的內容。

您也可以在新的瀏覽器索引標籤中開啟日誌內容查詢，方法是在選擇按鈕以開啟內容模式時按下 `Ctrl`（或 `Cmd`) 鍵。在新索引標籤中開啟時，先前選取的篩選條件也會套用。

## 複製日誌行
<a name="v10-explore-copy-log-line"></a>

您可以透過選擇複製日誌列按鈕，輕鬆將所選**日誌列的內容複製到**剪貼簿。

## 將連結複製到日誌行
<a name="v10-explore-copy-link-to-log-line"></a>

在 Grafana 中連結日誌行可讓您快速導覽至特定日誌項目以進行精確分析。透過選擇日誌行的**複製短連結**按鈕，您可以產生和複製簡短 URL，以便在絕對時間範圍內直接存取確切的日誌項目。當您開啟連結時，Grafana 會自動捲動至對應的日誌行，並以藍色背景反白顯示它，讓您輕鬆識別並專注於相關資訊。

**注意**  
這僅在 Loki 和提供 `id` 欄位的其他資料來源中受支援。