Unified Maintenance log schema

כדי ליצור מדיניות התראות ולסנן יומנים, צריך להשתמש בשפת השאילתות של Logging. בטבלה הבאה מפורטים השדות במשאב Unified Maintenance ‏ResourceMaintenance. משתמשים בשדות האלה כדי לכתוב פעולות של שאילתות למשאבי Unified Maintenance.

סכימת יומן של ResourceMaintenance

שדות
resource MonitoredResource
resource.type string

מגדירים את סוג המשאב במעקב של משאב היעד. לדוגמה, מופע Cloud SQL: ‏ cloudsql_database
resource.labels map (key: string, value: string)

תוויות שמזהות באופן ייחודי משאב יעד (רשימת התוויות זמינה במאמר סוגי משאבים במעקב).
labels map (key: string, value: string)

צמד מפתח/ערך שמשמש לסינון רשומות ביומן. מפתחות אפשריים:

maintenance.googleapis.com/new_resource_maintenance – הערך מוגדר כ-True ברשומה הראשונה ביומן עבור ResourceMaintenance

maintenance.googleapis.com/updated_fields – רשימה של שדות ResourceMaintenance שעודכנו, לדוגמה:
"['state','maintenanceScheduledStartTime','maintenanceScheduledEndTime']"
insertId string

מזהה ייחודי של רשומת היומן.
timestamp ‫string (Timestamp format)

השעה שבה התרחש האירוע שמתואר ברשומה ביומן. השעה הזו משמשת לחישוב הגיל של רשומת היומן ולאכיפה של תקופת השמירה של היומנים.
receiveTimestamp string (Timestamp format)

השעה שבה רשומת היומן התקבלה ב-Logging.
jsonPayload ResourceMaintenance

מטען ייעודי (payload) עם פרטי תחזוקת המשאב.
jsonPayload.@type string

הגדרת הסוג של המטען הייעודי (Payload).
שווה ל: type.googleapis.com/google.cloud.maintenance.logging.v1beta.ResourceMaintenanceLog
jsonPayload.name string

מזהה. השם של משאב resourceMaintenance. פורמט: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
jsonPayload.resource.resourceName string

פלט בלבד. השם הוא ההפניה למשאב הצרכני שהושפע מהתחזוקה. לרשימת הערכים הזמינים, אפשר לעיין במאמר בנושא שמות נכסים.
jsonPayload.resource.location string

פלט בלבד. המיקום של המשאב. פורמט: us-central1
jsonPayload.resource.type string

פלט בלבד. סוג המשאב. במאמר בנושא שירותים נתמכים מפורטים סוגי המשאבים שזמינים.
jsonPayload.maintenance object

פלט בלבד. פרטי התחזוקה.
jsonPayload.maintenance.maintenanceName ‫string

השם של משאב התחזוקה התואם, לפי סכמת השמות הרגילה: "{maintenance-id}".
jsonPayload.maintenance.title string

פלט בלבד. השם של התחזוקה.
jsonPayload.maintenance. description string

פלט בלבד. תיאור התחזוקה.
jsonPayload.state enum

מצב התחזוקה:
SCHEDULED – מתוכננת לחלון זמן מסוים. במקרה של תחזוקה שגורמת לשיבושים, צריך לפעול בהתאם למדיניות התחזוקה. לדוגמה, חלונות הזמינות, ההחרגות ותקופת ההתראות.‫
STARTED – מתבצעת תחזוקה.
CANCELLED - כבר לא מתוכננת, בדרך כלל כשפעולות תחזוקה אחרות (למשל שדרוג לגרסה חדשה יותר) כבר בוצעו, או שהמשתמש דילג על התחזוקה.‫
SUCCEEDED – הושלם בהצלחה.
jsonPayload.maintenanceScheduledStartTime string

פלט בלבד. השעה שבה מתבצעת התחזוקה במשאב SCHEDULED.
משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד עובר נורמליזציה ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות חלקיות. מותר להשתמש גם בהיסטים אחרים מלבד 'Z'.
דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceScheduledEndTime string

פלט בלבד. השעה שבה נקבע שהתחזוקה של המשאב תסתיים.
משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד עובר נורמליזציה ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות חלקיות. מותר להשתמש גם בהיסטים אחרים מלבד 'Z'.
דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceStartTime string

פלט בלבד. השעה שבה STARTED התחזוקה של המשאב.
משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד עובר נורמליזציה ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z.
דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceEndTime string

פלט בלבד. השעה שבה SUCCEEDED התחזוקה של המשאב.
משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד עובר נורמליזציה ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות חלקיות. מותר להשתמש גם בהיסטים אחרים מלבד 'Z'.
דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
jsonPayload.maintenanceCancelTime string

פלט בלבד. השעה שבה תחזוקת המשאב הייתה CANCELLED.
משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד עובר נורמליזציה ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות חלקיות. מותר להשתמש גם בהיסטים אחרים מלבד 'Z'.
דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
jsonPayload.userControllable boolean

פלט בלבד. המדיניות מציינת אם למשתמש יש שליטה מסוימת על התחזוקה, באופן יזום לפני שהתחזוקה תוכננה באמצעות מדיניות התחזוקה, או באמצעות אמצעי בקרה תגובתיים אחרי שהיא תוכננה (ראו את השדה controls).
jsonPayload.controls ‫object(MaintenanceControl)

פלט בלבד. אמצעי הבקרה של התחזוקה.

שדות יומן לדוגמה

בדוגמה הבאה מוצג משאב 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"
}

המאמרים הבאים