您可以在 Cloud Monitoring 自訂資訊主頁中新增記錄和錯誤小工具，與指標資料一併查看記錄項目和錯誤群組。記錄面板小工具會顯示記錄項目，錯誤報告面板小工具則會顯示最近的錯誤群組。如要找出記錄資料的趨勢，您也可以新增 Observability Analytics 圖表小工具，顯示 SQL 查詢結果。
這項功能僅支援 Google Cloud 專案。 如要進行 App Hub 設定，請選取 App Hub 主專案或管理專案。
Logs Explorer 和記錄面板小工具
Logs Explorer是調查記錄的標準方式。在資訊主頁中新增記錄面板小工具，不會改變您使用 Logs Explorer 的方式。由於記錄面板小工具可以新增至自訂資訊主頁，因此您可以在與指標相同的環境中查看記錄項目。
Logs Explorer 和記錄檔面板小工具支援相同的查詢語言，且只會顯示您有權檢視的記錄項目。您在儲存記錄檔項目的資源中擁有的 Identity and Access Management (IAM) 角色，會決定您是否可以查看儲存的記錄檔項目。
Logs Explorer 和記錄面板小工具都已預先設定，可搜尋預設記錄範圍中列出的資源，找出記錄項目。如果無法存取該範圍，系統會搜尋所選專案產生的記錄項目。如果選取專案，搜尋結果會包含由其他專案中的接收器轉送至該專案，然後儲存在記錄檔 bucket 中的記錄項目。您可以設定要搜尋哪些資源的記錄項目。舉例來說，您可以依記錄檢視畫面搜尋記錄項目。
記錄面板小工具每列會顯示一個記錄項目，並提供嚴重性、時間戳記和記錄項目摘要等欄位。如要查看記錄項目的 JSON 格式表示法，請按一下「查看記錄詳細資料」按鈕。每個項目摘要的結構會因記錄類型而異。舉例來說，下圖顯示兩個記錄項目：
在上圖中，第一個記錄項目會顯示服務要求的相關資訊。摘要會顯示服務、電子郵件地址，以及項目的 JSON 結構字串格式版本。第二個項目會顯示要求結果，且只會顯示總結所發生動作的句子。
如需 Cloud Logging 的一般資訊，請參閱下列資源：
事前準備
如要取得所需權限，以便使用 Google Cloud 控制台將記錄面板小工具新增至自訂資訊主頁，並設定顯示專案或記錄檢視區中的記錄項目，請要求管理員授予您下列 IAM 角色：
- Monitoring 編輯者 (
roles/monitoring.editor) 專案。 - 記錄檢視器 (
roles/logging.viewer) 在每個要查看記錄項目的專案中，這個角色無法存取所有記錄項目。如要進一步瞭解角色，請參閱「使用 IAM 控管 Cloud Logging 存取權」。 - 記錄檔檢視存取者 (
roles/logging.viewAccessor) 在每個專案上，儲存您要存取的記錄檢視區記錄 bucket。 「記錄檢視存取者」角色可授予專案儲存的所有記錄檢視畫面存取權。如要瞭解如何取得特定記錄檢視畫面的存取權，請參閱「控管記錄檢視畫面的存取權」。
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。
在資訊主頁上顯示記錄項目
本節說明如何使用 Google Cloud 控制台新增及設定記錄面板小工具。如要瞭解如何使用 Cloud Monitoring API，請參閱「含有 LogsPanel 小工具的資訊主頁」。
資訊主頁最多可放置 100 個小工具。
如要使用控制台將記錄面板小工具新增至資訊主頁，請執行下列操作：
-
在 Google Cloud 控制台中，前往「Dashboards」(資訊主頁) 頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或管理專案。
- 選取資訊主頁或按一下「建立資訊主頁」。
- 按一下工具列中的「新增小工具」add。
- 在「新增小工具」對話方塊中，選取「記錄」
。 - 選用：如要更新標題，請在「小工具標題」欄位中輸入新標題。
設定要搜尋記錄項目的資源：
如要依專案搜尋，請將「Scope by」(依範圍) 項目設為「Project」(專案)，然後展開「Projects」(專案) 項目並完成對話方塊。
「專案」選單會列出目前指標範圍中的所有專案。 Google Cloud 如果選單中的項目包含「您沒有專案層級的權限，無法查看這項專案中的記錄」文字，表示您沒有查看該專案可用記錄項目的必要權限。 Google Cloud
顯示的記錄項目包括源自您Google Cloud 專案的項目，以及由其他專案中的接收器轉送至您Google Cloud 專案的項目。
如要依記錄 bucket 中的記錄檢視畫面搜尋記錄項目，請將「Scope by」(依範圍) 項目設為「Storage」(儲存空間)，然後展開「Storage views」(儲存空間檢視畫面) 項目並完成對話方塊。
「儲存空間檢視」選單會列出所選 Google Cloud 專案中記錄 bucket 的記錄檢視。
如要在其他 Google Cloud 專案的記錄 bucket 中選取記錄檢視，請依序點選選單中的 add_circle「匯入專案」、選取專案，然後選取一或多個記錄檢視。您只能匯入目前指標範圍內的專案。
如要搜尋記錄範圍中包含的資源 (可能包括專案和記錄檢視)，請將「Scope by」(範圍依據) 項目設為「Logs Scope」(記錄範圍)，然後展開「Log Scopes」(記錄範圍) 項目並選取記錄範圍。
選用：如要限制記錄面板小工具顯示的記錄，請在「Query Editor」(查詢編輯器) 欄位中輸入查詢，然後按一下「Run query」(執行查詢) (如果您已停用自動執行查詢)。如需查詢的簡短簡介，請參閱「查詢範例」。
查詢最多可包含 2,000 個半形字元。
選用步驟：更新小工具的查詢或設定，使其依附變數。變更變數值時，小工具也會更新。如需語法和其他資訊，請參閱「在查詢中新增變數」。
如要將變更套用至資訊主頁，請在工具列中按一下「套用」。如要捨棄變更，請按一下「取消」。
如要儲存修改後的資訊主頁，請點按工具列中的「儲存」。
記錄面板小工具會顯示記錄項目表格。 你也可以使用小工具的篩選列，暫時變更小工具顯示的記錄項目。詳情請參閱「篩選記錄項目」一節。
查詢範例
如要填入「Query Editor」(查詢編輯器) 欄位，請在欄位中輸入文字，或從選單中選取項目。「查詢編輯器」欄位使用的查詢語言與「Logs Explorer」相同。如需疑難排解資訊，請參閱「語法問題」。
您可以在「嚴重性」和「記錄檔名稱」選單中選取多個選項。 以下是查詢陳述式的範例，可比對多個嚴重程度：
severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)
「資源」選單可讓您依資源篩選。您可以選取資源類型，例如「已稽核的資源」，也可以瀏覽選單來選取特定方法。
舉例來說，如要新增「已稽核的資源」查詢，請按照下列步驟操作：
- 展開「資源」選單。
- 搜尋並選取「Audited Resource」。
按一下「套用」。
這些步驟會在「查詢編輯器」欄位中加入下列子句：
resource.type="audited_resource"
同樣地，如要新增 Cloud Run functions 稽核記錄的查詢，請按照下列步驟操作：
- 展開「資源」選單。
- 搜尋並選取「Audited Resource」。
- 在服務選單中，選取「Cloud Functions」。
按一下「套用」。
這些步驟會在「查詢編輯器」欄位中加入下列子句：
resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"
在查詢中新增變數
您可以在查詢或記錄面板小工具的其他欄位中使用變數。變更變數值時，小工具顯示的資料也會隨之變更。
如要在查詢中新增變數，請按照下列步驟操作：
建立變數。 在 Google Cloud 控制台中，您可以使用資訊主頁的「設定」settings選項建立、編輯及查看變數。您也可以使用 Cloud Monitoring API。
如要將變數套用至查詢，請使用下列其中一種形式：
- 如果是以標籤為基礎的變數，請使用
${label_based_variable.value}。 - 如果是以值為準的變數，請使用
${value_based_variable}。
舉例來說，假設您建立僅含值的變數
value_only_severity_variable，並將其設定為具有下列其中一個值：ERROR、INFO和NOTICE。您也會在查詢中加入下列陳述式：severity =~ "${value_only_severity_variable}"以下說明表單的算繪方式：
severity =~ "^(ERROR|INFO|NOTICE)$"如要進一步瞭解變數，以及如何將變數套用至記錄面板小工具或其他小工具，請參閱「更新小工具的查詢」。
- 如果是以標籤為基礎的變數，請使用
如要瞭解如何使用變數顯示或隱藏小工具，請參閱「設定小工具的顯示設定」。
篩選記錄項目
如要修改記錄面板小工具顯示的記錄項目，請修改下列欄位或選單的值：
資訊主頁時間選取器：根據預設，記錄面板小工具只會擷取在這個欄位指定的間隔內寫入的記錄項目。如要使用其他間隔，請套用包含
timestamp子句的篩選器。記錄面板小工具不支援時間範圍覆寫。記錄檔面板小工具的「篩選器」欄位：指定的篩選器會在查詢完成後套用。這個欄位的值只會保留到目前的工作階段。
記錄面板小工具的「嚴重程度」選單：查詢完成後，系統會套用依嚴重程度篩選的條件。這個欄位的值只會保留到目前的工作階段。
記錄檔面板小工具的查詢：記錄檔面板小工具只會顯示符合查詢的記錄項目。如未指定查詢，系統會顯示所選時間間隔內的所有記錄。如果您指定查詢，記錄檔面板小工具會顯示「顯示查詢」圖示，以工具提示的形式顯示目前查詢。
如要修改查詢，請編輯記錄面板小工具。
Google Cloud 記錄面板小工具中的專案：如要修改這項設定，請 編輯記錄面板小工具。
資訊主頁篩選器：如果資訊主頁篩選器存在，篩選器設定會套用至記錄面板小工具的查詢。舉例來說，如果您新增 cluster_name: mycluster 的資訊主頁篩選器，查詢就會更新為包含 resource.labels."cluster_name"="mycluster"。如要進一步瞭解資訊主頁篩選器，請參閱「新增臨時篩選條件」和「新增永久篩選條件」。
本節的其餘部分將進一步說明如何篩選記錄檔項目。
範例：依日期篩選記錄項目
如要在記錄面板小工具中顯示最新記錄，請使用資訊主頁工具列中的時間欄位。舉例來說，您可以將工具列的時間範圍選取器設為 1H。只要您未選取自訂時間範圍，小工具一律會顯示最新的記錄，即使記錄早於所選時間範圍也一樣。
調查快訊時，您可能只想查看特定時間間隔內的記錄項目。如要設定記錄項目，只顯示固定時間間隔內的記錄，請執行下列一或多項操作：
- 使用時間範圍選取器選取時間範圍。
- 在設定窗格的「Query Editor」(查詢編輯器) 欄位中輸入
timestamp子句，然後選取「Apply filter」(套用篩選器)。
指定時間間隔後，記錄面板小工具不會自動重新整理。
範例：依嚴重性篩選記錄項目
偵錯失敗情況時，您可能只想查看錯誤訊息，並隱藏顯示的所有其他記錄項目。如要設定記錄檔面板小工具，只顯示符合特定嚴重程度的記錄項目，請執行下列一或多項操作：
如要套用暫時性篩選器，請在記錄面板小工具中，選取「嚴重程度」選單的值。這個選單會指定最低嚴重性等級。舉例來說，如果值為「Warning」，系統會擷取嚴重程度為「Error」的記錄檔項目，但不會擷取嚴重程度為「Notice」的記錄檔項目。根據預設，這個欄位的值會設為
Default，其中包含所有記錄項目。離開資訊主頁後，系統會捨棄「嚴重性」選單的設定。
如要套用永久篩選器，請在設定窗格的「查詢編輯器」欄位中輸入
severity子句，然後選取「套用篩選器」。
範例：依字串或詞組篩選記錄項目
依特定字串或詞組篩選記錄項目，即可從檢視畫面中排除不感興趣的記錄項目。舉例來說，如要查看包含特定電子郵件地址的記錄項目，可以依該地址篩選。
如要套用臨時篩選器，只查看含有特定字詞或詞組的記錄項目，請使用「篩選器」filter_list欄位。contains 測試不區分大小寫。
如果您新增多個篩選器，系統只會顯示符合所有篩選條件的記錄檔，因為相鄰篩選器之間會插入隱含的
AND。不過，您可以明確插入OR運算子：舉例來說，如果您新增
Get和Compute篩選器，系統就會顯示同時包含這兩個字詞的記錄項目。舉例來說，如果您新增
Get、OR和Compute篩選器，系統就會顯示含有Get或Compute的記錄項目。
filter_list「篩選器」欄位的值不會保留。
如要套用永久篩選器，請修改「查詢編輯器」欄位中儲存的查詢，然後選取「套用篩選器」。 如要瞭解查詢語法，請參閱「Logging 查詢語言」。
舉例來說，如要只顯示
MESSAGE欄位值包含「lamp」字串的記錄項目，請在「Query Editor」(查詢編輯器) 欄位中新增jsonPayload.MESSAGE:"lamp"子句。
在 Logs Explorer 中查看記錄項目
記錄面板小工具會顯示記錄項目的重要欄位，但不會顯示完整的記錄項目。如要檢查記錄項目的所有欄位，請按照下列步驟操作：
- 在記錄面板小工具中，選取「在 Logs Explorer 查看」。
在對話方塊中，選取要開啟 Logs Explorer 的 Google Cloud 專案。
系統會在新的瀏覽器分頁中開啟 Logs Explorer，並自動套用您在記錄檔面板小工具中選取的篩選器。
選取要查看的記錄項目。
顯示從 Observability Analytics 查詢產生的圖表
本節說明如何設定及儲存從 Observability Analytics 查詢產生的圖表，並將其儲存至自訂資訊主頁。Observability Analytics 可讓您使用 SQL 查詢搜尋及匯總記錄，產生實用的洞察資料。
除了使用 Observability Analytics 頁面設定圖表並將圖表儲存至資訊主頁，您也可以直接在「監控」中儲存 Observability Analytics 圖表，方法如下：
-
在 Google Cloud 控制台中，前往「Dashboards」(資訊主頁) 頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或管理專案。
- 選取資訊主頁或按一下「建立資訊主頁」。
- 按一下工具列中的「新增小工具」add。
- 在「新增小工具」對話方塊中，前往「資料」部分，然後選取「可觀測性分析」。
在「設定小工具」對話方塊中，設定要顯示的資料，然後按一下「執行查詢」。
如要選取要顯示的資料，您可以建立 SQL 查詢，也可以選取已儲存或最近的查詢。可查詢的記錄檢視畫面和分析檢視畫面會列在「檢視畫面和結構定義」部分。按一下資料來源，即可在「結構定義」標題下方查看該資料來源的欄位清單。
選用：在「結果」分頁中，使用「顯示」面板自訂圖表設定。
在「顯示」面板中，您可以變更圖表類型，並透過變更維度、測量指標和細目，自訂要繪製哪些資料列和資料欄的圖表：
維度： 維度必須是時間戳記、數字或字串資料欄。根據預設，維度會設為結構定義中第一個以時間戳記為準的資料欄。如果查詢中沒有時間戳記，系統會選取第一個字串資料欄做為維度。您也可以在「圖表顯示」面板中自訂維度。如果選取時間戳記資料欄做為維度，圖表就會顯示資料隨時間變化的情形。如果選取字串資料欄做為長條圖的維度，您可以遞增或遞減排序資料，維度會依字典順序排序。您也可以保留 `default` 排序順序，根據相應指標的值，以遞減順序排序維度。
指標： 您可以在「圖表顯示」面板中選取多個指標。選取指標時，您也必須選取要對其分組值執行的匯總函式，例如
count、sum、average和percentile-99。舉例來說，count-distinct會傳回指定資料欄中的不重複值數量。細項分析： 如要根據其他資料欄將單一資料序列分割為多個資料序列，請新增細項分析。
如要進一步瞭解如何自訂圖表設定，請參閱「自訂圖表設定」。
如要儲存修改後的資訊主頁，請點按工具列中的「儲存」。
儲存至資訊主頁後，您也可以編輯 Observability Analytics 圖表。詳情請參閱「修改小工具的設定」。
在資訊主頁上顯示錯誤
本節說明如何使用 Google Cloud 控制台新增及設定錯誤報告面板。如要瞭解如何使用 Cloud Monitoring API，在資訊主頁中新增錯誤報告面板，請參閱「含有 ErrorReportingPanel 小工具的資訊主頁」。
如要使用控制台將錯誤報告面板新增至資訊主頁，請按照下列步驟操作：
-
在 Google Cloud 控制台中，前往「Dashboards」(資訊主頁) 頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要進行 App Hub 設定，請選取 App Hub 主專案或管理專案。
- 選取資訊主頁或按一下「建立資訊主頁」。
- 按一下工具列中的「新增小工具」add。
- 在「新增小工具」對話方塊中，前往「圖表」部分，然後選取「Error Reporting 面板」。
- 展開「專案」arrow_drop_down，然後選取專案。
- 選用：更新名稱。
選用：如要限制顯示錯誤的資源，請按照下列步驟操作：
- 展開「所有資源」arrow_drop_down，然後選取所需資源。
選取資源後，您可以選取「套用」，也可以使用其他選單來修正篩選條件：
如要顯示 App Engine 資源的錯誤，請選取「GAE 服務」，然後按一下「套用」。
如要顯示特定 App Engine 服務的錯誤，請選取「GAE 服務」，然後選取該服務並按一下「套用」。
如要將變更套用至資訊主頁，請在工具列中按一下「套用」。如要捨棄變更，請按一下「取消」。
以下範例顯示錯誤回報面板：
如要儲存修改後的資訊主頁，請點按工具列中的「儲存」。
疑難排解
後續步驟
指標範圍總覽說明 Cloud Monitoring 如何提供多項 Google Cloud 專案中儲存的指標和記錄瀏覽權限。
Error Reporting 總覽說明瞭錯誤群組。
如要瞭解如何使用 API 設定資訊主頁來顯示記錄或錯誤，請參閱下列內容：