הסבר על תובנות מתקדמות לגבי שאילתות

בוחרים גרסת תיעוד: 18.4.0

• הגרסה הנוכחית (18.4.0)
• 18.4.0

במאמר הזה מתוארים הפרמטרים של ההגדרות, המאפיינים של הטלמטריה, והתצוגות והפונקציות של הניראות (observability) לתובנות מתקדמות לגבי שאילתות ב-AlloyDB Omni.

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

פרמטרים להגדרה

כדי להחיל שינויים בפרמטרים שלא דורשים הפעלה מחדש של מסד הנתונים, מריצים את ALTER SYSTEM SET ואז את SELECT pg_reload_conf(). בטבלה הבאה מתוארים הפרמטרים להגדרת תובנות מתקדמות לגבי שאילתות:

פרמטר	סוג	ערך ברירת המחדל	נדרשת הפעלה מחדש	תיאור
google_insights_v2.enabled	boolean	off	כן, להפעלה ראשונית עם shared_preload_libraries. לא, אם רוצים לטעון מחדש עם pg_reload_conf().	המתג מפעיל או משבית את איסוף הטלמטריה של תובנות מתקדמות לגבי שאילתות בכל המופע.
google_insights_v2.qi_max_query_string_length	integer	10240	לא (טעינה מחדש באמצעות pg_reload_conf())	מגדיר את האורך המקסימלי בבייטים (1024 עד 102400) שנרשם לתבניות SQL מנורמלות, שבהן ערכים ליטרליים מוסווים כפרמטרים מיקומיים כמו $1 ו-$2.
google_insights_v2.qi_preserve_comments	boolean	off	לא (טעינה מחדש עם pg_reload_conf())	ההגדרה קובעת אם הערות SQL נשמרות בתוך מחרוזות של שאילתות מנורמלות.
google_insights_v2.qi_track_wait_event_types	boolean	on	לא (טעינה מחדש באמצעות pg_reload_conf())	מתעד קטגוריות של צווארי בקבוק ברמה גבוהה ב-wait_class, כמו CPU,‏ IO,‏ Lock,‏ Timeout ו-IPC.
google_insights_v2.qi_track_wait_events	boolean	on	לא (טעינה מחדש באמצעות pg_reload_conf())	מתעדים שמות של wait_event ב-PostgreSQL ברמת פירוט גבוהה, כמו DataFileExtend, ‏transactionid ו-WALWrite.
google_insights_v2.qi_track_client_address	boolean	off	לא (טעינה מחדש עם pg_reload_conf())	רשומות שמקשרות בין כתובות ה-IP של הלקוחות בשאילתה לבין תצוגות של נתוני כתובות לקוחות.
google_insights_v2.qi_track_tag	boolean	off	לא (טעינה מחדש עם pg_reload_conf())	מאפשר מעקב אחרי תגים, כמו תגים של SQLCommenter, בהערות SQL.
google_insights_v2.qi_track_active_queries	boolean	off	לא (טעינה מחדש באמצעות pg_reload_conf())	מאפשר מעקב בזמן אמת אחרי שאילתות פעילות ועסקאות פתוחות.

תצוגות ומדדים של ניראות לפי מאפיין

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

שאילתות

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

התצוגות והעמודות הבאות זמינות למאפיין הזה:

• תצוגות של ניראות:
  • observability_service_query_view
  • observability_service_query_coarse_1_view
  • observability_service_query_coarse_2_view
• עמודות קשורות:
  • ‫query_id: מזהה הגיבוב של שאילתת ה-SQL הנורמלית.
  • ‫query: טקסט מנורמל של שאילתת SQL.
  • ‫database: מסד הנתונים הלוגי שבו השאילתה הופעלה.
  • ‫username: התפקיד במסד הנתונים שהריץ את השאילתה.
  • total_execution_time: זמן הביצוע המצטבר במיקרו-שניות.
  • ‫total_wait_time: זמן ההמתנה המצטבר במיקרו-שניות.
  • ‫total_read_time: זמן הקריאה המצטבר מהדיסק במיקרו-שניות.
  • ‫total_write_time: זמן הכתיבה המצטבר בדיסק במיקרו-שניות.
  • ‫total_rows: מספר השורות הכולל שהוחזרו או הושפעו מהשאילתה.
  • ‫total_shared_blocks_hit: המספר הכולל של היטים במאגר הנתונים הזמני המשותף.
  • ‫total_shared_blocks_read: המספר הכולל של בלוקים משותפים שנקראו מהדיסק.
  • ‫count: מספר הפעמים הכולל שהשאילתה בוצעה.
  • ‫recorded_on: חותמת הזמן שבה נרשם מרווח הזמן של הטלמטריה.

סוגי אירועים של המתנה

במאפיין 'סוגי אירועי המתנה' מתועדות קטגוריות של צווארי בקבוק ברמה גבוהה, כשמגדירים את google_insights_v2.qi_track_wait_event_types לערך on (מופעל כברירת מחדל).wait_class

