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

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

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

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

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

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

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

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

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

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

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

    כניסה ל-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 Insights אוספת מדדים של עומס מסד הנתונים, כולל מספר החיבורים והעסקאות שמקובצים לפי מצב, מספר השאילתות הפעילות שמקובצות לפי משך זמן הריצה (<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