查看記錄

本指南說明如何使用記錄檢視器搜尋記錄及查看記錄項目。

  • 如要透過 Stackdriver Logging API 讀取記錄項目,請參閱 entries.list 的說明。
  • 如要使用 Cloud SDK 讀取記錄項目,請參閱讀取記錄項目一文。

事前準備

除非您要將記錄從 Amazon Web Services (AWS) 傳送至 Logging,否則您不須有工作區就可以使用 Stackdriver Logging。

記錄檢視器會顯示單一 Google Cloud Platform 專案的記錄。如果您使用工作區,Logging 不會合併來自受監控專案的記錄。您必須選取特定專案才能查看其記錄。

如果您使用工作區與 AWS,請選取 AWS 連接器專案查看 AWS 記錄。

開始使用

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

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

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

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

如果看不到任何記錄,請參閱以下的疑難排解一節。

記錄檢視器的篩選器介面

記錄檢視器中有兩個篩選介面:

  • 基本篩選器介面可讓您從選單中選取記錄檔,並提供基本的搜尋功能。
  • 進階篩選器介面可讓您查看多個記錄檔中的記錄項目,並提供進階的搜尋功能。

在任一介面中,您都可以使用搜尋篩選器方塊最右側的下拉式箭頭 (▾) 切換這兩個介面。

下列螢幕擷圖顯示記錄檢視器的基本篩選器介面版面配置。這個螢幕擷圖顯示來自 App Engine 應用程式的記錄項目:

記錄檢視器

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

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

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

捲動與串流記錄

當您初次開啟記錄檢視器時,會看見足以填滿畫面的最近記錄項目。當您捲動記錄項目時,記錄檢視器會嘗試擷取其他項目。記錄上方與下方的黃色列可讓您瞭解是否還有更多記錄項目。

畫面頂端的圖示可控制何時重新整理記錄:

  • 按一下「重新整理」圖示 (refresh),可擷取最新記錄並捲動畫面顯示這些記錄。
  • 按一下「播放」圖示 (play_arrow),可串流最新記錄。如果您選取記錄項目或捲動記錄顯示畫面,串流就會停止。
  • 按一下「暫停」圖示 (pause) 可停止串流。

捲動至指定時間

您可以使用搜尋篩選器方塊下方的「時間範圍選取器」選單,按時間與日期篩選記錄項目。

時間範圍選取器

預設選取項為 [Last hour] (過去 1 小時)。您可以使用下拉式選單選取其他時間範圍,或定義一個範圍:

  • 選取 [Jump to time] (跳到指定時間) 可篩選出特定日期與時間的記錄。
  • 選取 [Custom] (自訂) 可指定自訂範圍或時區。

如要顯示目前的記錄項目,請點選 [Jump to now] (跳到現在時間)

只要選取了新的設定,記錄檢視器一律會重新整理顯示畫面。然後您可以捲動並檢查顯示的記錄項目。

如要將日期與時間重設為與最近收到的記錄項目對應,請按一下「重新整理」或「播放」圖示。

變更時區

您可以選取記錄項目的時區:

  1. 從「Last hour」(過去 1 小時) 下拉式選單中,選取 [Custom] (自訂)
  2. 在任意一個新選單中按一下展開箭頭 (▾),開啟下拉式日曆。
  3. 在「Time Zone」(時區) 窗格中,選取您偏好的國家/地區與時區。

設定完成後,記錄檢視器會重新整理顯示畫面,並更新每個記錄項目的時區:

自訂時區

展開記錄項目

預設情況下,記錄項目資料表會為每個記錄項目顯示一個摘要行。

記錄項目摘要行

記錄項目摘要行可能包含醒目顯示的欄位。例如,自訂欄位處於醒目顯示狀態。

包含在摘要行中的欄位選取做為記錄項目欄位的子集。系統預設會顯示特定欄位,前提是這些欄位符合以下一或多個條件:

  • 記錄項目具有廣為人知的類型,例如 App Engine 要求記錄。
  • 記錄項目包含 httpRequest 欄位。
  • 記錄項目的酬載包含名為 message 的欄位。

如要查看一個記錄項目的完整詳細資料,請按一下摘要行前方的展開箭頭 (▸)。如要針對目前篩選器篩選出的所有記錄項目,以階層式檢視畫面查看完整詳細資料,請按一下最右側的 [View Options] (檢視選項) 選單,然後選取 [Expand All] (全部展開)

檢視選項選單

您可以選取 [Collapse All] (全部收合) 以收合任何展開的記錄項目詳細資料。

當您展開記錄項目的摘要行時,記錄檢視器會以階層式 (JSON) 表示法顯示:

結構化要求記錄項目

如需記錄項目中欄位的說明,請參閱 LogEntry 類型。