התצוגות והעמודות הבאות זמינות למאפיין הזה:

• תצוגות של ניראות:
  • observability_service_wait_event_no_query_view
  • observability_service_wait_event_stats_by_query_view
• עמודות קשורות:
  • ‫wait_class: קטגוריית אירוע ההמתנה, כמו IO,‏ Lock,‏ LWLock,‏ CPU או Internal wait event.
  • ‫wait_event: שם אירוע ההמתנה המפורט של PostgreSQL בתוך מחלקת ההמתנה.
  • ‫time_spent: זמן ההמתנה המצטבר לסוג אירוע ההמתנה, במיקרו-שניות.
  • ‫count: מספר הפעמים הכולל שסוג אירוע ההמתנה התרחש.
  • ‫database: מסד הנתונים הלוגי שבו התרחש אירוע ההמתנה.
  • ‫username: תפקיד במסד הנתונים שמשויך לאירוע ההמתנה.
  • ‫tag_id: המזהה המספרי של קבוצת התגים המשויכת של SQLCommenter.
  • tag_string: מחרוזת הערה גולמית ב-SQL שמכילה את תגי האפליקציה.
  • ‫recorded_on: חותמת הזמן שבה נרשם מרווח הזמן של הטלמטריה.
  • ‫query_id: מזהה הגיבוב של השאילתה (ב-observability_service_wait_event_stats_by_query_view).

אירועי המתנה

המאפיין "אירועי המתנה" מתעד שמות מפורטים של wait_event ב-PostgreSQL כשהערך של google_insights_v2.qi_track_wait_events מוגדר ל-on (מופעל כברירת מחדל).

התצוגות והעמודות הבאות זמינות למאפיין הזה:

• תצוגות של ניראות:
  • observability_service_wait_event_no_query_view
  • observability_service_wait_event_stats_by_query_view
• עמודות קשורות:
  • ‫wait_event: שם ספציפי של אירוע המתנה ב-PostgreSQL, כמו DataFileExtend,‏ DataFileRead,‏ WALWrite או Internal wait event.
  • ‫wait_class: קטגוריית אירוע ההמתנה שאליה שייך אירוע ההמתנה.
  • ‫time_spent: זמן ההמתנה המצטבר לאירוע ההמתנה במיקרו-שניות.
  • ‫count: מספר הפעמים הכולל שאירוע ההמתנה התרחש.
  • ‫database: מסד הנתונים הלוגי שבו התרחש אירוע ההמתנה.
  • ‫username: תפקיד במסד הנתונים שמשויך לאירוע ההמתנה.
  • ‫tag_id: המזהה המספרי של קבוצת התגים המשויכת של SQLCommenter.
  • tag_string: מחרוזת הערה גולמית ב-SQL שמכילה את תגי האפליקציה.
  • ‫recorded_on: חותמת הזמן שבה נרשם מרווח הזמן של הטלמטריה.
  • ‫query_id: מזהה ה-hash של השאילתה (ב-observability_service_wait_event_stats_by_query_view).

מסדי נתונים

המאפיין 'מסדי נתונים' עוקב אחרי צריכת המשאבים ונפח השאילתות לכל מסד נתונים לוגי כשערך המאפיין google_insights_v2.enabled מוגדר כ-on.

התצוגות והעמודות הבאות זמינות למאפיין הזה:

• תצוגות של ניראות:
  • observability_service_db_load_conn_view
  • observability_service_query_view
  • observability_service_wait_event_no_query_view
• עמודות קשורות:
  • ‫database: שם מסד הנתונים הלוגי.
  • ‫username: תפקיד במסד הנתונים שהריץ שאילתות במסד הנתונים.
  • ‫total_execution_time: זמן הביצוע המצטבר של השאילתה במסד הנתונים במיקרו-שניות.
  • total_wait_time: זמן ההמתנה המצטבר במסד הנתונים במיקרו-שניות.
  • ‫count: המספר הכולל של הפעלות השאילתות במסד הנתונים.
  • ‫recorded_on: חותמת הזמן שבה נרשם מרווח הזמן של הטלמטריה.

משתמשים וכתובות ה-IP של הלקוח

כברירת מחדל, המאפיין "משתמשים וכתובות ה-IP של הלקוחות" עוקב אחרי העומס לפי תפקיד במסד הנתונים (username). כדי לאסוף גם את כתובות ה-IP של הלקוחות המתחברים (client_address), צריך להגדיר את google_insights_v2.qi_track_client_address לערך on (off כברירת מחדל).

התצוגות והעמודות הבאות זמינות למאפיין הזה:

• תצוגות של ניראות:
  • observability_service_query_view
  • observability_service_client_address_stats_by_query_view
