本頁說明如何查看 Cloud SQL 執行個體自動備份的稽核記錄。
稽核記錄可用於下列用途:
- 查看稽核記錄,確認備份作業是否順利完成。
- 設定記錄式快訊,在備份狀態改變時通知您。
查看稽核記錄
您可以使用 Google Cloud 控制台、gcloud CLI
或 API 查看稽核記錄,確認備份是否在備份時間範圍內順利完成。
控制台
在 Google Cloud 控制台中,依序選取「Logging」(記錄) 和「Logs Explorer」(記錄檔探索工具)。
如要篩選 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 控制台查詢稽核記錄,請參閱「查看記錄」。
查看備份時段內建立的備份狀態。這個狀態會顯示在
windowStatus
欄位中。如要查看這個欄位,請完成下列步驟:- 按一下稽核記錄。
- 按一下「
metadata
」欄位。
gcloud
如要篩選 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
查詢稽核記錄,請參閱「查看記錄」。查看備份時段內建立的備份狀態。這個狀態會顯示在
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_FAILED
或STATUS_ATTEMPT_FAILED
,系統會通知您根據記錄檔項目中顯示的訊息採取修正措施。您也可以在下一個排定的備份時間範圍前,按照需求備份。 - 如果備份狀態為
STATUS_SKIPPED
,系統會通知您重新啟動 Cloud SQL 執行個體。