新增自訂欄位

自訂欄位是記錄項目內的欄位,您可將這些欄位指定為包含在摘要行中。每當記錄項目中有自訂欄位時,就會填入這些自訂欄位並以藍色醒目顯示。

摘要行中的自訂欄位

有兩種方法可以將自訂欄位新增至記錄項目資料表摘要行中:

  • 展開的記錄項目中,按一下 JSON 表示法內的欄位。在結果面板中,選取 [Add field to summary line] (在摘要行中新增欄位)

在摘要行中新增欄位

  • 從記錄檢視器最右側的「Viewing Options」(檢視選項) 選單中,選取 [Add custom fields] (新增自訂欄位) (如果您在此專案中具有現有自訂欄位,此選項將為 [Modify custom fields] (修改自訂欄位))。在結果面板中,新增所需的 JSON 金鑰並按一下 [Save] (儲存)。新增多個金鑰時,可以用逗號分隔這些金鑰。如要重新排序自訂欄位在摘要行中的外觀,請在此面板中重新排序文字,並按一下 [Save] (儲存)

將 JSON 欄位新增至摘要行

有 2 種方法可以從記錄項目資料表摘要行中移除自訂欄位:

  • 從列出您要移除之自訂欄位的任何摘要行中,按一下欄位並選取 [Remove field from summary line] (從摘要行中移除欄位)
  • 從記錄檢視器最右上方的「Viewing Options」(檢視選項) 選單中選取 [Modify custom fields] (修改自訂欄位)。在結果面板中,刪除您要移除的 JSON 金鑰並按一下 [Save] (儲存)

只要您正在使用目前的網址,或位於相同的瀏覽器工作階段內,自訂欄位就會新增至該網址並保留下來。您無法在通用層級設定這些欄位,也無法針對每位使用者或每個 GCP 專案儲存這些欄位。

您無法從記錄項目資料表中移除預設欄位。

釘選記錄項目

如果您已識別感興趣的記錄項目且想調查附近的項目,可以在記錄項目上放置一個圖釘。釘選記錄項目之後,您可以變更篩選器,記錄檢視器會自動圍繞釘選的項目執行搜尋。釘選可讓您檢查您定義的篩選器所指定內容中的記錄項目。釘選記錄之後,其背景會變更並顯示一個圖釘:

釘選的記錄項目

如要釘選記錄項目,請按一下其圖釘,或按一下「更多」(⋮) 並選取 [Pin this log entry] (釘選這個記錄項目)

在記錄項目上放置圖釘之後,只有您能夠看到這個圖釘。查看相同記錄項目的其他任何使用者都看不到您的圖釘或以任何方式修改其視圖。

釘選記錄項目並不會變更篩選器介面、篩選器設定,也不會重新整理顯示的內容。您可以決定篩選器設定,及重新整理記錄檢視器顯示畫面的時間。您可以根據需要多次修改篩選器設定及重新整理顯示畫面,而不會對釘選造成影響。

若目前已啟用串流,釘選記錄項目會停止串流。

如果已釘選記錄項目,您可以移動或移除圖釘:

  • 如要將圖釘移至其他記錄項目,請按一下新記錄項目的圖釘圖示,或按一下「更多」(⋮) 並選取 [Move pin to this log entry] (將圖釘移至這個記錄項目)

  • 如要移除記錄項目的圖釘,請按一下其圖釘符號,或按一下「更多」(⋮) 並選取 [Remove pin from this log entry] (取消釘選這個記錄項目)

如果您在釘選記錄項目時啟用串流,記錄檢視器會移除圖釘。

顯示類似記錄

您可在展開的記錄項目檢視畫面中按一下個別欄位的值,然後顯示或隱藏具有相同值的所有記錄項目:

顯示相符的項目

進行這項操作時,記錄檢視器會變更為進階篩選器介面。如要修改搜尋,請編輯篩選器,並按一下 [Submit Filter] (提交篩選器)。詳情請參閱進階篩選器介面一文。

此外,您可以建立 App Engine 要求記錄項目之間的關聯,然後以巢狀結構查看這些項目。詳情請參閱查看相關的要求記錄項目一文並選取您的執行階段語言。

顯示詳細的延遲資料

全新 針對 App Engine 要求記錄,記錄檢視器可提供 Stackdriver Trace 的連結,以便輕鬆查看記錄項目詳細的延遲資料。

如要顯示某個記錄項目延遲相關選項的選單,請找到 protoPayload.latency 欄位:

顯示 protoPayload.latency

按一下延遲時間值:

顯示延遲時間選項

