查看自動備份的稽核記錄

本頁說明如何查看 Cloud SQL 執行個體自動備份的稽核記錄。

稽核記錄可用於下列用途:

  • 查看稽核記錄,確認備份作業是否順利完成。
  • 設定記錄式快訊,在備份狀態改變時通知您。

查看稽核記錄

您可以使用 Google Cloud 控制台、gcloud CLI 或 API 查看稽核記錄,確認備份是否在備份時間範圍內順利完成。

控制台

  1. 在 Google Cloud 控制台中,依序選取「Logging」(記錄) 和「Logs Explorer」(記錄檔探索工具)

    前往記錄檔探索工具

  2. 如要篩選 Cloud SQL 執行個體自動備份的稽核記錄,請執行下列查詢:

    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event"
    protoPayload.methodName="cloudsql.instances.automatedBackup"
    resource.type="cloudsql_database"

    PROJECT_ID 替換為專案 ID。 Google Cloud

    第一個運算式會篩選系統事件稽核記錄。 第二個運算式會篩選自動備份的稽核記錄。最終運算式會篩選 Cloud SQL 執行個體的稽核記錄。

    如要進一步瞭解如何使用 Google Cloud 控制台查詢稽核記錄,請參閱「查看記錄」。

  3. 查看備份時段內建立的備份狀態。這個狀態會顯示在 windowStatus 欄位中。如要查看這個欄位,請完成下列步驟:

    1. 按一下稽核記錄。
    2. 按一下「metadata」欄位。

gcloud

  1. 如要篩選 Cloud SQL 執行個體自動備份的稽核記錄,請執行下列查詢:

    gcloud logging read \
    "logName=projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Fsystem_event
    AND protoPayload.methodName=cloudsql.instances.automatedBackup AND
    resource.type=cloudsql_database" \ 
        --project=PROJECT_NAME

    PROJECT_NAME 替換為專案名稱。 Google Cloud

    第一個運算式會篩選系統事件稽核記錄。 第二個運算式會篩選自動備份的稽核記錄。最終運算式會篩選 Cloud SQL 執行個體的稽核記錄。

    如要進一步瞭解如何使用 gcloud 查詢稽核記錄,請參閱「查看記錄」。

  2. 查看備份時段內建立的備份狀態。這個狀態會顯示在 windowStatus 欄位中。

API

使用任何要求資料之前,請先替換以下項目:

  • PROJECT_ID:您的 Google Cloud 專案 ID。

在要求 JSON 主體中,第一個運算式會篩選 系統事件稽核記錄。第二個運算式會篩選自動備份的稽核記錄。 Cloud SQL 執行個體稽核記錄的最終篩選運算式。

如要進一步瞭解如何使用 API 查詢稽核記錄,請參閱「查看記錄」一文。

HTTP 方法和網址:

POST https://logging.googleapis.com/v2/entries:list

JSON 要求主體:

{
     "resourceNames": [
     "projects/PROJECT_ID"
      ],
     "pageSize": 5,
     "filter": "logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event AND protoPayload.methodName = cloudsql.instances.automatedBackup AND resource.type=cloudsql_database",
     "orderBy": "timestamp desc"
} 

如要傳送要求,請展開以下其中一個選項:

您應該會收到如下的 JSON 回應:

如要進一步瞭解 insertId 欄位的 LOG_ENTRY_UNIQUE_IDENTIFIER,請參閱 LogEntry

查看備份時段內建立的備份狀態。這個狀態會顯示在 windowStatus 欄位中。

自動備份狀態

  • STATUS_SUCCEEDED:自動備份已順利完成。
  • STATUS_ATTEMPT_FAILED:Cloud SQL 嘗試建立備份,但備份作業未啟動或失敗。這個狀態的原因包括:

    • 執行個體正在進行其他備份作業。
    • 備份位置受到貴機構政策限制。
    • 執行個體備份作業已完成,但發生錯誤。
    • Cloud SQL 嘗試建立備份時,執行個體並未執行。
  • STATUS_FAILED:執行個體的自動備份作業尚未順利完成,或無法在備份時間範圍內完成。

    舉例來說,如果您已啟用自動備份功能,並將備份時間範圍設為凌晨 1 點到 5 點,但這段時間內有許多 EXPORT 作業,備份作業可能會失敗。如果與長時間執行的 EXPORT 作業發生太多衝突,自動備份也可能會失敗。

    如果 Cloud SQL 在備份時間範圍內多次嘗試建立備份,但因 STATUS_ATTEMPT_FAILED 列出的原因而無法建立備份,Cloud SQL 會產生另一個稽核記錄,並將 windowStatus 欄位設為 STATUS_FAILED

  • STATUS_SKIPPED:Cloud SQL 執行個體已停止執行,因此無法進行備份。因此系統不會建立新的自動備份。

設定記錄型快訊

您可以設定記錄檔型快訊,以便在備份狀態變更時收到通知。

  • 如果備份狀態為 STATUS_SUCCEEDED,您可以收到通知,以便追蹤。
  • 如果備份作業的狀態為 STATUS_FAILEDSTATUS_ATTEMPT_FAILED ,系統會通知您根據記錄檔項目中顯示的訊息採取修正措施。您也可以在下一個排定的備份時間範圍前,按照需求備份
  • 如果備份狀態為 STATUS_SKIPPED,系統會通知您重新啟動 Cloud SQL 執行個體。

後續步驟