使用稽核記錄排解 Pub/Sub 問題

Pub/Sub 會產生稽核記錄,記錄 Pub/Sub 資源的管理和存取活動。這些活動的範例包括建立主題、更新訂閱項目或刪除快照。您可以使用這些記錄檔排解問題,並確保訊息基礎架構的安全性。

以下是 Pub/Sub 稽核記錄的幾個重要注意事項:

  • Pub/Sub 稽核記錄會使用服務名稱 pubsub.googleapis.com

  • Pub/Sub 有不同類型的記錄。其中包括:

    • 管理員活動記錄會記錄建立、刪除或更新主題和訂閱項目等動作。

    • 資料存取記錄會記錄擷取主題或列出訂閱項目等動作。

    • 系統事件記錄會記錄移除不活躍訂閱項目等事件。

  • Pub/Sub 不會記錄訊息操作,例如發布、訂閱或確認訊息。

如要進一步瞭解 Pub/Sub 的稽核記錄,請參閱「稽核記錄」。

查看 Pub/Sub 稽核記錄

記錄檔探索工具提供集中式位置,可存取 Google Cloud中的所有記錄資料。您可以使用記錄檔探索工具查看 Pub/Sub 記錄。

  1. 取得查看 記錄檔探索工具 所需的權限。

    詳情請參閱「事前準備」一節。

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

    前往「Logs Explorer」

  3. 選取現有的 Google Cloud 專案、資料夾或機構。

  4. 如要顯示與 Pub/Sub 相關的所有稽核記錄,請在查詢編輯器欄位中輸入下列查詢:

     protoPayload.serviceName="pubsub.googleapis.com"
    
    圖片:說明如何在查詢編輯器欄位中輸入查詢。
    圖 1 輸入查詢。
  5. 點選「執行查詢」

  6. 如要顯示特定資源和稽核記錄類型的稽核記錄,請在「查詢建構工具」窗格中執行下列操作:

    1. 在「所有資源」中,選取您要查看稽核記錄的 Google Cloud 資源。例如選取「Cloud Pub/Sub 主題」,然後選取主題名稱。

    2. 在「All log names」(所有記錄名稱) 中,選取要查看的稽核記錄類型。

      例如:

      • 如要查看管理員活動稽核記錄,請選取並輸入 activity

      • 如要查看系統事件稽核記錄,請選取 system_event

系統會自動執行查詢。

如何使用稽核記錄排解 Pub/Sub 問題

  1. 請先確定要調查的具體問題。以下列出潛在問題:

    • 找出建立、刪除或修改主題、訂閱項目、快照或結構定義的使用者。

    • 追蹤主題或訂閱設定的變更。

    • 確認主題或訂閱項目是否存在,以及目前狀態。

    不過,您無法使用稽核記錄排解訊息發布和傳送相關問題。您不會在記錄中找到郵件傳送失敗、郵件重複或郵件排序問題。稽核記錄也無法協助您找出訂閱者速度緩慢或訊息確認問題。如要排解訊息層級問題,您必須使用其他工具,例如監控指標、無效信件佇列和應用程式記錄。

  2. 根據問題,建構查詢來篩選稽核記錄。舉例來說,如要找出刪除訂閱項目的使用者,請篩選 protoPayload.methodName="google.pubsub.v1.Publisher.DeleteSubscription"

    如要調查建立訂閱項目時可能發生的錯誤,請篩選「protoPayload.methodName="google.pubsub.v1.Subscriber.CreateSubscription"」。

  3. 請檢查記錄項目中的時間戳記、原則和資源名稱,瞭解事件順序並找出任何異常狀況。

如要進一步瞭解如何為 Pub/Sub 建構稽核記錄查詢,請參閱「稽核記錄」一文。