本文說明如何使用 Cloud Logging 記錄檢視器查看記錄。
事前準備
設定應用程式使用 Cloud Logging API。
登入帳戶以存取 Google Cloud 資源。
- 依序選取「工具」->「Google Cloud Tools」->「管理帳戶...」,即可選取帳戶。
存取記錄檔探索工具
如要存取 Cloud Logging Logs Explorer,請依序選取「Tools」->「Google Cloud Tools」->「Show Stackdriver Logs Explorer」。
系統會隨即開啟「Google Stackdriver Logging」分頁。
或者,您也可以透過 Google Cloud Explorer 針對特定專案開啟記錄檢視器,方法是依序選取「Tools」->「Google Cloud Tools」->「Google Cloud Explorer」。以滑鼠右鍵點選該專案,然後選取「Browse Stackdriver Logs」(瀏覽 Stackdriver 記錄)。
介面導覽
Logs Explorer 介面包含以下主要元件:
一個搜尋列,可用來根據標籤或文字搜尋內容篩選記錄項目。
數個下拉式選單,可用來依資源、記錄和嚴重性等級篩選清單。
[Jump to time] (跳到特定時間) 下拉式選單,可用來查看記錄中的特定日期與時間。
[Refresh] (重新整理) 按鈕,可用來擷取最新記錄 (從新到舊排序)。
[Auto load log stream] (自動載入記錄串流) 控制項,可用來決定是否要在新的記錄項目抵達時立即顯示。
按一下 [Play] (播放) 可啟動最新記錄串流。如果您捲動記錄顯示畫面,串流就會停止。
按一下 [Pause] (暫停) 可停止記錄串流。
記錄摘要表,可供您點選查看個別記錄項目的完整詳情。
記錄項目面板右上方有一個 [Expand all] (全部展開) 下拉式箭頭,點選即可顯示所有記錄項目的詳細資料。如果該面板含有大量記錄項目,這項操作可能需要一點時間。
一個來源連結 (如果有的話),可用來找出產生該記錄項目的原始碼。
瀏覽至原始碼
記錄檔瀏覽器可讓您瀏覽至產生記錄項目的原始碼。如要啟用這項功能,您必須透過本機 Git 存放區建構專案,並且在記錄項目中新增來源位置資訊。
為您的記錄新增來源位置
調整設定,讓您的應用程式在記錄中提供原始碼位置資訊:
使用以下來自 GitHub 的樣本,為記錄項目撰寫位置資訊。
在應用程式的根目錄部署
source_context.json
檔案。如果您透過 Cloud Tools for Visual Studio 發布解決方案,擴充功能會自動產生及部署該檔案。
完成上述步驟之後,記錄項目就會含有 sourceLocation 欄位,其中包含「File」(檔案) 和「Line」(資料行) 資訊。選用的「Function」(函式) 行可能含有組件名稱、版本或函式名稱。
按一下來源連結可瀏覽至原始碼 (如果原始檔案可供存取的話)。
查看記錄
在 Logs Explorer 介面中,您可以篩選記錄項目,或搜尋要顯示的特定記錄。
篩選記錄
您可以篩選記錄項目,讓系統只顯示您有興趣查看的記錄。
在資源類型和執行個體下拉式選單中,您可以選取要查看的特定資源類型的所有執行個體,或是查看特定執行個體。如需資源類型清單,請參閱「受控資源和服務」一文。
在記錄類型下拉式選單中,選取您想查看的已命名記錄,或選取 [All logs] (所有記錄)。該選單只會顯示所選資源產生的記錄。
在記錄嚴重性下拉式選單中,選取您想查看的嚴重性等級。如果選取 [All log levels] (所有記錄等級),則會納入沒有嚴重性等級的記錄項目。
在 [Jump to time] (跳到特定時間) 下拉式選單中,選取所需日期與時間。選擇您要查看在所選時間戳記之前或之後的記錄。
您也可以按一下 [To Advanced Filter] (進階篩選),以使用進階篩選器列,藉此透過查詢篩選記錄項目。如要瞭解詳情,請按一下「進階篩選器說明」連結。
搜尋記錄
在搜尋列中搜尋顯示在記錄項目中的關鍵字。
顯示類似記錄
您可在展開的記錄項目檢視畫面中按一下個別欄位的值,然後顯示或隱藏具有相同值的所有記錄項目。
顯示類似記錄項目時,系統會顯示進階篩選器列。請透過進階篩選器列編輯篩選器,然後按一下 [Submit Filters] (提交篩選器)。如要瞭解詳情,請按一下「進階篩選器說明」連結。