הגדרת תיעוד הביצועים

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

הנחיות להגדרת טריגרים לתיעוד ביצועים

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

  • הטריגרים הבאים להקלטת ביצועים מושבתים כברירת מחדל:

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

    אם הגדרתם סף לאחד מהטריגרים האלה אבל אתם רוצים להשבית את הטריגר, צריך להגדיר את ערך הסף ל-0.

  • כדי למנוע לכידות מוגזמות, כדאי להגדיר את ערכי הסף של הטריגרים על סמך היסטוריית הביצועים.

    מומלץ להגדיר את ערכי הסף לקצה הגבוה של הטווח ההיסטורי (לדוגמה, מעל עומס העבודה היומי המקסימלי הרגיל).

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

    • עלויות גבוהות יותר ותקורה של רישום ביומן: יומנים מיותרים יכולים להגדיל במהירות את העלויות של Cloud Logging.
    • מצב שינה עם תקופת צינון ממושכת: אם מופעלת באותו מופע הפרה חוזרת של אותו סף, מופעל מנגנון נסיגה אדפטיבי של תקופת צינון. הפעולה הזו מעבירה את התכונה 'תיעוד ביצועים' למצב שינה למשך 24 שעות, שבו מושעים כל הבדיקות והאבחונים של הטריגרים. אם יתרחש אירוע קריטי אמיתי, קיים סיכון לאובדן נתונים חשובים לצורך אבחון במהלך מצב השינה הזה.

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

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

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

כדי לקבל את ההרשאות שנדרשות לשינוי מכונה ולהפעלת תיעוד הביצועים, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:

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

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

הפעלת תיעוד הביצועים

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

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

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

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

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
  3. בקטע התאמה אישית של המופע, לוחצים על הצגת אפשרויות ההגדרה.
  4. מרחיבים את התובנות לגבי שאילתות.
  5. מסמנים את התיבה הפעלת תובנות לגבי שאילתות.
  6. בקטע Enable additional features, מוודאים שתיבת הסימון Performance capture מסומנת.
  7. לוחצים על Save.

הגדרת תיעוד הביצועים

אתם יכולים להגדיר את תיעוד הביצועים, למשל להגדיר ספי טריגר ספציפיים, כשאתם יוצרים או עורכים את המכונה באמצעות ה-CLI של gcloud או Cloud SQL Admin API. שינוי ההגדרה של לכידת ביצועים או של סף להפעלת לכידת ביצועים לא מפעיל מחדש את המכונה ולא גורם למכונה לעבור לתחזוקה.

בקטע הבא מוסבר איך לערוך מופע קיים כדי להגדיר את תהליך איסוף נתוני הביצועים.

gcloud

כדי להגדיר את התכונה 'תיעוד ביצועים' במכונת Cloud SQL קיימת, מריצים את הפקודה הבאה:

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="enabled=true,PROBE_CONFIGURATION,PERFORMANCE_CAPTURE_THRESHOLDS"

בשביל הדגל performance-capture-config, מוסיפים enabled=true. באותו דגל, אפשר לציין הגדרות אופציונליות ל-PROBE_CONFIGURATION ול-PERFORMANCE_CAPTURE_THRESHOLDS.

אפשר גם להשתמש בפקודה gcloud sql instances patch כדי לשנות את ערכי הסף של ההגדרות לתיעוד הביצועים במכונה קיימת.

הגדרת מרווח הזמן בין בדיקות וסדרת בדיקות של מדדי ביצועים

אפשר להחליף את PROBE_CONFIGURATION באחת מההגדרות הבאות של הדגל או בשתיהן. אם לא מגדירים את הדגלים, סוכן המעקב משתמש בערך ברירת המחדל.

  • ‫probing-interval-seconds=SECONDS: מספר שלם בין 20 ל-86400. מרווח הזמן בשניות בין בדיקות המדדים. לדוגמה, 30, ‏ 60, ‏ 100. ברירת המחדל היא 30.
  • ‫probe-threshold=PROBES: מספר הפעמים הרצופות שצריך לחרוג מסף מסוים כדי להפעיל את תיעוד הביצועים. הטווח התקין הוא 1 עד 20. ברירת המחדל היא 3.

