基本記錄篩選器

本指南說明如何在記錄檢視器基本篩選器介面中按標籤或文字搜尋內容篩選記錄項目。

如需更多進階記錄篩選選項,請參閱進階記錄篩選器一文。

如要匯出記錄項目,請參閱匯出記錄。如要透過 API 讀取記錄項目,請參閱 entries.list。 如要使用 SDK 讀取記錄項目,請參閱讀取記錄項目一文。

開始使用基本篩選器

  1. 前往 GCP 主控台的「Stackdriver Logging」>「Logs」(記錄) (「Logs Viewer」(記錄檢視器)) 頁面:

    前往「Logs Viewer」(記錄檢視器) 頁面

  2. 在頁面頂端選取現有 GCP 專案,或建立新專案。

  3. 使用下拉式選單,選取您要查看記錄的資源。

下列螢幕擷圖顯示了基本記錄篩選器介面。畫面上顯示 App Engine 應用程式的四個記錄項目,第二個項目已透過按下展開箭頭 (▸) 展開

記錄檢視器

基本記錄篩選器介面具有下列主要元件 (由以上螢幕擷圖中的紅色數字指示),其中一些元件也會出現在進階記錄篩選器介面中:

  1. 「視窗分頁標籤」可讓您選擇「Logs」(記錄) (記錄檢視器)、「Metrics」(指標) (請參閱記錄指標)、「Exports」(匯出項目) (請參閱匯出記錄) 與「Logs ingestion」(記錄檔擷取) (請參閱記錄排除一文)。
  2. 基本記錄篩選器介面中的「搜尋篩選器方塊」可讓您按標籤或文字搜尋內容篩選記錄項目。這裡顯示了基本記錄篩選器介面,位於最右側的下拉式箭頭 (▾) 可讓您切換至進階記錄篩選器介面或取得篩選器的連結。
  3. 「基本選取器選單」可讓您選擇要顯示的資源、記錄與嚴重性等級。
  4. 「時間範圍選取器」下拉式選單可讓您篩選記錄中的特定日期與時間。
  5. 頁面頂端的「串流選取器」可用來控制是否在新記錄項目抵達時顯示這些新記錄項目。
  6. 「記錄項目資料表」包含依據目前篩選器與自訂欄位而能使用的記錄項目。
  7. 每個記錄項目前方的「展開箭頭」(▸) 可讓您查看項目的完整內容。詳情請參閱展開記錄項目一文。
  8. 最右側的「View Options」(檢視選項) 選單會有其他顯示選項。
  9. 最右側的「Download logs」(下載記錄檔) 選單可讓您下載一組記錄項目。
  10. 針對每個記錄項目顯示的「更多」(⋮) 選項可讓您在記錄項目上放置一個圖釘、在其資源內容中顯示記錄項目,並將記錄項目的網址複製到剪貼簿。

最後,記錄檢視器會使用游標位置醒目顯示關聯的記錄項目,並在「更多」(⋮) 旁邊放置一個大頭針 (📌) 符號。

基本搜尋

在基本記錄篩選器介面中,在選單上方的搜尋篩選器方塊中輸入文字,然後按下 ENTER。搜尋會傳回在任何欄位 (timestamp 除外) 的任何位置包含搜尋字詞 (字母不區分大小寫) 的所有記錄項目。記錄檢視器在搜尋字詞前方加上 text: 一字,即表示將搜尋「所有欄位」。

以下是一些常見的搜尋,其中有一些無法達到您期望的目標。

常見基本搜尋範例

Unicorn (text:Unicorn)

尋找位於任何欄位中,以大寫或小寫包含 unicorn 的所有記錄項目。

unicorn phoenix (text:unicorn text:phoenix)

尋找位於相同或不同欄位中,包含 unicorn phoenix 的所有記錄項目。如需同時包含這兩個字詞的記錄項目,請使用進階記錄篩選器介面

"unicorn phoenix" (text:"unicorn phoenix")

尋找位於相同欄位中,包含 unicorn phoenix (字母不區分大小寫)、且以一個空格分隔的所有記錄項目。基本記錄篩選器介面不支援「在相同欄位的任何位置搜尋 unicornphoenix」,但是進階記錄篩選器介面支援此搜尋。

-unicorn (-text:unicorn)

尋找位於任何欄位中,包含 unicorn (字母不區分大小寫) 的所有記錄項目,並將這些記錄從顯示的項目中排除。基本記錄篩選器介面不支援在相同或不同欄位搜尋「-unicorn-phoenix」,但是進階記錄篩選器介面支援此搜尋。

2345 (text:2345)

尋找包含 2345 字串的所有記錄項目。記錄項目內的數字一般會表示為字串,因此這樣會找出例如 123456 這樣的結果。

無法達到期望目標的搜尋

