צפייה ביומני ביקורת של גיבויים אוטומטיים

MySQL   |  PostgreSQL   |  SQL Server

בדף הזה מוסבר איך לצפות ביומן הביקורת של גיבוי אוטומטי של מכונת Cloud SQL.

אתם יכולים להשתמש ביומני ביקורת כדי:

• כדי לוודא שהגיבוי הושלם בהצלחה, אפשר לעיין ביומן הביקורת.
• מגדירים התראה מבוססת-יומן כדי לקבל עדכון על סטטוס הגיבוי.

איך צופים ביומן ביקורת

אתם יכולים להשתמש במסוף Google Cloud , ב-gcloud CLI או ב-API כדי להציג יומן ביקורת ולוודא שהגיבוי הושלם בהצלחה בחלון הגיבוי.

המסוף

1. במסוף Google Cloud , בוחרים באפשרות Logging ואז ב-Logs Explorer.

   כניסה לדף Logs Explorer

2. כדי לסנן את יומני הביקורת של גיבויים אוטומטיים של מכונות Cloud SQL, מריצים את השאילתה הבאה:

   logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event"
   protoPayload.methodName="cloudsql.instances.automatedBackup"
   resource.type="cloudsql_database"

   מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

   הביטוי הראשון מסנן את יומני הביקורת של אירועי המערכת. הביטוי השני מסנן את יומני הביקורת של הגיבויים האוטומטיים. הביטוי הסופי מסנן את יומני הביקורת של מכונות Cloud SQL.

   מידע נוסף על השימוש במסוף Google Cloud לשליחת שאילתות ביומני הביקורת זמין במאמר הצגת יומנים.

3. לראות את הסטטוס של גיבוי שנוצר במהלך חלון הגיבוי. הסטטוס הזה מוצג בשדה windowStatus. כדי לראות את השדה הזה:

   1. לוחצים על יומן הביקורת.
   2. לוחצים על השדה metadata.

gcloud

1. כדי לסנן את יומני הביקורת של גיבויים אוטומטיים של מכונות Cloud SQL, מריצים את השאילתה הבאה:

   gcloud logging read \
   "logName=projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Fsystem_event
   AND protoPayload.methodName=cloudsql.instances.automatedBackup AND
   resource.type=cloudsql_database" \ 
       --project=PROJECT_NAME

   מחליפים את PROJECT_NAME בשם הפרויקט ב- Google Cloud .

   הביטוי הראשון מסנן את יומני הביקורת של אירועי המערכת. הביטוי השני מסנן את יומני הביקורת של הגיבויים האוטומטיים. הביטוי הסופי מסנן את יומני הביקורת של מכונות Cloud SQL.

   למידע נוסף על השימוש ב-gcloud כדי לשלוח שאילתות ליומני ביקורת, קראו את המאמר הצגת יומנים.

2. לראות את הסטטוס של גיבוי שנוצר במהלך חלון הגיבוי. הסטטוס הזה מוצג בשדה windowStatus.

API

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

בגוף הבקשה ב-JSON, הביטוי הראשון מסנן את יומני הביקורת System Event. הביטוי השני מסנן את יומני הביקורת של הגיבויים האוטומטיים. הביטוי האחרון מסנן את יומני הביקורת של מכונות Cloud SQL.

מידע נוסף על השימוש ב-API לשליחת שאילתות על יומני ביקורת זמין במאמר הצגת יומנים.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://logging.googleapis.com/v2/entries:list

תוכן בקשת JSON:

{
     "resourceNames": [
     "projects/PROJECT_ID"
      ],
     "pageSize": 5,
     "filter": "logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event AND protoPayload.methodName = cloudsql.instances.automatedBackup AND resource.type=cloudsql_database",
     "orderBy": "timestamp desc"
} 

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://logging.googleapis.com/v2/entries:list"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://logging.googleapis.com/v2/entries:list" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "entries": [
    {
      "protoPayload": {
        "@type": "type.googleapis.com/google.cloud.audit.AuditLog",
        "status": {
          "message": "OK"
        },
        "authenticationInfo": {},
        "requestMetadata": {
          "requestAttributes": {},
          "destinationAttributes": {}
        },
        "serviceName": "cloudsql.googleapis.com",
        "methodName": "cloudsql.instances.automatedBackup",
        "resourceName": "projects/PROJECT_ID/instances/INSTANCE_NAME",
        "metadata": {
          "windowStartTime": "2022-12-15T13:00:00Z",
          "message": "",
          "windowStatus": "STATUS_SUCCEEDED",
          "@type": "type.googleapis.com/speckle.AutomatedBackupEventLog",
          "windowEndTime": "2022-12-15T17:00:00Z",
          "backupCompletionTime": "2022-12-15T14:11:57.347Z",
          "backupStartTime": "2022-12-15T14:11:16.631Z"
        }
      },
      "insertId": "LOG_ENTRY_UNIQUE_IDENTIFIER",
      "resource": {
        "type": "cloudsql_database",
        "labels": {
          "region": "REGION_NAME",
          "project_id": "PROJECT_ID",
          "database_id": "DATABASE_ID"
        }
      },
      "timestamp": "2022-12-15T14:11:57.391565Z",
      "severity": "INFO",
      "logName": "projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event",
      "receiveTimestamp": "2022-12-15T14:11:57.785814800Z"
    },
 ],
}

למידע נוסף על LOG_ENTRY_UNIQUE_IDENTIFIER בשדה insertId, קראו את המאמר LogEntry.

לראות את הסטטוס של גיבוי שנוצר במהלך חלון הגיבוי. הסטטוס הזה מוצג בשדה windowStatus.

סטטוסים של גיבוי אוטומטי

• ‫STATUS_SUCCEEDED: הגיבוי האוטומטי הושלם בהצלחה.

• ‫STATUS_ATTEMPT_FAILED: המערכת של Cloud SQL ניסתה ליצור את הגיבוי, אבל הגיבוי לא התחיל או נכשל. סיבות אפשריות לסטטוס הזה:

  • גיבוי אחר פועל במכונה.
  • מיקום הגיבוי מוגבל על ידי מדיניות הארגון.
  • הגיבוי של המכונה הושלם, אבל אירעה שגיאה.
  • המכונה לא פעלה כש-Cloud SQL ניסה ליצור את הגיבוי.

• ‫STATUS_FAILED: הגיבוי האוטומטי של המכונה לא הושלם או שלא ניתן להשלים אותו בחלון הגיבוי.

  לדוגמה, אם הפעלתם גיבויים אוטומטיים ותזמנתם את חלון הגיבוי בין 1:00 ל-5:00, יכול להיות שהגיבוי ייכשל אם יש לכם הרבה פעולות EXPORT במסגרת הזמן הזו. יכול להיות שגיבויים אוטומטיים ייכשלו גם אם יש יותר מדי התנגשויות עם פעולת EXPORT שפועלת במשך זמן רב.

  אם Cloud SQL מנסה ליצור גיבוי כמה פעמים במהלך חלון הגיבוי, אבל הגיבוי לא נוצר מהסיבות שמפורטות ב-STATUS_ATTEMPT_FAILED, המערכת יוצרת עוד יומן ביקורת שבו השדה windowStatus מוגדר ל-STATUS_FAILED.

• ‫STATUS_SKIPPED: המכונה של Cloud SQL הפסיקה לפעול מאז הגיבוי האחרון שהצליח. לכן לא נוצר גיבוי אוטומטי חדש.

הגדרת התראה מבוססת-יומן

אתם יכולים להגדיר התראה מבוססת-יומן כדי לקבל הודעה על סטטוס הגיבוי.

• אם לגיבוי יש סטטוס STATUS_SUCCEEDED, אפשר לקבל התראה למטרות מעקב.
• אם הגיבוי בסטטוס STATUS_FAILED או STATUS_ATTEMPT_FAILED, יכול להיות שתקבלו התראה לבצע פעולה לתיקון, בהתאם להודעה שמופיעה ברשומת היומן. אתם יכולים גם לבצע גיבוי לפי דרישה לפני חלון הזמן הבא שנקבע לגיבוי.
• אם הסטטוס של הגיבוי הוא STATUS_SKIPPED, יכול להיות שתקבלו הודעה להפעיל מחדש את המכונה של Cloud SQL.

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

• מידע נוסף על גיבוי הנתונים
• מידע נוסף על יצירה וניהול של גיבויים
• מידע נוסף על שחזור נתונים
• מידע נוסף על שחזור מערכת מנקודה מסוימת בזמן (PITR)
• איך משחזרים את הנתונים מהגיבוי
• איך מבצעים שחזור מערכת מנקודה מסוימת בזמן (PITR)