הגדרת ספי ביצועים

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

  • ‫running-threads-threshold=THREADS: המספר המינימלי של שרשורים פעילים שנחשב מעל הסף, עבור מופעים ראשיים או מופעים משוכפלים. לדוגמה, 10. הערך חייב להיות גדול מ-10 או שווה לו. אם לא מגדירים את הערך, ברירת המחדל מבוססת על גודל המופע. ברירת המחדל היא MIN(600, cpuCount * 20).
  • ‫seconds-behind-source-threshold=SECONDS : לגבי עותקים לקריאה, השהיית השכפול המינימלית, בשניות, שנחשבת מעל הסף. הערך חייב להיות גדול מ-1. ברירת המחדל היא 900.
  • ‫transaction-duration-threshold=SECONDS: משך הזמן, בשניות, של טרנזקציה שלא בוצעה לפני שהטרנזקציה מתועדת ונכללת ביומן של תיעוד הביצועים. לדוגמה, 300. הערך המינימלי הוא 60. ברירת המחדל היא 3600. יש לכם גם אפשרות לסיים אוטומטית טרנזקציות שפועלות במשך זמן רב.
  • ‫cpu-utilization-threshold-percent=CPU_PERCENTAGE: אחוז השימוש הכולל במעבד שחורג באופן עקבי. לדוגמה, 90. הערך המינימלי הוא 10 והערך המקסימלי הוא 99. ברירת המחדל היא 0 (מושבת).
  • ‫memory-usage-threshold-percent=MEMORY_PERCENTAGE: אחוז השימוש הכולל בזיכרון שצריך לעבור באופן עקבי. לדוגמה, 90. הערך המינימלי הוא 10 והערך המקסימלי הוא 99. ברירת המחדל היא 0 (מושבת).
  • ‫transaction-lock-wait-threshold-count=TRANSACTION_COUNT: ערך הסף לעסקאות שמותר להן להיות במצב `LOCK WAIT`. לדוגמה, 50. הערך המינימלי הוא 10 והערך המקסימלי הוא 10000. ברירת המחדל היא 0 (מושבת).
  • semaphore-wait-threshold-count=SEMAPHORE_THREAD_COUNT: the threshold for the number of threads waiting on InnoDB semaphores from the SHOW ENGINE INNODB STATUS command. לדוגמה, 20. הערך המינימלי הוא 10 והערך המקסימלי הוא 10000. ברירת המחדל היא 0 (מושבת).
  • ‫history-list-length-threshold-count=HISTORY_LIST_LENGTH_COUNT: ערך הסף של מספר הרשומות ברשימת ההיסטוריה של InnoDB (HLL) שמותר למסד הנתונים. לדוגמה, 100000. הערך המינימלי הוא 10000 והערך המקסימלי הוא 10000000. ברירת המחדל היא 0 (מושבת).

REST v1

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

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

  • ‫PERFORMANCE_CAPTURE_ENABLED: צריך להגדיר את הערך true כדי להפעיל את תכונת תיעוד הביצועים של המופע.
  • ‫PROBING_INTERVAL_SECONDS: מספר שלם בין 30 ל-86400. מרווח הזמן בשניות בין בדיקות המדדים. ברירת המחדל היא 30.
  • ‫PROBE_THRESHOLD: מספר הפעמים הרצופות שצריך לחרוג מסף מסוים כדי להפעיל את תיעוד הביצועים. הטווח התקין הוא 1 עד 20. ברירת המחדל היא 3.
  • ‫RUNNING_THREADS_THRESHOLD: במופעים ראשיים, מספר השרשורים הפעילים המינימלי שנחשב מעל הסף. לדוגמה, 10. הערך חייב להיות גדול מ-10 או שווה לו. אם לא מגדירים את הערך, ברירת המחדל מבוססת על גודל המופע. ברירת המחדל היא MIN(600, cpuCount * 20).
  • ‫SECONDS_BEHIND_SOURCE_THRESHOLD: לגבי העתקים לקריאה, השהיית השכפול המינימלית בשניות, שנחשבת מעל ערך הסף. הערך חייב להיות גדול מ-1. ברירת המחדל היא 900.
  • ‫TRANSACTION_DURATION_THRESHOLD: משך הזמן, בשניות, של טרנזקציה לא מחויבת לפני שהמערכת עוקבת אחריה וכוללת אותה ביומן של תיעוד הביצועים. לדוגמה, 300. הערך המינימלי הוא 60. ברירת המחדל היא 3600. אם רוצים להגדיר סיום אוטומטי של טרנזקציות שפועלות במשך זמן רב, אפשר לכלול הגדרות נוספות בשדה performanceCaptureConfig. מידע נוסף זמין במאמר בנושא סיום אוטומטי של טרנזקציות ממושכות.
  • ‫CPU_UTILIZATION_THRESHOLD_PERCENT: אחוז השימוש הכולל במעבד שחורג באופן עקבי. לדוגמה, 90. הערך המינימלי הוא 10 והערך המקסימלי הוא 99. ברירת המחדל היא 0 (מושבת).
  • ‫MEMORY_USAGE_THRESHOLD_PERCENT: אחוז השימוש הכולל בזיכרון שצריך לעבור באופן עקבי. לדוגמה, 90. הערך המינימלי הוא 10 והערך המקסימלי הוא 99. ברירת המחדל היא 0 (מושבת).
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: ערך הסף לעסקאות שמותר שיהיו במצב LOCK WAIT. לדוגמה, 50. הערך המינימלי הוא 10 והערך המקסימלי הוא 10000. ברירת המחדל היא 0 (מושבת).
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: the threshold for the number of threads waiting on InnoDB semaphores from the SHOW ENGINE INNODB STATUS command. לדוגמה, 20. הערך המינימלי הוא 10 והערך המקסימלי הוא 10000. ברירת המחדל היא 0 (מושבת).
  • ‫HISTORY_LIST_LENGTH_THRESHOLD_COUNT: ערך הסף של מספר הרשומות ברשימת ההיסטוריה של InnoDB (HLL) שמותר למסד הנתונים. לדוגמה, 100000. הערך המינימלי הוא 10000 והערך המקסימלי הוא 10000000. ברירת המחדל היא 0 (מושבת).

