Einheitliches Wartungsprotokollschema

Zum Erstellen von Benachrichtigungsrichtlinien und Filtern von Logs müssen Sie die Logging-Abfragesprache verwenden. In der folgenden Tabelle werden die Felder in der Unified Maintenance-Ressource ResourceMaintenance beschrieben. Mit diesen Feldern können Sie Abfragevorgänge für Unified Maintenance-Ressourcen schreiben.

ResourceMaintenance-Logschema

Felder
resource MonitoredResource
resource.type string

Wird auf den Typ der überwachten Ressource der Zielressource festgelegt. Beispiel: Cloud SQL-Instanz: cloudsql_database
resource.labels map (key: string, value: string)

Labels, die eine Zielressource eindeutig identifizieren (eine Liste der Labels finden Sie unter Überwachte Ressourcentypen).
labels map (key: string, value: string)

Schlüssel/Wert-Paar zum Filtern von Logeinträgen. Mögliche Schlüssel:

maintenance.googleapis.com/new_resource_maintenance – auf „True“ gesetzt für den ersten Logeintrag für ein ResourceMaintenance

maintenance.googleapis.com/updated_fields – eine Liste der aktualisierten ResourceMaintenance-Felder, z. B.
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
insertId string

Eindeutige Kennung für den Logeintrag.
timestamp string (Timestamp format)

Zeit, zu der das im Logeintrag beschriebene Ereignis eingetreten ist. Diese Zeit wird verwendet, um das Alter des Logeintrags zu berechnen und die Aufbewahrungsdauer des Logs zu erzwingen.
receiveTimestamp string (Timestamp format)

Zeitpunkt, zu dem der Logeintrag von Logging empfangen wurde.
jsonPayload ResourceMaintenance

Nutzlast mit Details zur Ressourcenwartung.
jsonPayload.@type string

Typdefinition der Nutzlast.
Gleich: type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog
jsonPayload.name string

 ID. Der Name der Ressource „resourceMaintenance“. Format: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

Nur Ausgabe. „Name“ ist der Verweis auf die von der Wartung betroffene Consumer-Ressource. Die verfügbaren Werte finden Sie unter Asset-Namen.
jsonPayload.resource.location string

Nur Ausgabe. Der Standort der Ressource. Format: us-central1.
jsonPayload.resource.type string

Nur Ausgabe. Der Typ der Ressource Die verfügbaren Werte finden Sie unter Ressourcentypen der unterstützten Dienste.
jsonPayload.maintenance object

Nur Ausgabe. Details zur Wartung.
jsonPayload.maintenance.maintenanceName string

 Der Name der entsprechenden Wartungsressource gemäß dem Standardbenennungsschema: "{maintenance-id}".
jsonPayload.maintenance.title string

Nur Ausgabe. Der Titel der Wartung.
jsonPayload.maintenance. description string

Nur Ausgabe. Die Beschreibung der Wartung.
jsonPayload.state enum

Status der Wartung:
SCHEDULED – Für ein bestimmtes Zeitfenster geplant. Bei betriebsunterbrechender Wartung sollten die Wartungsrichtlinien eingehalten werden. Dazu gehören beispielsweise die verfügbaren Zeiträume, Ausschlüsse und der Benachrichtigungszeitraum.
STARTED: Die Wartung läuft.
CANCELLED – Nicht mehr geplant, in der Regel, wenn bereits eine andere Wartung (z.B. Upgrade auf eine neuere Version) stattgefunden hat oder der Nutzer die Wartung übersprungen hat.
SUCCEEDED – Erfolgreich abgeschlossen.
jsonPayload.maintenanceScheduledStartTime string

Nur Ausgabe. Der Zeitpunkt, zu dem die Wartung der Ressource SCHEDULED ist.
Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert.
Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceScheduledEndTime string

Nur Ausgabe. Der Zeitpunkt, zu dem die Wartung der Ressource planmäßig enden sollte.
Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert.
Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceStartTime string

Nur Ausgabe. Der Zeitpunkt, zu dem die Ressourcenwartung STARTED hat.
Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert.
Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceEndTime string

Nur Ausgabe. Der Zeitpunkt, zu dem die Ressourcenwartung SUCCEEDED hat.
Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert.
Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceCancelTime string

Nur Ausgabe. Der Zeitpunkt, zu dem die Ressourcenwartung CANCELLED wurde.
Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert.
Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
jsonPayload.userControllable boolean

Nur Ausgabe. Gibt an, ob der Nutzer eine gewisse Kontrolle über die Wartung hat, entweder proaktiv vor der geplanten Wartung mit einer Wartungsrichtlinie oder mit reaktiven Steuerelementen nach der Planung (siehe Feld controls).
jsonPayload.controls object(MaintenanceControl)

Nur Ausgabe. Die Einstellungen für die Wartung.

Beispiel für Logfelder

Das folgende Beispiel zeigt eine ResourceMaintenance-Ressource.

"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"
}

Nächste Schritte