Unified Maintenance 日志架构

如需创建提醒政策和过滤日志，您必须使用日志记录查询语言。下表详细介绍了统一维护资源 ResourceMaintenance 中的字段。您可以使用这些字段为统一维护资源编写查询操作。

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 - 对于 ResourceMaintenance 的第一个日志条目，设置为 True

maintenance.googleapis.com/updated_fields - 更新后的 ResourceMaintenance 字段的列表，例如：
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
insertId string

日志条目的唯一标识符。
timestamp string (Timestamp format)

日志条目所述事件发生的时间。此时间用于计算日志条目的存在时间并强制执行日志的保留期限。
receiveTimestamp string (Timestamp format)

日志记录系统接收日志条目的时间。
jsonPayload ResourceMaintenance

包含资源维护详细信息的载荷。
jsonPayload.@type string

载荷的类型定义。
等于：type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog
jsonPayload.name string

标识符。resourceMaintenance 资源的名称。格式："projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

仅限输出。Name 是指受维护影响的消费资源。如需了解可用的值，请参阅资源名称。
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 - 成功完成。
jsonPayload.maintenanceScheduledStartTime string

仅限输出。资源维护时间为 SCHEDULED。
采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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"
}

后续步骤