選單中的前兩個選項會限制記錄項目,只顯示延遲時間較短或較長的項目。選單中最後一個選項,會將記錄項目限定為包含 Stackdriver Trace 可查看的追蹤記錄詳細資料。具體而言,最後一個選項將記錄項目限定在已啟用「View trace details」 (查看追蹤記錄詳細資料) 的項目。

在 Stackdriver Trace 查看詳細的延遲資料

針對特定的 App Engine 要求記錄,「View trace details」 (查看追蹤記錄詳細資料) 選項已啟用。啟用這項功能後,按一下這個選項可開啟 Stackdriver Trace 並顯示記錄項目詳細的延遲資料:

顯示追蹤時間軸

在資源內容中顯示

如果您已識別感興趣的記錄項目,且想識別與相同資源類型關聯的其他記錄項目,請按一下該行最右側的「更多」(⋮),並選取 [Show in resource context] (在資源內容中顯示) 選項:

顯示內容

針對您的動作,記錄檢視器會做出以下回應:

  1. 釘選記錄項目
  2. 切換至進階篩選器介面,並將篩選器內容取代為對資源類型的篩選。
  3. 重新整理顯示畫面。釘選的記錄項目會顯示在顯示畫面底部。

顯示在內容中

共用記錄項目

如要共用記錄項目,請按一下「更多」(⋮),並選取 [Copy link to log entry to clipboard] (將記錄項目的連結複製到剪貼簿)。這個動作會使記錄檢視器產生記錄項目的專屬網址,並將該網址複製到剪貼簿中。

選取記錄

使用選單與搜尋篩選器方塊尋找您想查看的記錄:

  • 選取您要查看記錄的資源類型與執行個體。您可以查看此資源類型的所有執行個體,或選取特定執行個體。在以上螢幕擷取畫面中,選取了 [G​C​E VM instance] (G​C​E VM 執行個體) (所有執行個體)。如需資源類型的清單,請參閱受控資源清單一文。

  • 從第二個選單中選取您要查看的已命名記錄,或選取 [All logs] (所有記錄)。選單會顯示正由選取的資源執行個體使用的記錄。

  • 在第三個選單中選取您要查看的最低嚴重性等級。選取 [Any log level] (任何記錄層級) 也會顯示未獲指派嚴重性的記錄項目。

  • 從第四個選單中選取您要查看的時間範圍,或從第五個選單中選取 [Jump to now] (跳到現在時間)

當您變更選單選項時,您會看見相符的記錄項目。

選單注意事項

  • 只有存在於專案中的資源類型、執行個體與記錄名稱才會顯示在選單中。新增資源類型或執行個體,或者寫入新記錄之後,可能需要花一點時間等選單更新。

  • 在基本記錄篩選器介面中,您可以一次只從一個資源類型中查看記錄項目。進階篩選器介面允許使用多個資源類型。

  • 如果您瀏覽至目前保留期間之前的時間,您將看不見任何記錄。詳情請參閱記錄保留期限

下載記錄項目

您只需要按幾下滑鼠,就能夠下載儲存在記錄檢視器工作記憶體中所有 JSON 或 CSV 格式的記錄項目。由於效能因素,記錄檢視器會嘗試一次載入 100 個記錄項目,並在其工作記憶體中保留不超過 300 個記錄項目。這些值皆無法設定。

如要下載記錄項目,按一下位在記錄檢視器最右上方的 [Download logs] (下載記錄檔) 選單。在下載對話方塊中,選取 JSON 或 CSV 的「Log entry format」 (記錄項目格式),然後點選 [Download] (下載)

顯示下載詳細資訊

如要在網頁上查看 JSON 或 CSV 格式的記錄項目,您可依循上述的下載步驟,但請選取 [View In New Tab] (在新分頁中查看)

使用記錄檢視器搜尋

在基本與進階篩選器介面中,您都可以使用篩選器進一步縮小搜尋範圍。進階篩選器介面包含的功能大多與基本記錄篩選器介面相同,但具有更進階的搜尋功能。

基本與進階篩選器之間的差異

基本記錄篩選器介面與進階記錄篩選器介面的語法不同。基本記錄篩選器介面根據假設建構而成,例如所有搜尋都不區分大小寫,不過這不適用於進階篩選器介面。

以下幾節說明這兩個介面語法方面的主要差異。

關鍵字「text:」

記錄檢視器會在文字前加上 text: 標籤,以在基本篩選器中顯示文字搜尋。請勿將 text: 標籤與進階篩選器搭配使用。

下表列出了相等的文字搜尋:

記錄檢視器基本篩選器 意義相同的進階記錄篩選器
text:"one two" "one two"
text:three three
text:n=5 "n=5" (需要引號)

如果您在進階篩選器中意外使用 text:,會在名為 text 的欄位中搜尋相符項目,但這個欄位並不存在。

欄位名稱

