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

התכונה 'תיעוד ביצועים' אוספת נתונים של מדדי מופעים ושולחת אותם אל 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.
  • ניצול גבוה של המעבד
  • שימוש גבוה בזיכרון
  • שימוש גבוה בקבצים זמניים
  • אורך רשימת ההיסטוריה
  • הפעלת שרשורים
  • המתנה לסמפור
  • המתנות של נעילת עסקאות
activequeries
סטטוס InnoDB מספק מידע על מצב מנוע האחסון InnoDB בזמן אירוע הביצועים. זה קריטי לאבחון של בעיות שקשורות לתחרות על נעילה, לטרנזקציות, למאגרים ולגידול באורך של רשימת ההיסטוריה. מילות מפתח שכדאי לחפש:
  • TRANSACTIONS (עסקאות ממושכות, המתנה לנעילה)
  • SEMAPHORES (התנגשות של mutex)
  • LATEST DETECTED DEADLOCK
  • BUFFER POOL AND MEMORY
  • HISTORY LIST LENGTH
מידע נוסף על הפלט של InnoDB standard monitor זמין במאמר InnoDB Standard Monitor and Lock Monitor Output במסמכי התיעוד של MySQL.
innodbstatus
ניתוח שכפול מכיל מידע אבחוני לגבי שכפול, כולל הפלט של SHOW REPLICA STATUS, ערכות GTID ופרטים מכלי סכימת הביצועים. הדוח כולל גם את חמשת האירועים הראשונים מיומן ההעברה אחרי מיקום הביצוע בזמן אירוע הביצועים. אפשר להשתמש בדוח הזה כדי לאבחן שגיאות או עיכובים בשכפול.

מידע נוסף על הפלט של SHOW REPLICA STATUS ועל שרשורי העבודה של כלי הרפליקציה זמין במאמרי העזרה של MySQL בנושא SHOW REPLICA STATUS Statement ו- Monitoring Replication Applier Worker Threads.
  • שגיאה בשרשור קלט/פלט של SQL בעותק משוכפל
  • שניות אחרי המקור
replicastatus
ניתוח עסקאות פרטים על עסקאות ארוכות טווח שנמצאות במעקב.

מידע נוסף על פירוש נתונים לגבי עסקאות InnoDB זמין במאמר The INFORMATION_SCHEMA INNODB_TRX Table במסמכי העזרה של MySQL.
עסקאות ממושכות LongRunningTransactions
עסקאות שהסתיימו אוטומטית פרטים על עסקאות ארוכות טווח שהופסקו במחזור הבדיקה הנוכחי.

נתונים של סיום אוטומטי AutoTerminateTransaction

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

כשכלי תיעוד הביצועים מזהה בעיה על סמך סף שהוגדר למכונה של 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