在自訂資訊主頁上顯示記錄和錯誤

本文說明可新增至自訂資訊主頁的小工具，方便您在與指標資料相同的環境中查看記錄和錯誤資料。記錄面板小工具會顯示記錄項目。錯誤報告面板小工具會顯示最新的錯誤群組。這兩個小工具提供的資訊，或許有助於排解問題。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 的一般資訊，請參閱下列資源：

• 基本概念
• Logging 查詢語言
• 記錄檔探索工具

事前準備

在要查看自訂資訊主頁記錄的 Google Cloud 專案中，完成下列步驟：

• 如要取得所需權限，以便使用 Google Cloud 控制台將記錄面板小工具新增至自訂資訊主頁，並設定小工具以顯示專案或記錄檢視區塊中的記錄項目，請要求管理員授予您下列 IAM 角色：

  • Monitoring 編輯者 (roles/monitoring.editor) 專案。
  • 記錄檢視器 (roles/logging.viewer) 在每個要查看記錄檔項目的專案中。這個角色無法授予您所有記錄項目的存取權。如要進一步瞭解角色，請參閱「使用 IAM 控管 Cloud Logging 存取權」。
  • 記錄檔檢視存取者 (roles/logging.viewAccessor) 在每個專案中，儲存您要存取的記錄檔檢視記錄檔 bucket。「記錄檢視存取者」角色可授予專案儲存的所有記錄檢視畫面存取權。如要瞭解如何取得特定記錄檢視畫面的存取權，請參閱「控管記錄檢視畫面的存取權」。

  如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

  您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

在資訊主頁上顯示記錄項目

本節說明如何使用 Google Cloud 控制台新增及設定記錄面板小工具。如要瞭解如何使用 Cloud Monitoring API，請參閱「含有 LogsPanel 小工具的資訊主頁」。

資訊主頁最多可放置 100 個小工具。

如要使用控制台將記錄面板小工具新增至資訊主頁，請執行下列操作：

1. 前往 Google Cloud 控制台的「Dashboards」(資訊主頁)dashboard 頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如果是 App Hub 設定，請選取 App Hub 主專案或管理專案。
3. 選取資訊主頁或按一下「建立資訊主頁」。
4. 按一下工具列中的「新增小工具」add。
5. 在「新增小工具」對話方塊中，選取「記錄」。
6. 選用：如要更新標題，請在「小工具標題」欄位中輸入新標題。

7. 設定要搜尋記錄項目的資源：

   • 如要依專案搜尋，請將「Scope by」(依範圍) 項目設為「Project」(專案)，然後展開「Projects」(專案) 項目並完成對話方塊。

     「專案」選單會列出目前指標範圍中的所有 Google Cloud 專案。如果選單中的項目包含「您沒有專案層級的權限，無法查看這項專案中的記錄」文字，表示您沒有查看該專案可用記錄項目的必要權限。 Google Cloud

     顯示的記錄項目包括專案產生的項目，以及其他專案中的接收器轉送至專案的項目。Google Cloud Google Cloud

   • 如要依記錄檔值區的記錄檢視畫面搜尋記錄項目，請將「依範圍」項目設為「儲存空間」，然後展開「儲存空間檢視畫面」項目並完成對話方塊。

     「儲存空間檢視」選單會列出所選 Google Cloud 專案中記錄 bucket 的記錄檢視。

     如要選取其他 Google Cloud 專案中記錄 bucket 的記錄檢視，請在選單中按一下「匯入專案」add_circle，選取專案，然後選取一或多個記錄檢視。您只能匯入目前指標範圍內的專案。

   • 如要搜尋記錄範圍中包含的資源 (可能包括專案和記錄檢視)，請將「Scope by」(範圍依據) 項目設為「Logs Scope」(記錄範圍)，然後展開「Log Scopes」(記錄範圍) 項目並選取記錄範圍。

8. 選用：如要限制記錄面板小工具顯示的記錄，請在「Query Editor」(查詢編輯器) 欄位中輸入查詢，然後按一下「Run query」(執行查詢) (如果您已停用自動執行查詢)。如需查詢的簡短簡介，請參閱「查詢範例」。

9. 選用步驟：將變數套用至記錄面板小工具。

   您可以更新小工具的查詢，使其依附於變數，這樣一來，當您變更變數值時，小工具顯示的資料也會隨之變更。您也可以使用變數控制小工具的顯示狀態。如需詳細資訊，請參閱下列文件：

   • 設定小工具的顯示設定
   • 更新小工具的查詢

