Esquema de registro da Unified Maintenance

Para criar políticas de alerta e filtrar registros, use a linguagem de consulta do Logging. A tabela a seguir detalha os campos no recurso de manutenção unificada ResourceMaintenance. Use esses campos para escrever operações de consulta para recursos da manutenção unificada.

Esquema de registro ResourceMaintenance

Campos
resource MonitoredResource
resource.type string

Definido como o tipo de recurso monitorado do recurso de destino. Por exemplo, instância do Cloud SQL: cloudsql_database
resource.labels map (key: string, value: string)

Rótulos que identificam exclusivamente um recurso de destino. Consulte uma lista de rótulos em tipos de recursos monitorados.
labels map (key: string, value: string)

Par de chave-valor usado para filtrar entradas de registro. Chaves possíveis:

maintenance.googleapis.com/new_resource_maintenance: definido como "True" para a primeira entrada de registro de um ResourceMaintenance.

maintenance.googleapis.com/updated_fields: uma lista de campos ResourceMaintenance atualizados, por exemplo,
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']".
insertId string

Um identificador exclusivo da entrada de registro.
timestamp string (Timestamp format)

A hora em que o evento descrito pela entrada de registro ocorreu. Esse horário é usado para calcular a idade da entrada de registro e aplicar o período de armazenamento dos registros.
receiveTimestamp string (Timestamp format)

A hora em que a entrada de registro foi recebida pelo Logging.
jsonPayload ResourceMaintenance

Payload com detalhes de manutenção de recursos.
jsonPayload.@type string

Definição do tipo do payload.
Igual a: type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog
jsonPayload.name Identificador string

. O nome do recurso "resourceMaintenance". Formato: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

Apenas saída. Name é a referência ao recurso do consumidor afetado pela manutenção. Para valores disponíveis, consulte Nomes de recursos.
jsonPayload.resource.location string

Apenas saída. O local do recurso. Formato: us-central1.
jsonPayload.resource.type string

Apenas saída. O tipo de recurso. Para ver os valores disponíveis, consulte os tipos de recursos dos serviços compatíveis.
jsonPayload.maintenance object

Apenas saída. Os detalhes da manutenção.
jsonPayload.maintenance.maintenanceName string

O nome do recurso de manutenção correspondente seguindo o esquema de nomenclatura padrão: "{maintenance-id}".
jsonPayload.maintenance.title string

Apenas saída. O título da manutenção.
jsonPayload.maintenance. description string

Apenas saída. A descrição da manutenção.
jsonPayload.state enum

Estado da manutenção:
SCHEDULED - Programada para uma janela específica. Para manutenções disruptivas, ela precisa respeitar a política de manutenção. Por exemplo, as janelas disponíveis, as exclusões e o período de notificação.
STARTED: a manutenção está em andamento.
CANCELLED: não está mais planejado, geralmente quando outra manutenção (por exemplo, upgrade para uma versão mais recente) já aconteceu ou o usuário pulou a manutenção.
SUCCEEDED: concluído com sucesso.
jsonPayload.maintenanceScheduledStartTime string

Apenas saída. O momento em que a manutenção do recurso está SCHEDULED.
usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos.
Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceScheduledEndTime string

Apenas saída. O horário em que a manutenção do recurso foi programada para terminar.
usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos.
Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceStartTime string

Apenas saída. O momento em que a manutenção do recurso tem STARTED.
usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos.
Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceEndTime string

Apenas saída. O momento em que a manutenção do recurso tem SUCCEEDED.
usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos.
Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceCancelTime string

Apenas saída. O horário em que a manutenção do recurso foi CANCELLED.
usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos.
Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.userControllable boolean

Apenas saída. Indica se o usuário tem algum controle sobre essa manutenção, seja de forma proativa antes de ela ser programada com a política de manutenção ou com controles reativos depois que ela foi programada (consulte o campo controls).
jsonPayload.controls object(MaintenanceControl)

Somente saída. Os controles da manutenção.

Exemplos de campos de registro

O exemplo a seguir mostra um recurso 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"
}

A seguir