בדף הזה מופיע תיאור מפורט של כל מדד בצד הלקוח ש-Spanner מציע. למידע נוסף על הצגה וניהול של מדדים בצד הלקוח, ראו הצגה וניהול של מדדים בצד הלקוח.
מדדים בצד הלקוח מספקים מידע על זמן האחזור של הניסיונות והפעולות של בקשות RPC מהלקוח ל-Spanner.
ניסיון הוא בקשת RPC אחת מהלקוח אל Spanner. הלקוח יכול לנסות שוב אם הבקשה נכשלת.
פעולה מייצגת את ההשלמה של כל בקשות ה-RPC, כולל כל הניסיונות שהלקוח ביצע ב-Spanner. פעולה מסתיימת כשהלקוח מקבל תשובה או כשהוא מנצל את כל הניסיונות.
בקשת RPC מגיעה קודם לממשק הקצה של Google (GFE) ואז לממשק הקצה של Spanner API (AFE). למידע נוסף, קראו את המאמר נקודות זמן של זמן אחזור בבקשה של Spanner.
הלקוח מחשב את מדדי זמן האחזור של GFE ושל AFE לפי מידע על התזמון ש-GFE ו-AFE מוסיפים לכותרות התגובה. אם ניסיון מסתיים לפני שהלקוח מקבל כותרות תגובה, הלקוח לא מתעד דגימת זמן אחזור של GFE או AFE לניסיון הזה. לדוגמה, זה קורה כשהמועד האחרון לשליחת הבקשה חולף והלקוח מחזיר שגיאת DEADLINE_EXCEEDED.
במקום זאת, הלקוח מגדיל את מדד ספירת שגיאות הקישוריות המתאים. לכן, ההתפלגויות של זמני האחזור של GFE ו-AFE כוללות רק ניסיונות שקיבלו כותרות תגובה, והן עשויות להיראות תקינות גם אם ניסיונות רבים נכשלו בגלל זמן קצוב לתפוגה.
הלקוח מתעד מדדי GFE רק לבקשות שעוברות דרך ה-GFE. אם בקשה משתמשת ב-DirectPath (הערך של directpath_used הוא true), הלקוח לא מתעד את זמן האחזור של GFE או את מספר השגיאות בקישוריות ל-GFE עבור הבקשה הזו.
המדדים האלה כוללים את סוגי הערכים DISTRIBUTION ו-INT64. למידע נוסף, קראו את המאמר סוגי ערכים וסוגי מדדים.
אתם יכולים לגשת למדדים בצד הלקוח באמצעות ספריות הלקוח של Spanner ל-Java, ל-Go, ל-Node.js ול-Python.
המדדים בצד הלקוח תומכים בכל השיטות של Spanner ב-google.spanner.v1.Spanner RPC API.
לכל המדדים בצד הלקוח יש את המאפיינים הבאים:
-
project ID: מזהה הפרויקט ב- Google Cloud . -
instance ID: מזהה המכונה של Spanner. -
database ID: מזהה מסד הנתונים של Spanner. -
location: האזור ב- Google Cloud שבו מתפרסמים המדדים בצד הלקוח. אם האפליקציה פרוסה מחוץ ל- Google Cloud, המדדים מתפרסמים באזורglobal. -
method: שם ה-method של ה-RPC, לדוגמהspanner.commit. -
status: סטטוס ה-RPC, לדוגמהOKאוINTERNAL. -
client_name: שם הספרייה והגרסה – לדוגמה,spanner-java/6.70.1. -
directpath_enabled: אם ספריית הלקוח מוגדרת לגשת ישירות ל-Spanner בלי לעבור דרך ממשק הקצה. -
directpath_used: אם הבקשה הנוכחית נשלחה ישירות אל Spanner בלי לעבור דרך ממשק המשתמש. אם הערך שלfalseהואdirectpath_enabledוהערך שלtrueהוא, הבקשה חזרה לנתיב הרגיל שעובר דרך ה-GFE.
מספר שגיאות הקישוריות של ה-AFE
המדד "מספר השגיאות בקישוריות ל-AFE" מתעד את מספר הניסיונות שבהם הלקוח לא קיבל את פרטי התזמון של Spanner AFE בכותרות התגובה. זה קורה, למשל, כשהבקשה לא מגיעה ל-AFE או כשהזמן הקצוב לניסיון מסתיים לפני שהלקוח מקבל כותרות תגובה. המדד AFE latencies לא מתעד דגימה לניסיונות האלה.
למדד "מספר השגיאות בקישוריות של ה-AFE" יש את המאפיינים הבאים:
-
Metric name:spanner.googleapis.com/client/afe_connectivity_error_count -
Metric value type:INT64
זמני האחזור של ה-AFE
המדד "זמני האחזור של AFE" מודד את הזמן שעובר מרגע שה-AFE של Spanner מקבל את בקשת ה-RPC מהלקוח ועד שה-AFE של Spanner מתחיל לכתוב את התגובה.
הלקוח מחשב את הערך הזה לפי מידע על התזמון בכותרות התגובה. אם ניסיון מסתיים לפני שהלקוח מקבל כותרות תגובה, הלקוח לא מתעד דגימה ומגדיל את המדד מספר שגיאות הקישוריות של AFE במקום זאת.
המדד "זמני האחזור של AFE" כולל את המאפיינים הבאים:
-
Metric name:spanner.googleapis.com/client/afe_latencies -
Metric value type:DISTRIBUTION
מספר הניסיונות
המדד "מספר הניסיונות" מתעד את מספר הניסיונות שבוצעו. הערך של attempt_count בדרך כלל זהה לערך של operation_count.
אם הלקוח מקבל שגיאות זמניות, הערך של attempt_count הוא הסכום של כל הניסיונות.
למדד "מספר הניסיונות" יש את המאפיינים הבאים:
-
Metric name:spanner.googleapis.com/client/attempt_count -
Metric value type:INT64
זמני האחזור של הניסיונות
המדד "זמני האחזור של הניסיונות" מודד את משך הזמן של ניסיון RPC בודד, מהרגע שהלקוח שולח את הבקשה ועד שהניסיון מצליח או נכשל.
הערך של attempt_latencies בדרך כלל זהה לערך של operation_latencies. אם הלקוח מקבל שגיאות זמניות, הערך של operation_latencies הוא סכום כל הערכים של attempt_latencies.
המאפיינים של המדד "זמני האחזור של הניסיונות":
-
Metric name:spanner.googleapis.com/client/attempt_latencies -
Metric value type:DISTRIBUTION
מספר שגיאות הקישוריות של GFE
המדד "מספר השגיאות בקישוריות ל-GFE" מתעד את מספר הניסיונות שבהם הלקוח לא קיבל מידע על תזמון ה-GFE בכותרות התגובה. זה קורה, למשל, כשהבקשה לא מגיעה ל-GFE או כשהניסיון נכשל בגלל זמן קצוב לתפוגה לפני שהלקוח מקבל כותרות תגובה. המדד GFE latencies לא מתעד דגימה של הניסיונות האלה.
למדד מספר השגיאות בקישוריות ל-GFE יש את המאפיינים הבאים:
-
Metric name:spanner.googleapis.com/client/gfe_connectivity_error_count -
Metric value type:INT64
זמני האחזור של GFE
מדד זמני האחזור של GFE מודד את הזמן שעובר מרגע ש-GFE מקבל את בקשת ה-RPC מהלקוח ועד ש-GFE מקבל את הבייט הראשון של התגובה. המדד הזה לא כולל את הזמן שלוקח ללחיצת יד בפרוטוקול TCP או TLS.
הלקוח מחשב את הערך הזה לפי מידע על התזמון בכותרות התגובה. אם ניסיון מסתיים לפני שהלקוח מקבל כותרות תגובה, הלקוח לא מתעד דגימה ובמקום זאת מגדיל את המדד GFE connectivity error count. אם מספר שגיאות הקישוריות ל-GFE עולה, זמני האחזור של GFE שנראים תקינים לא מעידים על זמן אחזור נמוך.
למדד זמני האחזור של GFE יש את המאפיינים הבאים:
-
Metric name:spanner.googleapis.com/client/gfe_latencies -
Metric value type:DISTRIBUTION
מספר הפעולות
המדד "מספר הפעולות" מתעד את מספר הפעולות שבוצעו כל 60 שניות.
למדד Operation count יש את המאפיינים הבאים:
-
Metric name:spanner.googleapis.com/client/operation_count -
Metric value type:INT64
זמני אחזור של פעולות
המדד "זמני האחזור של הפעולות" מודד את הלוך ושוב של פעולה משכבת gRPC של הלקוח אל Spanner ובחזרה ללקוח.
למדד Operation latencies יש את המאפיינים הבאים:
Metric name:spanner.googleapis.com/client/operation_latencies-
Metric value type:DISTRIBUTION