本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
探索中的記錄
本文件主題是針對支援 Grafana 9.x 版的 Grafana 工作區所設計。
如需支援 Grafana 10.x 版的 Grafana 工作區,請參閱。在 Grafana 第 10 版工作
如需支援 Grafana 8.x 版的 Grafana 工作區,請參閱。在 Grafana 第 8 版中工作
除了指標外,Explore 還可讓您調查下列資料來源中的記錄檔:
在基礎結構監控和事件回應期間,您可以深入研究指標和日誌以找出原因。「探索」也可讓您透過檢視指標和記錄來建立關聯。 side-by-side這會建立新的偵錯工作流程。
-
接收警報。
-
向下鑽取並檢查指標。
-
再次向下展開並搜尋與測量結果和時間間隔 (以及 future 分散式追蹤) 相關的日誌。
日誌可視化
記錄查詢的結果會在圖形中顯示為長條圖,下列各節會說明個別記錄檔。
如果資料來源支援全範圍記錄體積長條圖,則會自動顯示所有輸入記錄查詢的記錄分佈圖表。 OpenSearch 和 Loki 資料來源目前支援此功能。
注意
在 Loki 中,此全範圍日誌量柱狀圖是由度量查詢呈現的,根據查詢的時間範圍而定,這可能會很昂貴。對於較小的 Loki 安裝進行處理,此查詢可能特別具有挑戰性。為了減輕這種情況,我們建議在 Loki 前面使用像 nginxX-Query-Tags
與值的 HTTP 標頭查詢進行識別Source=logvolhist
; 這些標頭由 Grafana 添加到所有日誌量柱狀圖查詢。
如果資料來源不支援載入完整範圍記錄體積長條圖,則記錄模型會根據自動計算的時間間隔劃分的記錄資料列計數計算一個時間序列,而第一個記錄資料列的時間戳記則會從結果錨定長條圖的開始。時間序列的結尾會錨定至時間選擇器的「到」範圍。
記錄層級
對於指定層級標籤的記錄,Grafana 會使用標籤的值來決定記錄層級並相應地更新顏色。如果記錄檔沒有指定層級標籤,它會嘗試找出其內容是否符合任何支援的運算式 (如需詳細資訊,請參閱下方)。記錄層級永遠由第一個相符項目決定。如果 Grafana 無法確定日誌級別,它將以未知的日誌級別進行視覺化。
提示
如果您使用 Loki 資料來源,並且位level
於記錄行中,請使用剖析器 (JSON、logfmt、regex 等) 將層級資訊擷取到用於判斷記錄層級的層級標籤中。這將允許直方圖顯示在不同的酒吧的各種日誌級別。
支援的記錄層級以及記錄層級縮寫和運算式的對應:
支援運算式 | 日誌層級 | 顏色 |
---|---|---|
突然出現 |
關鍵 |
紫色 |
致命的 |
關鍵 |
紫色 |
提醒 |
關鍵 |
紫色 |
暴擊 |
關鍵 |
紫色 |
關鍵 |
關鍵 |
紫色 |
錯誤 |
error |
紅色 |
愛神 |
error |
紅色 |
error |
error |
紅色 |
警告 |
warning |
黃色 |
warning |
warning |
黃色 |
info |
info |
綠色 |
資訊 |
info |
綠色 |
注意 |
info |
綠色 |
dbug |
偵錯 |
藍色 |
偵錯 |
偵錯 |
藍色 |
跟踪 |
跟踪 |
淺藍 |
* |
未知 |
灰色 |
日誌導航
記錄檔導覽介面 (位於記錄行旁) 可用來要求更多記錄。您可以選取導覽底部的 [較舊的記錄檔] 按鈕來執行此操作。當您達到行限制並希望查看更多日誌時,可以使用它來獲取更多日誌。每個請求都顯示在導航中作為一個單獨的頁面。每個頁面都會顯示傳入日誌行的「從」和「到」時間戳記。您可以通過單擊頁面查看以前的結果進行查看。Explore 會快取從記錄導覽執行的最後五個要求,因此在按一下這些頁面時不會重新執行相同的查詢。
視覺化選項
您可以自訂記錄的顯示方式,並選取要顯示哪些欄。
Time (時間)
顯示或隱藏時間欄。這是與資料來源報告的記錄行相關聯的時間戳記。
獨特的標籤
顯示或隱藏僅包含非常見標籤的唯一標籤欄。所有一般標示均顯示在上方。
折行
如果您希望顯示器使用換行,請將此項設定為 True。如果設置為 False,它將導致水平滾動。
美化 JSON
將其設置true
為漂亮打印所有 JSON 日誌。此設定不會影響 JSON 以外的任何格式的記錄檔。
重複資料刪
日誌數據可以非常重複,「探索」可以通過隱藏重複的日誌行來提供幫助。您可以使用幾種不同的重複資料刪除演算法:
-
完全相符 — 除了日期欄位以外,會在整行上完成完全相符。
-
數字 — 刪除持續時間、IP 位址等數字之後,線上的相符項目。
-
簽名 — 最具攻擊性的重複資料刪除功能,可去除剩餘空格和標點符號上的所有字母和數字以及匹配項。
翻轉結果順序
您可以將接收記錄的順序從預設遞減順序 (最新的優先順序) 變更為遞增順序 (最舊的優先順序)。
標籤和偵測到的欄位
每個日誌行都有一個帶有標籤和檢測到的字段的可擴展區域,以實現更強大的交互。對於所有標籤,我們添加了過濾(正過濾器)和過濾掉(負過濾器)選定標籤的功能。每個欄位或標籤也有一個統計資料圖示,可顯示與所有顯示記錄相關的統計資料。
轉義換行符
探索會自動偵測記錄行中某些錯誤逸出的序列,例如換行符號 (\n
,\r
) 或 tab (\t
)。當它檢測到此類序列時,Explore 會提供「逸出換行符」選項。
探索可以自動修復偵測到的錯誤逸出序列
自動修正逸出序列
-
選取「逸出新行」以取代序列。
-
手動檢閱替換項目以確認其正確性。
探索會取代這些序列。當它這樣做時,該選項將從 E scape 換行符更改為刪除轉義。根據收到的輸入,因為剖析可能不準確,評估變更。您可以選取「移除逸出」來回復取代物。
資料連結
透過使用資料連結,您可以將記錄訊息的任何部分轉換為內部或外部連結。在 [記錄檔詳細資料] 檢視內的 [連結] 區段中,建立的連結會顯示為按鈕。
切換欄位可見性
展開記錄行,然後按一下眼睛圖示以顯示或隱藏欄位。
洛基特定功能
洛基是從 Grafana 實驗室的開源日誌聚合系統。Loki 被設計為具有成本效益,因為它不會索引日誌的內容,而是為每個日誌流編制一組標籤。來自 Loki 的日誌以類似的方式查詢,與在 Prometheus 中使用標籤選擇器進行查詢。它使用標籤來分組日誌流,這些日誌流可以與您的 Prometheus 標籤匹配。有關 Grafana 洛基的更多信息,你可以看到 Gra
如需詳細資訊,請參閱有關如何查詢記錄資料的 Loki。
從指標切換到日誌
如果您從 Prometheus 查詢切換到日誌查詢(您可以先進行拆分以使指標和日誌並排),那麼它將保留日誌中存在的查詢中的標籤,並使用這些標籤來查詢日誌流。例如,如果您有以下的 Prometheus 查詢:
grafana_alerting_active_alerts{job="grafana"}
切換到記錄資料來源後,它將變更為:
{job="grafana"}
這將返回所選時間範圍內的一塊日誌,可以被搜索。
日誌樣本
如果選取的資料來源實作記錄範例,且同時支援記錄和指標查詢,則對於量度查詢,您將能夠自動查看有助於視覺化指標的記錄行範例。Loki 資料來源目前支援此功能。
活尾
使用即時拖尾功能查看支援資料來源的即時記錄。
選取「瀏覽」工具列中的「即時」按鈕,以切換至「即時尾部檢視」。
雖然在實時尾視圖中,新日誌將來自屏幕底部,並且會褪色對比背景,因此您可以跟踪什麼是新的。選取 [暫停] 按鈕或捲動記錄檢視以暫停即時拖尾,並瀏覽先前的記錄檔而不會中斷。選取「繼續」按鈕以繼續「即時追蹤」,或選取「停止」按鈕以結束即時追蹤並返回標準「瀏覽」檢視。