尋找含有錯誤群組的記錄項目

本文說明如何使用 Logs Explorer,找出、篩選及排除屬於錯誤群組的記錄項目。錯誤群組 可依據例外狀況類型、框架或訊息等值,將含有錯誤的記錄檔項目分組,協助您找出環境中的趨勢和重複發生的問題。

查看記錄項目的錯誤群組詳細資料

如要追蹤應用程式中重複發生的錯誤,並管理解決狀態,請使用 Google Cloud 控制台的「Error Reporting」頁面。「Error Reporting」頁面會列出錯誤群組,包括特定錯誤類型、錯誤發生次數,以及每個群組的解決狀態等資訊。

Error Reporting 功能會在建立錯誤群組時,自動設定 error_groups ID 欄位的值。這個欄位包含英數字元、-_

在 Error Reporting 中找出錯誤群組的記錄項目

如要查看 Error Reporting 頁面,並找出與特定錯誤群組相關聯的記錄項目,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Error Reporting」頁面:

    前往 Error Reporting

    您也可以透過搜尋列找到這個頁面。

  2. 按一下錯誤名稱。
  3. 在「Recent samples」(近期樣本) 窗格中,點選任何記錄項目的「View Logs」(查看記錄)

    「Logs Explorer」頁面隨即開啟,並顯示與錯誤群組相關聯的記錄項目。查詢編輯器欄位會指定錯誤群組 ID。 舉例來說,這個欄位可能包含類似 errorGroups.id="ERROR_GROUP_ID" 的內容,其中 ERROR_GROUP_ID 是錯誤群組的 ID。

依錯誤群組篩選記錄項目

如果您正在查看「記錄檔探索工具」頁面,並想找出與特定錯誤或任何錯誤群組相關聯的記錄項目,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的 「Logs Explorer」頁面

    前往「Logs Explorer」(記錄檔探索工具)

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

  2. 執行下列其中一個步驟:

    • 如要尋找與任何錯誤群組相關聯的記錄項目,請在查詢窗格中新增下列內容:

      errorGroups.id:*
      
    • 如要找出與特定錯誤群組相關聯的記錄項目,請在查詢窗格中新增下列內容:

      errorGroups.id: "ERROR_GROUP_ID"
      
  3. 執行查詢。

調查記錄項目的錯誤群組

如要開啟記錄項目的錯誤群組,請依序選取「錯誤群組」和「查看錯誤群組詳細資料」

記錄項目範例,其中包含錯誤回報分組。

您也可以使用「錯誤群組」按鈕 中的選項,變更 Logs Explorer 顯示的記錄項目:

  • 如要進一步調查錯誤群組,請選取「顯示這個錯誤群組中的項目」。Logs Explorer 會重新整理,並只顯示同一錯誤群組中的記錄項目。您現在可以將其他查詢參數套用至錯誤群組的記錄項目。

  • 如要從查詢結果中移除特定錯誤群組,請選取「隱藏這個錯誤群組中的項目」。Logs Explorer 會重新整理,且這個錯誤群組中的所有記錄項目都會從顯示畫面中隱藏。

監控錯誤群組

您可以設定 Error Reporting,讓系統在偵測到新的錯誤群組時通知您。這項服務也提供每個錯誤群組的錯誤記錄,方便您管理這些錯誤。詳情請參閱下列文件:

您無法建立記錄指標來計算含有錯誤群組的記錄項目數量,也無法設定記錄警告,在記錄項目含有錯誤群組時通知您。同樣地,您也無法將 errorGroups 欄位中的值擷取到附加至記錄指標或記錄警告的標籤。