Schema del log di Unified Maintenance

Per creare criteri di avviso e filtrare i log, devi utilizzare il linguaggio di query di Logging. La tabella seguente descrive in dettaglio i campi della risorsa Unified Maintenance ResourceMaintenance. Utilizza questi campi per scrivere operazioni di query per le risorse di manutenzione unificata.

ResourceMaintenance schema di log

Campi
resource MonitoredResource
resource.type string

Imposta il tipo di risorsa monitorata della risorsa di destinazione. Ad esempio, istanza Cloud SQL: cloudsql_database
resource.labels map (key: string, value: string)

Etichette che identificano in modo univoco una risorsa di destinazione (consulta un elenco di etichette in Tipi di risorse monitorate).
labels map (key: string, value: string)

Coppia chiave-valore utilizzata per filtrare le voci di log. Chiavi possibili:

maintenance.googleapis.com/new_resource_maintenance: impostato su True per la prima voce di log per un ResourceMaintenance

maintenance.googleapis.com/updated_fields: un elenco di campi ResourceMaintenance aggiornati, ad esempio:
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
insertId string

Un identificatore univoco per la voce di log.
timestamp string (Timestamp format)

L'ora in cui si è verificato l'evento descritto dalla voce di log. Questo orario viene utilizzato per calcolare l'età della voce di log e per applicare il periodo di conservazione dei log.
receiveTimestamp string (Timestamp format)

L'ora in cui la voce di log è stata ricevuta da Logging.
jsonPayload ResourceMaintenance

Payload con i dettagli di manutenzione delle risorse.
jsonPayload.@type string

Definizione del tipo di payload.
Uguale a: type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog
jsonPayload.name string

Identificatore. Il nome della risorsa resourceMaintenance. Formato: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

Solo output. Name è il riferimento alla risorsa consumer interessata dalla manutenzione. Per i valori disponibili, vedi Nomi degli asset.
jsonPayload.resource.location string

Solo output. Località della risorsa. Formato: us-central1.
jsonPayload.resource.type string

Solo output. Il tipo di risorsa. Per i valori disponibili, vedi i tipi di risorse dei servizi supportati.
jsonPayload.maintenance object

Solo output. I dettagli della manutenzione.
jsonPayload.maintenance.maintenanceName string

Il nome della risorsa di manutenzione corrispondente secondo lo schema di denominazione standard: "{maintenance-id}".
jsonPayload.maintenance.title string

Solo output. Il titolo della manutenzione.
jsonPayload.maintenance. description string

Solo output. La descrizione della manutenzione.
jsonPayload.state enum

Stato della manutenzione:
SCHEDULED - Pianificata per un determinato periodo. Per la manutenzione distruttiva, deve rispettare la policy di manutenzione. Ad esempio, le finestre disponibili, le esclusioni e il periodo di notifica.
STARTED - La manutenzione è in corso.
CANCELLED - Non più pianificata, in genere quando è già stata eseguita un'altra manutenzione (ad es. l'upgrade a una versione più recente) o l'utente ha saltato la manutenzione.
SUCCEEDED - Completato.
jsonPayload.maintenanceScheduledStartTime string

Solo output. L'ora in cui la manutenzione della risorsa è SCHEDULED.
Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z".
Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceScheduledEndTime string

Solo output. L'ora in cui è prevista la fine della manutenzione della risorsa.
Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z".
Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceStartTime string

Solo output. L'ora in cui la manutenzione della risorsa è STARTED.
Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z".
Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceEndTime string

Solo output. L'ora in cui la manutenzione della risorsa è SUCCEEDED.
Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z".
Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceCancelTime string

Solo output. L'ora in cui è stata CANCELLED la manutenzione della risorsa.
Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z".
Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
jsonPayload.userControllable boolean

Solo output. Indica se l'utente ha un certo controllo sulla manutenzione, in modo proattivo prima che venga pianificata con la policy di manutenzione o con controlli reattivi dopo la pianificazione (vedi il campo controls).
jsonPayload.controls object(MaintenanceControl)

Solo output. I controlli di manutenzione.

Campi di log di esempio

L'esempio seguente mostra una risorsa 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"
}

Passaggi successivi