10. 如要將變更套用至資訊主頁，請在工具列中按一下「套用」。如要捨棄變更，請按一下「取消」。

11. 如要儲存修改後的資訊主頁，請點按工具列中的「儲存」。

    記錄面板小工具會顯示記錄項目表格。 您也可以使用小工具的篩選器列，暫時變更小工具顯示的記錄項目。詳情請參閱「篩選記錄項目」一節。

查詢範例

如要填入「查詢編輯器」 欄位，請在欄位中輸入文字，或從選單中選取項目。「查詢編輯器」欄位使用的查詢語言與「Logs Explorer」相同。如需疑難排解資訊，請參閱「語法問題」。

您可以在「嚴重性」和「記錄檔名稱」選單中選取多個選項。 以下查詢陳述式範例會比對多個嚴重程度：

severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)

「資源」選單可讓您依資源篩選。您可以選取資源類型，例如「已稽核的資源」，也可以在視窗中瀏覽並選取特定方法。

舉例來說，如要新增「已稽核的資源」查詢，請按照下列步驟操作：

1. 展開「資源」選單。
2. 搜尋並選取「Audited Resource」。

3. 按一下「套用」。

   這些步驟會在「查詢編輯器」欄位中加入下列子句：

   resource.type="audited_resource"
   

同樣地，如要新增 Cloud Run functions 稽核記錄的查詢，請按照下列步驟操作：

1. 展開「資源」選單。
2. 搜尋並選取「Audited Resource」。
3. 在服務選單中，選取「Cloud Functions」。

4. 按一下「套用」。

   這些步驟會在「查詢編輯器」欄位中加入下列子句：

   resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"
   

篩選記錄項目

如要修改記錄面板小工具顯示的記錄項目，請修改下列欄位或選單的值：

• 資訊主頁時間選取器：記錄面板小工具只會擷取在這個欄位指定時間間隔內寫入的記錄項目。

• 記錄面板小工具的「篩選器」欄位：指定的篩選器會在查詢完成後套用。這個欄位的值只會保留在目前的工作階段中。

• 記錄面板小工具的「嚴重程度」選單：查詢完成後，系統會套用依嚴重程度篩選的條件。這個欄位的值只會保留到目前的工作階段。

• 記錄檔面板小工具的查詢：記錄檔面板小工具只會顯示符合查詢的記錄項目。如未指定查詢，系統會顯示所選時間間隔內的所有記錄。如果您指定查詢，記錄面板小工具會顯示「顯示查詢」圖示，以工具提示的形式顯示目前查詢。

  如要修改查詢，請編輯記錄面板小工具。

• 記錄面板小工具上的專案：如要修改這項設定，請編輯記錄面板小工具。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「篩選器」欄位的值不會保留。

• 如要套用永久篩選器，請修改「Query Editor」(查詢編輯器) 欄位中儲存的查詢，然後選取「Apply filter」(套用篩選器)。 如要瞭解查詢語法，請參閱「Logging 查詢語言」。

  舉例來說，如要只顯示 MESSAGE 欄位值包含字串「lamp」的記錄項目，請在「Query Editor」(查詢編輯器) 欄位中加入 jsonPayload.MESSAGE:"lamp" 子句。

在 Logs Explorer 中查看記錄項目

記錄面板小工具會顯示記錄項目的重要欄位，但不會顯示完整的記錄項目。如要檢查記錄項目的所有欄位，請按照下列步驟操作：

1. 在記錄面板小工具中，選取「在 Logs Explorer 中查看」。

2. 在對話方塊中，選取要開啟 Logs Explorer 的 Google Cloud 專案。

   系統會在新的瀏覽器分頁中開啟 Logs Explorer，並自動套用您在記錄面板小工具中選取的篩選器。

3. 選取要查看的記錄項目。

顯示從 Observability Analytics 查詢產生的圖表

本節說明如何設定及儲存從可觀測性分析查詢產生的圖表，並將其儲存至自訂資訊主頁。Observability Analytics 可讓您使用 SQL 查詢搜尋及匯總記錄，產生實用的洞察資料。

除了使用 Observability Analytics 頁面設定圖表並將圖表儲存至資訊主頁，您也可以直接在「監控」中儲存 Observability Analytics 圖表，方法如下：

