Skema log Pemeliharaan Terpadu

Untuk membuat kebijakan pemberitahuan dan memfilter log, Anda harus menggunakan Bahasa kueri logging. Tabel berikut menjelaskan kolom dalam resource Pemeliharaan Terpadu ResourceMaintenance. Gunakan kolom ini untuk menulis operasi kueri untuk resource Pemeliharaan Terpadu.

Skema log ResourceMaintenance

Kolom
resource MonitoredResource
resource.type string

Ditetapkan ke jenis resource yang dimonitor dari resource target. Misalnya, instance Cloud SQL: cloudsql_database
resource.labels map (key: string, value: string)

Label yang mengidentifikasi target resource secara unik (lihat daftar label di jenis resource yang dimonitor).
labels map (key: string, value: string)

Pasangan nilai kunci yang digunakan untuk memfilter entri log. Kemungkinan kunci:

maintenance.googleapis.com/new_resource_maintenance - disetel ke True untuk entri log pertama untuk ResourceMaintenance

maintenance.googleapis.com/updated_fields - daftar kolom ResourceMaintenance yang diperbarui, misalnya:
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
insertId string

ID unik untuk entri log.
timestamp string (Timestamp format)

Waktu terjadinya peristiwa yang dijelaskan oleh entri log. Waktu ini digunakan untuk menghitung usia entri log dan untuk menerapkan periode retensi log.
receiveTimestamp string (Timestamp format)

Waktu entri log diterima oleh Logging.
jsonPayload ResourceMaintenance

Payload dengan detail pemeliharaan resource.
jsonPayload.@type string

Definisi jenis payload.
Sama dengan: type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog
jsonPayload.name ID string

. Nama resource resourceMaintenance. Format: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

Hanya output. Name adalah referensi ke resource konsumen yang terpengaruh oleh pemeliharaan. Untuk nilai yang tersedia, lihat Nama aset.
jsonPayload.resource.location string

Hanya output. Lokasi resource. Format: us-central1.
jsonPayload.resource.type string

Hanya output. Jenis resource. Untuk nilai yang tersedia, lihat jenis resource layanan yang didukung.
jsonPayload.maintenance object

Hanya output. Detail pemeliharaan.
jsonPayload.maintenance.maintenanceName string

Nama resource pemeliharaan yang sesuai mengikuti skema penamaan standar: "{maintenance-id}".
jsonPayload.maintenance.title string

Hanya output. Judul pemeliharaan.
jsonPayload.maintenance. description string

Hanya output. Deskripsi pemeliharaan.
jsonPayload.state enum

Status pemeliharaan:
SCHEDULED - Dijadwalkan untuk jangka waktu tertentu. Untuk pemeliharaan yang mengganggu, kebijakan pemeliharaan harus dipatuhi. Misalnya, periode pemeliharaan yang tersedia, pengecualian, dan periode notifikasi.
STARTED - Pemeliharaan sedang berlangsung.
CANCELLED - Tidak lagi direncanakan, biasanya saat pemeliharaan lain (misalnya, upgrade ke versi yang lebih baru) sudah terjadi, atau pengguna melewati pemeliharaan.
SUCCEEDED - Berhasil diselesaikan.
jsonPayload.maintenanceScheduledStartTime string

Hanya output. Waktu saat pemeliharaan pada resource adalah SCHEDULED.
Menggunakan RFC 3339, yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima.
Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceScheduledEndTime string

Hanya output. Waktu saat pemeliharaan pada resource dijadwalkan berakhir.
Menggunakan RFC 3339, yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima.
Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceStartTime string

Hanya output. Waktu saat pemeliharaan resource STARTED.
Menggunakan RFC 3339, yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima.
Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceEndTime string

Hanya output. Waktu saat pemeliharaan resource SUCCEEDED.
Menggunakan RFC 3339, yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima.
Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceCancelTime string

Hanya output. Waktu saat pemeliharaan resource CANCELLED.
Menggunakan RFC 3339, yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima.
Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
jsonPayload.userControllable boolean

Hanya output. Menunjukkan apakah pengguna memiliki kontrol atas pemeliharaan tersebut, baik secara proaktif sebelum pemeliharaan dijadwalkan dengan kebijakan pemeliharaan atau dengan kontrol reaktif setelah dijadwalkan (lihat kolom controls).
jsonPayload.controls object(MaintenanceControl)

Hanya Output. Kontrol pemeliharaan.

Contoh kolom log

Contoh berikut menunjukkan resource 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"
}

Langkah berikutnya