• עמודות קשורות:
  • ‫client_address: כתובת ה-IP של הלקוח המתחבר (כאשר google_insights_v2.qi_track_client_address היא on).
  • ‫username: שם התפקיד במסד הנתונים.
  • ‫database: שם מסד הנתונים הלוגי.
  • ‫query_id: מזהה הגיבוב (hash) של שאילתת ה-SQL המנורמלת.
  • ‫time_spent: זמן הביצוע המצטבר של השאילתה עבור כתובת הלקוח במיקרו-שניות.
  • ‫count: המספר הכולל של הרצות השאילתות של המשתמש או של כתובת ה-IP של הלקוח.
  • ‫recorded_on: חותמת הזמן שבה נרשם מרווח הזמן של הטלמטריה.

תגים

המאפיין tags עוקב אחרי הנתונים הסטטיסטיים של הרצת השאילתות לפי המטא-נתונים של תגי האפליקציה. כדי לאסוף מדדי תגים, צריך להגדיר את google_insights_v2.qi_track_tag לערך on (off כברירת מחדל). כשהערך מוגדר כ-off, התצוגות האלה לא מחזירות שורות.

התצוגות והעמודות הבאות זמינות למאפיין הזה:

• תצוגות של ניראות:
  • observability_service_db_load_tag_view
  • observability_service_tag_view
• עמודות קשורות:
  • ‫tag_id: המזהה המספרי של שילוב התגים של האפליקציה.
  • tag_string: מחרוזת הערה גולמית ב-SQL שמכילה את תגי האפליקציה.
  • ‫application: שם האפליקציה שחולץ מתגי SQLCommenter.
  • ‫db_driver: מנהל ההתקן של מסד הנתונים שחולץ מתגי SQLCommenter.
  • ‫framework_name: שם מסגרת האפליקציה שחולץ מתגי SQLCommenter.
  • framework_controller: בקר מסגרת שחולץ מתגי SQLCommenter.
  • framework_action: פעולת framework שחולצה מתגי SQLCommenter.
  • ‫framework_route: נתיב המסגרת שחולץ מתגי SQLCommenter.
  • ‫traceparent: הקשר של מעקב W3C שחולץ מתגי SQLCommenter.
  • ‫database: השם הלוגי של מסד הנתונים שבו הופעלה השאילתה המתויגת.
  • ‫username: תפקיד במסד הנתונים שהפעיל את השאילתה המתויגת.
  • ‫total_execution_time: זמן הביצוע המצטבר של השאילתה לשילוב התגים במיקרו-שניות.
  • ‫count: המספר הכולל של הרצות השאילתות לשילוב התגים.
  • ‫recorded_on: חותמת הזמן שבה נרשם מרווח הזמן של הטלמטריה.

שאילתות פעילות

המאפיין 'שאילתות פעילות' עוקב אחרי שאילתות שפועלות ועסקאות פתוחות בזמן אמת. כדי לשלוח שאילתה לגבי סשנים פעילים, צריך להגדיר את google_insights_v2.qi_track_active_queries ל-on. כשהערך הוא off, שאילתות לתצוגות האלה מחזירות שגיאה.

התצוגות והעמודות הבאות זמינות למאפיין הזה:

• תצוגות של ניראות:
  • stat_activity
  • stat_activity_v3
• עמודות קשורות:
  • ‫pid: מזהה התהליך בקצה העורפי. כדי לסיים סשן, מעבירים את מזהה התהליך לפונקציית המערכת pg_terminate_backend(pid) של PostgreSQL.
  • ‫normalized_query_hash: מזהה הגיבוב של שאילתת ה-SQL הנורמלית.
  • ‫normalized_query: טקסט SQL מנורמל של השאילתה הפעילה.
  • ‫state: המצב הנוכחי של ה-Backend, כמו active או idle in transaction.
  • ‫backend_start: חותמת הזמן שבה התחיל הסשן הנוכחי. כדי לחשב את משך הסשן בשניות, מחשבים את EXTRACT(EPOCH FROM (clock_timestamp() - backend_start)).
  • ‫xact_start: חותמת הזמן שבה התחילה הטרנזקציה הנוכחית. כדי לחשב את משך הטרנזקציה בשניות, מחשבים את EXTRACT(EPOCH FROM (clock_timestamp() - xact_start)).
  • ‫query_start: חותמת הזמן שבה השאילתה הנוכחית התחילה. כדי לחשב את משך השאילתה בשניות, מחשבים את הערך של EXTRACT(EPOCH FROM (clock_timestamp() - query_start)).
  • ‫wait_event_type: קטגוריית אירוע ההמתנה אם ה-backend נמצא בהמתנה.
  • ‫wait_event: שם אירוע ההמתנה אם ה-backend ממתין.
  • ‫database: שם מסד הנתונים הלוגי של הסשן הפעיל.
  • ‫username: שם תפקיד במסד הנתונים עבור הסשן הפעיל.
  • application_name: שם האפליקציה המתחברת.
  • ‫client_addr: כתובת ה-IP של הלקוח שמתחבר.