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

‫MySQL   |  PostgreSQL   |  SQL Server

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

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

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

הצגת יומן ביקורת

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

המסוף

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 .

   הביטוי הראשון מסנן את יומני הביקורת System Event. הביטוי השני מסנן את יומני הביקורת של גיבויים אוטומטיים. מסנני הביטוי הסופיים ליומני ביקורת של מכונות 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 .

   הביטוי הראשון מסנן את יומני הביקורת System Event. הביטוי השני מסנן את יומני הביקורת של גיבויים אוטומטיים. מסנני הביטוי הסופיים ליומני ביקורת של מכונות 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, ‏ Cloud SQL יוצר עוד יומן ביקורת עם השדה windowStatus שמוגדר לערך STATUS_FAILED.

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

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

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

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

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

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