צפייה ביומנים של תיעוד הביצועים

התכונה 'תיעוד ביצועים' אוספת נתונים של מדדי מופעים ושולחת אותם אל Cloud Logging בקובץ mysql-performance-capture.log.

מידע נוסף על צפייה ביומנים ב-Cloud Logging זמין במאמר צפייה ביומנים באמצעות Logs Explorer.

לפני שמתחילים

כדי לצפות ביומנים של תיעוד הביצועים, צריך להיות לכם את ההרשאות המתאימות לצפייה ביומנים ב-Cloud Logging עבור הפרויקט והאירוע.

תפקידים והרשאות נדרשים

כדי לקבל את ההרשאות שנדרשות לצפייה ביומני תיעוד הביצועים, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Logs Viewer (roles/logging.viewer) בפרויקט של המכונה. להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

צפייה ביומנים של תיעוד הביצועים

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

  1. נכנסים לדף Cloud Logging במסוף Google Cloud .

    כניסה ל-Cloud Logging

  2. לוחצים על All resources (כל המשאבים) ואז בוחרים באפשרות Cloud SQL Database (מסד נתונים של Cloud SQL).
  3. בוחרים את המופע של Cloud SQL.

  4. מסנן לשם היומן:

    logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"

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

    מטען הייעודי (payload) של היומן הוא בפורמט מחרוזת ומכיל את הפלט של פקודות שנתפסו כמו SHOW ENGINE INNODB STATUS, שמתפרסות על פני כמה שורות ביומן.

בדיקת הנתונים ביומן של נתוני הביצועים

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

רשומה ביומן של תיעוד הביצועים תיאור טריגר של ערך סף שם הדוח
שאילתות פעילות מערכת Cloud SQL מנטרת מדדי עומס של מסד הנתונים, כולל מספר החיבורים ומספר העסקאות שמקובצים לפי מצב, מספר השאילתות הפעילות שמקובצות לפי משך זמן הריצה (פחות מ-2 שניות, 2 עד 10 שניות, 10 שניות ומעלה), ומידע מפורט על 50 העסקאות או השאילתות עם משך זמן הריצה הארוך ביותר. הדוח הזה עוזר לזהות תקופות של עומס גבוה ולאתר שאילתות ספציפיות שפועלות לאט.

מידע נוסף על פירוש נתונים לגבי טרנזקציות ותהליכים של InnoDB זמין במאמרים The INFORMATION_SCHEMA INNODB_TRX Table ו-The processlist Table במסמכי התיעוד של MySQL.
  • ‫runningThreadsThreshold (Cloud SQL Admin API)
  • ‫running-threads-threshold (ה-CLI של gcloud)
 activequeries
סטטוס InnoDB מספק מידע על המצב של מנוע האחסון InnoDB בזמן אירוע הביצועים. זה קריטי לאבחון של מחלוקות על נעילה, בעיות בעסקאות, בעיות במאגר הנתונים וגידול באורך של רשימת ההיסטוריה. מילות מפתח שכדאי לחפש:
  • TRANSACTIONS (עסקאות ממושכות, המתנה לנעילה)
  • SEMAPHORES (mutex contention)
  • LATEST DETECTED DEADLOCK
  • BUFFER POOL AND MEMORY
  • HISTORY LIST LENGTH
מידע נוסף על הפלט של InnoDB standard monitor זמין במאמר InnoDB Standard Monitor and Lock Monitor Output במסמכי העזרה של MySQL.
  • ‫runningThreadsThreshold (Cloud SQL Admin API)
  • ‫running-threads-threshold (ה-CLI של gcloud)
 innodbstatus
ניתוח שכפול מכיל מידע אבחוני לגבי שכפול, כולל הפלט של SHOW REPLICA STATUS, ערכות GTID ופרטים מכלי סכימת הביצועים. הדוח כולל גם את חמשת האירועים הראשונים מיומן ההעברה אחרי מיקום ההרצה בזמן אירוע הביצועים. אפשר להשתמש בדוח הזה כדי לאבחן שגיאות או עיכובים בשכפול.

מידע נוסף על הפלט של SHOW REPLICA STATUS ועל שרשורי העבודה של העתקת האפליקציה זמין במאמרים SHOW REPLICA STATUS Statement ו Monitoring Replication Applier Worker Threads בתיעוד של MySQL.
  • ‫secondsBehindSourceThreshold (Cloud SQL Admin API)
  • ‫seconds-behind-source-threshold (ה-CLI של gcloud)
 replicastatus
נתונים של כלי המעקב אחר עסקאות פרטים על עסקאות ארוכות טווח שנמצאות במעקב.

