Unified Maintenance 記錄結構定義

如要建立快訊政策及篩選記錄，請使用 Logging 查詢語言。下表詳細列出 Unified Maintenance 資源 ResourceMaintenance 中的欄位。使用這些欄位，為 Unified Maintenance 資源撰寫查詢作業。

ResourceMaintenance 記錄結構定義

欄位
resource MonitoredResource
resource.type string

設定為目標資源的受控資源類型。例如，Cloud SQL 執行個體：cloudsql_database
resource.labels map (key: string, value: string)

可唯一識別目標資源的標籤 (請參閱受控資源類型中的標籤清單)。
labels map (key: string, value: string)

用於篩選記錄項目的鍵/值組合。可能使用的鍵：

maintenance.googleapis.com/new_resource_maintenance - 設為 True，表示這是 ResourceMaintenance 的第一個記錄項目

maintenance.googleapis.com/updated_fields - 更新的 ResourceMaintenance 欄位清單，例如：
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
insertId string

記錄項目的專屬 ID。
timestamp string (Timestamp format)

記錄項目描述的事件發生的時間。系統會使用這個時間計算記錄項目的存在時間，並強制執行記錄保留期限。
receiveTimestamp string (Timestamp format)

Logging 收到記錄項目的時間。
jsonPayload ResourceMaintenance

含有資源維護詳細資料的酬載。
jsonPayload.@type string

酬載的型別定義。
等於：type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog
jsonPayload.name string

ID。resourceMaintenance 資源的名稱。格式："projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

僅供輸出。「名稱」是指受維護作業影響的消費者資源。如要瞭解可用的值，請參閱「資產名稱」。
jsonPayload.resource.location string

僅供輸出。資源位置。格式：us-central1。
jsonPayload.resource.type string

僅供輸出。資源類型。如需可用值，請參閱支援服務的資源類型。
jsonPayload.maintenance object

僅供輸出。維護作業詳細資料。
jsonPayload.maintenance.maintenanceName string

對應維護資源的名稱，遵循標準命名配置："{maintenance-id}"。
jsonPayload.maintenance.title string

僅供輸出。維護作業的標題。
jsonPayload.maintenance. description string

僅供輸出。維護作業的說明。
jsonPayload.state enum

維護狀態：
SCHEDULED - 已排定特定時間範圍。如為中斷性維護作業，則應遵守維護政策。例如可用時間範圍、排除時段和通知時間。
STARTED - 維護作業正在進行中。
CANCELLED - 不再排定，通常是因為已進行其他維護作業 (例如升級至新版)，或使用者略過維護作業。
SUCCEEDED - Successfully completed.
jsonPayload.maintenanceScheduledStartTime string

僅供輸出。資源維護作業的 SCHEDULED 時間。
使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移值。
示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
jsonPayload.maintenanceScheduledEndTime string

僅供輸出。資源維護作業預計結束的時間。
使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移值。
示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
jsonPayload.maintenanceStartTime string

僅供輸出。資源維護作業的 STARTED 時間。
使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。
範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
jsonPayload.maintenanceEndTime string

僅供輸出。資源維護作業的 SUCCEEDED 時間。
使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移值。
示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
jsonPayload.maintenanceCancelTime string

僅供輸出。資源維護作業的CANCELLED時間。
使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移值。
示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
jsonPayload.userControllable boolean

僅供輸出。指出使用者是否可控管該維護作業，包括在維護政策排定維護作業前主動控管，或在排定作業後被動控管 (請參閱 controls 欄位)。
jsonPayload.controls object(MaintenanceControl)

僅限輸出。維護作業的控制選項。

記錄欄位範例

下列範例顯示 ResourceMaintenance 資源。

"insertId": "proj-1-us-west1-db-1-830d851d-2adf-4fb0-8f5b-1e18e16530d9",
"timestamp": "2023-09-14T16:00:00Z",
"receiveTimestamp": "2023-09-14T16:00:01Z",
"logName":"projects/proj-1/logs/maintenance.googleapis.com%2Fmaintenance_events",
"resource": {
  "type":"cloudsql_database",
  "labels": {
    "project_id": "proj-1",
    "database_id":"db-1",
    "region": "us-west1",
  },
},
"labels": {
  "maintenance.googleapis.com/new_resource_maintenance": "False",
  "maintenance.googleapis.com/updated_fields": "['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
},
"jsonPayload": {
  "@type": "type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog",
  "name": "projects/proj-1/locations/us-west1/resourceMaintenances/db-1-a8307daa-5e1f-4974-b6a5-61fceb8331c0",
  "resource": {
    "resourceName": "//sqladmin.googleapis.com/projects/proj-1/instances/db-1",
    "location": "us-west1",
    "type": "sqladmin.googleapis.com/Instance"
  },
  "maintenance": {
    "maintenanceName": "830d851d-2adf-4fb0-8f5b-1e18e16530d9",
    "title": "Cloud SQL upgrade to v2",
    "description": "An upgrade to v2 release. New features... Release notes: https://..."
  },
  "state": "SCHEDULED",
  "maintenanceScheduledStartTime": "2023-09-21T16:00:00Z",
  "maintenanceScheduledEndTime": "2023-09-21T20:00:00Z"
}

後續步驟