Schéma du journal Unified Maintenance

Pour créer des règles d'alerte et filtrer les journaux, vous devez utiliser le langage de requête Logging. Le tableau suivant détaille les champs de la ressource de maintenance unifiée ResourceMaintenance. Utilisez ces champs pour écrire des opérations de requête pour les ressources de maintenance unifiée.

Schéma du journal ResourceMaintenance

Champs
resource MonitoredResource
resource.type string

Défini sur le type de ressource surveillée de la ressource ciblée. Par exemple, instance Cloud SQL : cloudsql_database
resource.labels map (key: string, value: string)

Libellés qui identifient de manière unique une ressource cible (consultez la liste des libellés dans Types de ressources surveillées).
labels map (key: string, value: string)

Paire clé/valeur utilisée pour filtrer les entrées de journaux. Clés possibles :

maintenance.googleapis.com/new_resource_maintenance : défini sur "True" pour la première entrée de journal d'un ResourceMaintenance

maintenance.googleapis.com/updated_fields : liste des champs ResourceMaintenance mis à jour, par exemple :
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
insertId string

Identifiant unique de l'entrée de journal.
timestamp string (Timestamp format)

Heure à laquelle l'événement décrit par l'entrée de journal s'est produit. Cette heure permet de calculer l'âge de l'entrée de journal et d'appliquer la durée de conservation des journaux.
receiveTimestamp string (Timestamp format)

Heure à laquelle l'entrée de journal a été reçue par Logging.
jsonPayload ResourceMaintenance

Charge utile contenant des informations sur la maintenance des ressources.
jsonPayload.@type string

Définition du type de charge utile.
Égal à : type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog
jsonPayload.name string

 Identifiant. Nom de la ressource Maintenance. Format : "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

 : sortie uniquement. "Name" fait référence à la ressource consommateur concernée par la maintenance. Pour connaître les valeurs disponibles, consultez Noms des composants.
jsonPayload.resource.location string

 : sortie uniquement. Emplacement de la ressource. Format : us-central1.
jsonPayload.resource.type string

 : sortie uniquement. Type de ressource. Pour connaître les valeurs disponibles, consultez les types de ressources des services compatibles.
jsonPayload.maintenance object

 Uniquement en sortie. Détails de la maintenance.
jsonPayload.maintenance.maintenanceName string

 : nom de la ressource de maintenance correspondante suivant le schéma de dénomination standard : "{maintenance-id}".
jsonPayload.maintenance.title string

 : sortie uniquement. Titre de la maintenance.
jsonPayload.maintenance. description string

 Uniquement en sortie. Description de la maintenance.
jsonPayload.state enum

État de la maintenance :
SCHEDULED – Planifiée pour un intervalle spécifique. Pour la maintenance perturbatrice, elle doit respecter la stratégie de maintenance. Par exemple, les intervalles disponibles, les exclusions et la période de notification.
STARTED : la maintenance est en cours.
CANCELLED : n'est plus prévu, généralement lorsqu'une autre maintenance (par exemple, une mise à niveau vers une version plus récente) a déjà eu lieu ou que l'utilisateur a ignoré la maintenance.
SUCCEEDED : opération terminée.
jsonPayload.maintenanceScheduledStartTime string

 : sortie uniquement. Heure à laquelle la maintenance de la ressource est SCHEDULED.
utilise la norme RFC 3339, où le résultat généré se sert toujours du format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés.
Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceScheduledEndTime string

 Uniquement en sortie. Heure à laquelle la maintenance de la ressource devait se terminer.
utilise la norme RFC 3339, où le résultat généré se sert toujours du format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés.
Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceStartTime string

 Uniquement en sortie. Heure à laquelle la maintenance de la ressource a STARTED.
utilise la norme RFC 3339, où le résultat généré se sert toujours du format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés.
Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceEndTime string

 Uniquement en sortie. Heure à laquelle la maintenance de la ressource a SUCCEEDED.
utilise la norme RFC 3339, où le résultat généré se sert toujours du format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés.
Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceCancelTime string

 Uniquement en sortie. Heure à laquelle la maintenance de la ressource a été CANCELLED.
utilise la norme RFC 3339, où le résultat généré se sert toujours du format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés.
Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
jsonPayload.userControllable boolean

 Uniquement en sortie. Indique si l'utilisateur a un certain contrôle sur cette maintenance, soit de manière proactive avant sa planification avec une stratégie de maintenance, soit avec des contrôles réactifs après sa planification (voir le champ controls).
jsonPayload.controls object(MaintenanceControl)

 Sortie uniquement. Les contrôles de la maintenance.

Exemples de champs de journaux

L'exemple suivant montre une ressource 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"
}

Étapes suivantes