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

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

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

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

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

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

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

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

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

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

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

    כניסה ל-Cloud Logging

  2. לוחצים על All resources ובוחרים באפשרות Cloud SQL Database.
  3. בוחרים את המכונה של Cloud SQL.
  4. מסננים לפי שם היומן:

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

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

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

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

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

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

למידע נוסף על פירוש הנתונים של טרנזקציות ותהליכים של InnoDB, קראו את המאמרים The INFORMATION_SCHEMA INNODB_TRX Table ו-The processlist Table במסמכי התיעוד של MySQL.
  • ניצול גבוה של המעבד (CPU)
  • שימוש גבוה בזיכרון
  • שימוש רב בקבצים זמניים
  • אורך רשימת ההיסטוריה
  • שרשורים פעילים
  • המתנות של סמפור
  • המתנות לנעילת עסקאות
activequeries
סטטוס InnoDB מספק מידע על המצב של מנוע האחסון InnoDB בזמן אירוע הביצועים. זה קריטי לאבחון של תחרות על נעילות, בעיות בעסקאות, בעיות במאגר ה-buffer וגידול באורך של רשימת ההיסטוריה. מילות מפתח שכדאי לחפש:
  • ‫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 ועל ה-threads עובדים של ממשק ההחלה של הרפליקציה, קראו את המאמרים SHOW REPLICA STATUS Statement ו-Monitoring Replication Applier Worker Threads במסמכי התיעוד של MySQL.
  • שגיאה בשרשור הקלט/פלט של SQL ברפליקה
  • שניות אחרי המקור
replicastatus
ניתוח עסקאות פרטים על העסקאות הארוכות שנמצאות במעקב.

למידע נוסף על פירוש הנתונים של טרנזקציות InnoDB, קראו את המאמר הטבלה INFORMATION_SCHEMA INNODB_TRX במסמכי התיעוד של 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 כדי למצוא רשומות ביומן שקשורות לאירוע.

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

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

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