uni* (text:uni*)
這不是萬用字元搜尋。此搜尋會尋找包含由 4 個字元組成的 "uni*" 字串的所有記錄項目。記錄檢視器不支援規則運算式搜尋,基本或進階記錄篩選器介面不提供特殊萬用字元,例如 *?
2017-02-05 (text:2017-02-05)
這不會比對記錄項目時間戳記。此搜尋會尋找任何欄位 (timestamp「除外」) 中包含 2017-02-05 字串的所有記錄項目。如果您的記錄項目酬載或其他欄位中包含日期字串,則可搜尋這些記錄項目。您也可以使用搜尋篩選器方塊下方的「Jump to date」(跳到日期) 選單。進階記錄篩選器介面可讓您使用指定時間戳記範圍的搜尋。
200..299 (text:200..299)
這不會比對 250。基本記錄篩選器介面搜尋會尋找包含由 8 個字元組成的 "200..299" 字串的記錄項目。這種範圍標記法只能在搜尋整數欄位時使用。請參閱搜尋特定欄位一文。
unicorn NOT phoenix (text:unicorn text:NOT text:phoenix)
unicorn OR phoenix (text:unicorn text:OR text:phoenix)
這些不是布林文字內容搜尋,因為基本記錄篩選器不支援在文字搜尋內容中加入布林運算子 (AND、OR、NOT 或 AND NOT)。如果您加入多個文字搜尋字詞,則字詞會由 or 隱含地連結。您可以使用 - (減號) 運算子取代布林 NOT 運算子。詳情請參閱常見基本搜尋範例一節。

搜尋特定欄位

您可在搜尋字詞之前加上欄位名稱與冒號來將搜尋限制於特定欄位。欄位名稱會在所有欄位搜尋中取代 text:。在搜尋篩選器方塊中輸入時,您會看見相符欄位的清單:

基本欄位搜尋{ class="screenshot" }

在以下範例中,status: 是整數 HTTP 狀態碼,path: 是要求中的 HTTP 路徑:

path:query
尋找 HTTP 路徑中包含大寫或小寫 query 的記錄項目;例如 /query/App/Query/17
path:*
尋找具有 path 欄位的記錄項目。這是星號 (*) 字元的特殊用法;一般不會將星號字元視為特殊字元。
status:200
查看狀態為 (必須是) 200 的記錄項目。搜尋不會比對例如 2000 的狀態。由於 status 已知是整數欄位,因此比較的是數字。
status:abc
無效,因為 status 已知包含整數。
status:400..499
尋找 HTTP 狀態為 400 至 499 的記錄項目。 範圍僅對已知包含整數的欄位有效。 如果您使用其他欄位的範圍,會將範圍解讀為包含 . 字元的單一字串。
path:query unicorn
尋找 path 欄位包含 query 在任何欄位中包含 unicorn 的記錄項目。由於 unicorn 前面沒有欄位名稱,因此這樣就跟您寫成 text:unicorn 的效果一樣。針對不同欄位或欄位與 text: 加入搜尋字詞時,字詞會由 and 隱含地連結。
path:query path:status
尋找 path 欄位包含 query status 的記錄項目。 針對相同欄位包含多個搜尋字詞時,這些字詞由 or 自動連結。
path:query status:200 path:status status:500..502
尋找路徑包含 query status status 值為 200、500、501 502 的記錄項目。 換句話說,or 的繫結緊密程度比 and 高,而且搜尋字詞的順序無關緊要。

疑難排解

如果您不確定為什麼基本記錄篩選器介面中的搜尋會失敗,請切換至進階記錄篩選器介面

  1. 使用搜尋篩選器方塊最右側的下拉式箭頭 (▾),選取 [Convert to advanced filter] (轉換為進階篩選器)

  2. 查看搜尋篩選器方塊,看看能否成功搜尋。

  3. 使用瀏覽器的「上一頁」按鈕返回基本記錄篩選器介面。選取此選項後,系統會將您帶回您先前在基本記錄篩選器介面中選取的選項。

  4. 如果您在步驟 2 中發現非預期的篩選器,可在搜尋篩選器方塊、基本選取器選單或時間範圍選取器選單中,變更或清除這些篩選器。

如果您看不見期望的所有記錄項目,以下是其他一些可能的原因:

  • 您看不見早於 Stackdriver Logging 保留期限的記錄項目。如需瞭解生效的記錄保留期限,請參閱記錄保留期限一文。

  • 在負載量大的期間,將記錄傳送至 Stackdriver Logging 或接收及顯示記錄方面可能會發生延遲。

  • 在目前時間「趕上」時間戳記位於未來的記錄項目之前,記錄檢視器不會顯示這些項目。這是比較少見的情況,可能是因傳送記錄的應用程式發生時間偏移所導致。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Stackdriver Logging
需要協助嗎?請前往我們的支援網頁