ה-method של ה-HTTP וכתובת ה-URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON: 

{
  "performanceCaptureConfig": {
     "enabled": PERFORMANCE_CAPTURE_ENABLED,
     "probingIntervalSeconds": PROBING_INTERVAL_SECONDS,
     "probeThreshold": PROBE_THRESHOLD,
     "runningThreadsThreshold": RUNNING_THREADS_THRESHOLD,
     "secondsBehindSourceThreshold": SECONDS_BEHIND_SOURCE_THRESHOLD,
     "transactionDurationThreshold": TRANSACTION_DURATION_THRESHOLD,
     "cpuUtilizationThresholdPercent": CPU_UTILIZATION_THRESHOLD_PERCENT,
     "memoryUsageThresholdPercent": MEMORY_USAGE_THRESHOLD_PERCENT,
     "transactionLockWaitThresholdCount": TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT,
     "semaphoreWaitThresholdCount": SEMAPHORE_WAIT_THRESHOLD_COUNT,
     "historyListLengthThresholdCount": HISTORY_LIST_LENGTH_THRESHOLD_COUNT
  },
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

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

  • ‫PERFORMANCE_CAPTURE_ENABLED: צריך להגדיר את הערך true כדי להפעיל את תכונת תיעוד הביצועים של המופע.
  • ‫PROBING_INTERVAL_SECONDS: מספר שלם בין 30 ל-86400. מרווח הזמן בשניות בין בדיקות המדדים. ברירת המחדל היא 30.
  • ‫PROBE_THRESHOLD: מספר הפעמים הרצופות שצריך לחרוג מסף מסוים כדי להפעיל את תיעוד הביצועים. הטווח התקין הוא 1 עד 20. ברירת המחדל היא 3.
  • ‫RUNNING_THREADS_THRESHOLD: במופעים ראשיים, מספר השרשורים הפעילים המינימלי שנחשב מעל הסף. לדוגמה: 10. הערך חייב להיות גדול מ-10 או שווה לו. אם לא מגדירים את הערך, ברירת המחדל מבוססת על גודל המופע. ברירת המחדל היא MIN(600, cpuCount * 20).
  • ‫SECONDS_BEHIND_SOURCE_THRESHOLD: לגבי העתקים לקריאה, השהיית השכפול המינימלית בשניות, שנחשבת מעל ערך הסף. הערך חייב להיות גדול מ-1. ברירת המחדל היא 900.
  • ‫TRANSACTION_DURATION_THRESHOLD: משך הזמן, בשניות, של טרנזקציה לא מחויבת לפני שהמערכת עוקבת אחריה וכוללת אותה ביומן של תיעוד הביצועים. לדוגמה, 300. הערך המינימלי הוא 60. ברירת המחדל היא 3600. אם רוצים להגדיר סיום אוטומטי של טרנזקציות שפועלות במשך זמן רב, אפשר לכלול הגדרות נוספות בשדה performanceCaptureConfig. מידע נוסף זמין במאמר בנושא סיום אוטומטי של טרנזקציות ממושכות.
  • ‫CPU_UTILIZATION_THRESHOLD_PERCENT: אחוז השימוש הכולל במעבד שחורג באופן עקבי. לדוגמה, 90. הערך המינימלי הוא 10 והערך המקסימלי הוא 99. ברירת המחדל היא 0 (מושבת).
  • ‫MEMORY_USAGE_THRESHOLD_PERCENT: אחוז השימוש הכולל בזיכרון שצריך לעבור באופן עקבי. לדוגמה, 90. הערך המינימלי הוא 10 והערך המקסימלי הוא 99. ברירת המחדל היא 0 (מושבת).
  • ‫TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: ערך הסף לעסקאות שמותר שיהיו במצב LOCK WAIT. לדוגמה, 50. הערך המינימלי הוא 10 והערך המקסימלי הוא 10000. ברירת המחדל היא 0 (מושבת).
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: the threshold for the number of threads waiting on InnoDB semaphores from the SHOW ENGINE INNODB STATUS command. לדוגמה, 20. הערך המינימלי הוא 10 והערך המקסימלי הוא 10000. ברירת המחדל היא 0 (מושבת).
  • ‫HISTORY_LIST_LENGTH_THRESHOLD_COUNT: ערך הסף של מספר הרשומות ברשימת ההיסטוריה של InnoDB (HLL) שמותר למסד הנתונים. לדוגמה, 100000. הערך המינימלי הוא 10000 והערך המקסימלי הוא 10000000. ברירת המחדל היא 0 (מושבת).

ה-method של ה-HTTP וכתובת ה-URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON: 

{
  "performanceCaptureConfig": {
     "enabled": PERFORMANCE_CAPTURE_ENABLED,
     "probingIntervalSeconds": PROBING_INTERVAL_SECONDS,
     "probeThreshold": PROBE_THRESHOLD,
     "runningThreadsThreshold": RUNNING_THREADS_THRESHOLD,
     "secondsBehindSourceThreshold": SECONDS_BEHIND_SOURCE_THRESHOLD,
     "transactionDurationThreshold": TRANSACTION_DURATION_THRESHOLD,
     "cpuUtilizationThresholdPercent": CPU_UTILIZATION_THRESHOLD_PERCENT,
     "memoryUsageThresholdPercent": MEMORY_USAGE_THRESHOLD_PERCENT,
     "transactionLockWaitThresholdCount": TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT,
     "semaphoreWaitThresholdCount": SEMAPHORE_WAIT_THRESHOLD_COUNT,
     "historyListLengthThresholdCount": HISTORY_LIST_LENGTH_THRESHOLD_COUNT
  },
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

סיום אוטומטי של עסקאות ממושכות

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

כדי להגדיר את מסד הנתונים של Cloud SQL ל-MySQL כך שיסיים באופן אוטומטי טרנזקציות שפועלות במשך זמן רב, משתמשים ב-ה-CLI של gcloud או ב-Cloud SQL Admin API.

gcloud

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

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="transaction-kill-threshold-seconds=SECONDS"

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

  • ‫INSTANCE_NAME: השם של המכונה.
  • ‫SECONDS: מגבלת משך הזמן, בשניות, שקובעת מתי לסיים אוטומטית את העסקה ארוכת הטווח. אי אפשר להגדיר את המגבלה הזו לערך שקטן מהערך שהגדרתם לטריגר transaction-duration-threshold או transactionDurationThreshold.

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

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="transaction-kill-threshold-seconds=SECONDS,transaction-kill-type=TRANSACTION_TYPE,transaction-kill-excluded-user-hosts=EXCLUSION_LIST"

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

  • ‫TRANSACTION_TYPE: קובע את קטגוריות העסקאות שיש לסיים. מציינים אחד מהערכים הבאים:
    • ‫READ_ONLY_TRANSACTIONS: מסיימת רק שאילתות לקריאה בלבד או שאילתות SELECT. זו ברירת המחדל אם לא צוין transaction-kill-type.
    • ‫ALL_TRANSACTIONS: מסיים כל שאילתה פעילה שחורגת מהסף, כולל שאילתות עם פעולות כתיבה. זה כולל את INSERT, UPDATE, DELETE ומשפטים אחרים של DDL.
  • ‫EXCLUSION_LIST: רשימה של מחרוזות שיוחרגו. אפשר לספק את הערכים באמצעות שם משתמש ומארח ספציפיים במסד הנתונים, כמו user@host, או כשם של חשבון משתמש בסגנון MySQL, שברירת המחדל שלו היא user@%. הרשימה תומכת בתווים הכלליים לחיפוש % ו-_ להתאמה בחלק של המארח.

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

gcloud sql instances patch example-instance \
--performance-capture-config="transaction-kill-threshold-seconds=600,transaction-kill-type=ALL_TRANSACTIONS,transaction-kill-excluded-user-hosts=report_user@%;backup_user@localhost"

REST v1

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫SECONDS: משך הזמן בשניות של העסקאות ארוכות הטווח שיוסיימו באופן אוטומטי. אי אפשר להגדיר את המגבלה הזו לערך שקטן מהערך שהגדרתם בשדה transactionDurationThreshold.
  • ‫TRANSACTION_TYPE: קובע את קטגוריות העסקאות שיש לסיים. משתמשים באחד מהערכים הבאים:
    • ‫READ_ONLY_TRANSACTIONS: מסיימת רק שאילתות לקריאה בלבד או שאילתות SELECT. זו ברירת המחדל אם לא צוין transactionKillType.
    • ‫ALL_TRANSACTIONS: מסיים כל שאילתה פעילה שחורגת מהסף, כולל שאילתות עם פעולות כתיבה. זה כולל את INSERT,‏ UPDATE,‏ DELETE ומשפטים אחרים של DDL.
  • ‫EXCLUSION_LIST: רשימה של מחרוזות שיוחרגו. אפשר לספק את הערכים באמצעות שילוב ספציפי של שם משתמש ומארח במסד הנתונים, כמו user@host, או כשם חשבון משתמש בסגנון MySQL, שמוגדר כברירת מחדל כ-user@%. הרשימה תומכת בתווים הכלליים לחיפוש % ו-_ להתאמה בחלק של המארח.

ה-method של ה-HTTP וכתובת ה-URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON: 

{
  "performanceCaptureConfig": {
    "transactionKillThresholdSeconds": SECONDS,
    "transactionKillType": TRANSACTION_TYPE,
    "transactionKillExcludedUserHosts": [ EXCLUSION_LIST
    ]
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫SECONDS: משך הזמן בשניות של העסקאות ארוכות הטווח שיוסיימו באופן אוטומטי. אי אפשר להגדיר את המגבלה הזו לערך שקטן מהערך שהגדרתם בשדה transactionDurationThreshold.
  • ‫TRANSACTION_TYPE: קובע את קטגוריות העסקאות שיש לסיים. משתמשים באחד מהערכים הבאים:
    • ‫READ_ONLY_TRANSACTIONS: מסיימת רק שאילתות לקריאה בלבד או שאילתות SELECT. זו ברירת המחדל אם לא צוין transactionKillType.
    • ‫ALL_TRANSACTIONS: מסיים כל שאילתה פעילה שחורגת מהסף, כולל שאילתות עם פעולות כתיבה. זה כולל את INSERT,‏ UPDATE,‏ DELETE ומשפטים אחרים של DDL.
  • ‫EXCLUSION_LIST: רשימה של מחרוזות שיוחרגו. אפשר לספק את הערכים באמצעות שילוב ספציפי של שם משתמש ומארח במסד הנתונים, כמו user@host, או כשם חשבון משתמש בסגנון MySQL, שמוגדר כברירת מחדל כ-user@%. הרשימה תומכת בתווים הכלליים לחיפוש % ו-_ להתאמה בחלק של המארח.

ה-method של ה-HTTP וכתובת ה-URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON: 

{
  "performanceCaptureConfig": {
    "transactionKillThresholdSeconds": SECONDS,
    "transactionKillType": TRANSACTION_TYPE,
    "transactionKillExcludedUserHosts": [ EXCLUSION_LIST
    ]
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

השבתת צילום הביצועים

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

המסוף

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

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
  3. לוחצים על Edit.
  4. בקטע התאמה אישית של המופע, לוחצים על הצגת אפשרויות ההגדרה.
  5. מרחיבים את התובנות לגבי שאילתות.
  6. בקטע Enable additional features (הפעלת תכונות נוספות), מבטלים את הסימון בתיבת הסימון Performance capture (תיעוד ביצועים).
  7. לוחצים על Save.

gcloud

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="enabled=false"

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

REST v1

ה-method של ה-HTTP וכתובת ה-URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON: 

{
  "performanceCaptureConfig": {
     "enabled": false
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "INSERT_TIME",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

ה-method של ה-HTTP וכתובת ה-URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON: 

{
  "performanceCaptureConfig": {
     "enabled": false
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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