基本記錄篩選器介面擁有某些記錄的內建欄位名稱,包括 App Engine 要求記錄。進階篩選器中不存在這些欄位名稱。

下表列出了 App Engine 要求記錄的相等欄位搜尋:

基本篩選器 進階篩選器
querystring:var=3 protoPayload.resource:"var=3"
status:400..405 protoPayload.status >= 400 AND protoPayload.status <= 405

如果您在進階篩選器中使用 querystring:var=3,會搜尋名為 querystring 的欄位,但這個欄位並不存在。因此,記錄檢視器找不到任何相符的記錄項目。

子字串比對

在基本記錄篩選器介面中,所有搜尋都是不區分大小寫的子字串比對。也就是說,text:abcsomefieldname:abc 搜尋會比對包含 abcxyabcyxABc 的記錄項目。在進階記錄篩選器中,您必須針對相同的行為使用「has」搜尋運算子 (:)。

對於完全符合的情況,請使用等號運算子 (=)。field=abc 比較須在 field 中一字不差地包含 abc,大小寫都可以。該搜尋無法在基本記錄篩選器介面中表示。

AND 與 OR

在基本記錄篩選器介面中,使用相同欄位名稱的兩個比較 (或 text:) 會隱含地與 OR 結合,而含有不同標籤的比較則會由 AND 結合。在進階記錄篩選器中,除非明確指定 OR,否則所有比較都由 AND 結合。您也可以使用圓括號對比較進行分組。下表列出了兩個篩選器介面中的相等搜尋:

基本篩選器搜尋 進階篩選器搜尋
text:abc querystring:def text:xyz protoPayload.resource:"def" AND ("abc" OR "xyz")

搜尋效能

以下是增強搜尋效能的一些提示:

  • 請搜尋已建立索引之欄位的特定值,例如記錄項目的名稱、資源類型與資源標籤。您可在基本記錄篩選器介面中透過選單選項來執行此操作。請在進階篩選器介面中使用類似以下的條件:

    resource.type = "gce_instance"
    logName = "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity"
    resource.labels.module_id="default"
    resource.labels.instance_id="1234567890"
    
  • 請選擇完全相符,而非子字串搜尋。特別是對於索引欄位而言,部分相符的速度較慢。在基本記錄篩選器介面中,所有文字搜尋都是部分相符。在進階記錄篩選器介面中,請使用等號運算子 (=) 進行測試,而不要使用「has」(:) 進行測試。

  • 請縮短搜尋的時間。您無法在基本篩選器介面中進行這項動作,但可在進階篩選器介面中指定時間範圍:

    timestamp >= "2016-11-29T23:00:00Z" AND timestamp <= "2016-11-29T23:30:00Z"
    

如要進一步瞭解效能,請參閱快速尋找記錄項目一文。

疑難排解

如果您在與記錄檢視器互動,或使用記錄檢視器搜尋時遇到問題,本節提供了疑難排解常見問題的操作說明。

GCP 專案選項

如要從 Google Cloud Platform 主控台的任何位置 (包括記錄檢視器) 選取一個 GCP 專案,請使用頁面頂端的專案選取器:

GCP 主控台專案選取器

GCP 專案 ID

如要從 Google Cloud Platform 主控台的任何位置 (包括記錄檢視器) 擷取 GCP 專案 ID,請展開頁面頂端的專案清單,並查看「ID」資料欄:

GCP 主控台專案 ID 資訊

找不到任何記錄!

如果您找不到任何記錄,請檢查以下幾點:

  • 是否在頁面頂端選取了正確的專案? 如否,請使用頁面頂端的下拉式選單選取專案。您必須選取您要查看記錄的專案。

  • 您的專案是否有任何活動? 即使專案是新的,也應有活動或稽核記錄,記錄專案建立的項目。您可以完成快速入門導覽課程以取得更多記錄的相關資訊。

  • 時間範圍是否太小? 您可以使用搜尋篩選器方塊下方的下拉式選單選取其他時間範圍,或定義 [Custom] (自訂) 範圍。選取 [Jump to time] (跳到指定時間) 可篩選出特定日期與時間的記錄,或可使用 [Jump to now] (跳到現在時間) 選單查看目前的記錄項目。

  • 時間範圍是否正確? 編寫時間戳記篩選器時,您必須在搜尋篩選器方塊下方的時間範圍選取器中選取 [No Limit] (無限制)

我的搜尋失敗!

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

  1. 選取搜尋篩選器方塊尾端 &blacktriangledown; 選單中的 [Convert to advanced filter] (轉換為進階篩選器)
  2. 查看進階篩選器,看看能否成功搜尋。
  3. 使用瀏覽器的「上一頁」按鈕返回基本記錄篩選器介面。

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

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

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

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

後續步驟

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

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

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