1. 前往 Google Cloud 控制台的「Dashboards」(資訊主頁)dashboard 頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如果是 App Hub 設定，請選取 App Hub 主專案或管理專案。
3. 選取資訊主頁或按一下「建立資訊主頁」。
4. 按一下工具列中的「新增小工具」add。
5. 在「新增小工具」對話方塊中，前往「資料」部分，然後選取「可觀測性分析」。

6. 在「設定小工具」對話方塊中，設定要顯示的資料，然後按一下「執行查詢」。

   如要選取要顯示的資料，您可以建立 SQL 查詢，也可以選取已儲存或最近的查詢。可查詢的記錄檢視畫面和分析檢視畫面會列在「檢視畫面和結構定義」部分。按一下資料來源，即可在「結構定義」標題下方查看該資料來源的欄位清單。

7. 選擇性步驟：在「結果」分頁中，使用「顯示」面板自訂圖表設定。

   在「顯示」面板中，您可以變更圖表類型，並透過變更維度、測量指標和細目，自訂要繪製哪些資料列和資料欄的圖表：

   • 維度： 維度必須是時間戳記、數字或字串資料欄。根據預設，維度會設為結構定義中第一個以時間戳記為準的資料欄。如果查詢中沒有時間戳記，系統會選取第一個字串資料欄做為維度。您也可以在「圖表顯示」面板中自訂維度。如果選取時間戳記欄做為維度，圖表就會顯示資料隨時間變化的情形。如果選取字串資料欄做為長條圖的維度，您可以遞增或遞減排序資料，維度會依字典順序排序。您也可以保留 `default` 排序順序，根據相應指標的值，以遞減順序排序維度。

   • 指標： 您可以在「圖表顯示」面板中選取多個指標。選取指標時，您也必須選取要對其分組值執行的匯總函式，例如 count、sum、average 和 percentile-99。舉例來說，count-distinct 會傳回指定資料欄中的不重複值數量。

   • 細目： 如要根據其他資料欄將單一資料序列分割成多個資料序列，請新增細目。

   如要進一步瞭解如何自訂圖表設定，請參閱「自訂圖表設定」。

8. 如要儲存修改後的資訊主頁，請點按工具列中的「儲存」。

儲存至資訊主頁後，您也可以編輯 Observability Analytics 圖表。詳情請參閱「修改小工具的設定」。

在資訊主頁上顯示錯誤

本節說明如何使用 Google Cloud 控制台新增及設定錯誤報告面板。如要瞭解如何使用 Cloud Monitoring API，在資訊主頁中新增錯誤回報面板，請參閱「含有 ErrorReportingPanel 小工具的資訊主頁」。

如要使用控制台在資訊主頁中新增錯誤報告面板，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Dashboards」(資訊主頁)dashboard 頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如果是 App Hub 設定，請選取 App Hub 主專案或管理專案。
3. 選取資訊主頁或按一下「建立資訊主頁」。
4. 按一下工具列中的「新增小工具」add。
5. 在「新增小工具」對話方塊中，前往「Visualization」部分，然後選取「Error Reporting panel」。
6. 選取顯示錯誤群組的專案，展開「專案」arrow_drop_down，然後進行選取。
7. 選用：更新名稱。

8. 選用：如要限制顯示錯誤的資源，請按照下列步驟操作：

   1. 展開「所有資源」arrow_drop_down，然後選取資源。

   2. 選取資源後，您可以選取「套用」，或使用其他選單修正篩選條件：

      • 如要顯示 App Engine 資源的錯誤，請選取「GAE 服務」，然後按一下「套用」。

      • 如要顯示特定 App Engine 服務的錯誤，請選取「GAE 服務」，然後選取該服務並按一下「套用」。

9. 如要將變更套用至資訊主頁，請在工具列中按一下「套用」。如要捨棄變更，請按一下「取消」。

   以下範例顯示錯誤回報面板：

   

10. 如要儲存修改後的資訊主頁，請點按工具列中的「儲存」。

疑難排解

• 「記錄」面板顯示部分資料
• 記錄檔面板回報無效查詢
• 「記錄」面板顯示「找不到任何項目」訊息

後續步驟

• 如要瞭解 Cloud Monitoring 如何提供多個 Google Cloud 專案中儲存的指標和記錄檔瀏覽權限，請參閱「指標範圍總覽」。

• 如要瞭解如何使用 API 設定資訊主頁來顯示記錄或錯誤，請參閱下列內容：

  • 含有 LogsPanel 小工具的資訊主頁。
  • 含有 ErrorReportingPanel 小工具的資訊主頁。

• 如要進一步瞭解錯誤群組，請參閱「Error Reporting 總覽」。