מידע נוסף על פירוש נתונים לגבי עסקאות InnoDB זמין במאמר The INFORMATION_SCHEMA INNODB_TRX Table במסמכי העזרה של MySQL.
  • ‫transactionDurationThreshold (Cloud SQL Admin API)
  • ‫transaction-duration-threshold (ה-CLI של gcloud)
 LongRunningTransactions

סינון הנתונים ביומן של תיעוד הביצועים

כשכלי תיעוד הביצועים מזהה בעיה על סמך סף שהוגדר למכונת Cloud SQL, סוכן המעקב שולח ל-Cloud Logging רשומות ביומן עם תוויות שמשויכות למכונה ולסוג הדוח.

כדי לעזור לכם למיין את היומנים ולמצוא קשר בין רשומות ביומן לבין בעיות בביצועים שנצפו במופע, אתם יכולים לסנן את הרשומות ביומן של תיעוד הביצועים לפי תווית.

כל רשומה ביומן מסומנת בשתי התוויות הבאות:

  • השעה של האירוע, או labels.EVENT_TIME: מציין את השעה של רשומת יומן הלכידה של הביצוע. הפורמט הוא מחרוזת ייחודית של חותמת זמן YYYY-MM-DDTHH:MM:SSZ. לדוגמה, 2025-10-16T13:12:07Z.

  • שם הקובץ או labels.FILE_NAME: מזהה את סוג הדוח ואת המספר הסידורי של רשומת יומן לתיעוד הביצועים שהופעלה על ידי אירוע ביצועים. הפורמט הוא INSTANCE_TYPE_SEQUENCE_NUMBER_REPORT_TYPE. לדוגמה, primary_1_activequeries, שהוא הרשומה הראשונה ביומן של דוח פעיל של שאילתות.

דוגמאות למסננים

בקטע הזה מפורטות דוגמאות לאופן סינון הקובץ mysql-performance-capture.log לפי רשומות יומן ספציפיות לצורך ניתוח.

בדוגמאות הבאות, מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט של מופע Cloud SQL
  • ‫TIMESTAMP: חותמת זמן של אירוע הביצועים שהפעיל את הדוח, בפורמט YYYY-MM-DDTHH:MM:SSZ. לדוגמה, 2025-10-16T13:12:07Z

סינון לפי אירוע ביצועים ספציפי

כדי לסנן לפי אירוע ביצועים ספציפי, משתמשים בתווית labels.EVENT_TIME כדי למצוא רשומות ביומן שקשורות לאירוע.

לדוגמה, כדי לקבל דוחות על אירוע ביצועים ספציפי, משתמשים בשאילתות הבאות בכלי ליצירת שאילתות ב-Logs Explorer של Logging.

קבלת כל הדוחות על אירוע ספציפי

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.EVENT_TIME="TIMESTAMP"

קבלת דוח InnoDB לאירוע ספציפי

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.EVENT_TIME="TIMESTAMP"
labels.FILE_NAME=~"innodbstatus"

קבלת רק הרשומה הראשונה ביומן לכל סוגי הדוחות עבור אירוע ספציפי

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.EVENT_TIME="TIMESTAMP"
labels.FILE_NAME=~"_1_"

סינון לפי שמות קבצים

קבלת כל הדוחות של activequeries בכל האירועים

השאילתה הכללית הזו שימושית כדי לראות איך נראות שאילתות פעילות במהלך אירוע שקשור לביצועים.

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.FILE_NAME=~"activequeries"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט של מופע Cloud SQL

השוואה בין הדוחות הראשון והשלישי של innodbstatusאירוע ספציפי

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.EVENT_TIME="TIMESTAMP"
(labels.FILE_NAME="primary_1_innodbstatus" OR labels.FILE_NAME="primary_3_innodbstatus")

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט של מופע Cloud SQL
  • ‫TIMESTAMP: חותמת זמן של אירוע הביצועים שהפעיל את הדוח, בפורמט YYYY-MM-DDTHH:MM:SSZ. לדוגמה, 2025-10-16T13:12:07Z

חיפוש הדוח הראשון מסוג activequeries לכל אירוע שהתרחש אחרי זמן מסוים

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.FILE_NAME="primary_1_activequeries"
timestamp > "TIMESTAMP"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט של מופע Cloud SQL
  • ‫TIMESTAMP: חותמת זמן בפורמט ‫YYYY-MM-DDTHH:MM:SSZ. לדוגמה, 2025-10-16T13:12:07Z

חיפוש טקסט ספציפי בדוח סטטוס של InnoDB

logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
labels.FILE_NAME=~"innodbstatus"
textPayload:"SEARCH_TEXT"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט של מופע Cloud SQL
  • ‫SEARCH_TEXT: הטקסט שרוצים לחפש. לדוגמה, SEMAPHORE WAITS