日誌

在你的狀態頁開啟 Observability → 日誌。最新的日誌在最上方,上方是日誌量圖表。圖表中的紅線代表錯誤,一眼就能看出問題何時開始。

日誌瀏覽器,顯示各等級數量、日誌量圖表和最新日誌

搜尋

在搜尋框輸入字詞並按 Enter。字詞可以出現在訊息的任何位置,順序不拘。要精確比對片語,請加上引號,例如 "rate limited"。

圖表、數量和清單都會隨搜尋更新。

以引號括住的片語搜尋,搭配服務篩選條件

篩選

點選空白的搜尋框,查看可篩選的欄位。先選欄位,再選值。每個欄位都會列出最常見的值及出現次數。

搜尋框下方可篩選的欄位清單
篩選條件找到
level:等級:fatal、error、warn、info、debug 或 trace
service:某個服務的日誌
trace_id:某個請求在所有服務中的全部日誌
任何屬性輸入它的名稱,例如 http.route: 或 customer.id:

篩選條件會變成搜尋框中的標籤。點選 × 即可移除。在篩選條件前加上 - 表示排除,例如 -level:debug。

依等級篩選

輸入 level: 開啟等級選擇器,它會顯示每個等級的日誌數量。按 空白鍵 多選,再按 Enter。兩個捷徑涵蓋常見情況:level:>=warn 保留警告及更嚴重的日誌,-level:debug 隱藏除錯雜訊。

顯示各等級數量和兩個捷徑的等級選擇器

搜尋框旁的 服務 按鈕是 service: 的捷徑。點選圖表上方的等級,可以開啟或關閉它。

搜尋語法

輸入找到
timeout包含該字詞的日誌
"connection pool"精確比對該片語
timeout retry同時包含兩個字詞,順序不拘
timeout OR refused包含任一字詞
-timeout 或 NOT timeout不包含該字詞的日誌
level:error service:api同時符合兩個篩選條件
(timeout OR refused) AND service:api用括號分組
service:"billing worker"含空格的值,加上引號

AND、OR 和 NOT 要大寫。如果搜尋無法解析,例如引號沒有關閉,瀏覽器會提示並保留先前的結果。

開啟搜尋框時會列出最近的搜尋,常用的搜尋按一下就能再次使用。

變更時間範圍

點選時間範圍按鈕,可選擇最近 15 分鐘到最近 7 天,或用 起始 和 結束 設定自訂範圍。

時間範圍選單,包含預設和自訂範圍

要放大某個高峰,在圖表上拖曳經過它。返回按鈕可回到先前的範圍。

查看日誌

點選一列,或用 ↑ ↓ 移到該列並按 Enter。詳細資訊面板會開啟,顯示:

  • 完整訊息,以及 複製訊息。
  • 類似日誌,用來搜尋類似的訊息。
  • 當日誌屬於某個請求時會顯示 此追蹤中的 N 筆日誌,列出該請求在所有服務中的每筆日誌。
  • 日誌的屬性及其資源(來源服務、主機和版本)。點選某個值可依它篩選、排除它或複製它。
在詳細資訊面板中開啟的錯誤日誌,顯示訊息、追蹤連結和屬性

面板頂端的箭頭可切換到上一筆和下一筆日誌。

即時查看

按 L 或點選 即時,即可在日誌抵達時即時查看。新日誌出現在最上方,標題列顯示每秒抵達的數量。搜尋和篩選條件仍然有效,因此即時模式下的 level:error 就是即時錯誤串流。

即時查看,新日誌持續湧入並顯示每秒速率

點選暫停按鈕或再按一次 L 即可停止。圖表會保持進入即時模式前的時間範圍。如果日誌抵達速度超過顯示速度,會出現提示:暫停並搜尋就能看到全部日誌。

匯出

用核取方塊勾選需要的日誌。清單上方會出現一列,包含 匯出 CSV、匯出 JSON 和 複製。

已選取三筆日誌,清單上方有匯出 CSV、匯出 JSON 和複製按鈕

搜尋列尾端的下載按鈕會將清單中已載入的所有日誌匯出為 CSV。匯出內容包含每筆日誌的時間、服務、等級和訊息。要取得日誌的屬性,請開啟該日誌並在詳細資訊面板中使用 複製為 JSON。

鍵盤快速鍵

按鍵功能
↓ ↑ 或 J K在日誌之間移動
Enter開啟選取的日誌
Esc關閉詳細資訊面板或選單
L開始或停止即時查看
Space在選擇器中多選