הצגה וניהול של מדדים בצד הלקוח

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

‫Spanner מספק מדדים בצד הלקוח שאפשר להשתמש בהם יחד עם מדדים בצד השרת כדי לבצע אופטימיזציה של הביצועים ולפתור בעיות בביצועים אם הן מתרחשות.

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

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

  1. מדדים מצד הלקוח זמינים אחרי שמפעילים את Cloud Monitoring API.

    הפעלת Monitoring API

  2. כדי לוודא שלחשבון השירות שלכם יש את ההרשאה הנדרשת לגישה למדדים בצד הלקוח, צריך לבקש מהאדמין להקצות לחשבון השירות את תפקיד ה-IAM‏ Monitoring Metric Writer (roles/monitoring.metricWriter) בפרויקט.

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

    התפקיד המוגדר מראש הזה כולל את ההרשאה monitoring.timeSeries.create, שנדרשת כדי לגשת למדדים מצד הלקוח.

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

גישה למדדים בצד הלקוח

אפשר לגשת למדדים בצד הלקוח באמצעות ספריות הלקוח הבאות:

  • ‫Go בגרסה 1.71.0 ואילך.
  • ‫Java בגרסה 6.81.0 ואילך.
  • ‫Node בגרסה 8.1.0 ואילך.
  • ‫Python בגרסה 3.60.0 ואילך.

כדי לראות את המדדים בצד הלקוח ב-Metrics Explorer:

  1. נכנסים לדף Metrics Explorer במסוף Google Cloud .

    לדף Metrics Explorer

  2. בוחרים את הפרויקט הרצוי.

  3. לוחצים על בחירת מדד.

  4. חיפוש של spanner.googleapis.com/client.

  5. בוחרים את המדד ולוחצים על אישור.

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

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

ביטול ההסכמה למדדים בצד הלקוח

אם אתם כבר משתמשים ב-OpenTelemetry כדי לתעד מדדים מותאמים אישית בצד הלקוח, אתם יכולים להפסיק את השימוש במדדים בצד הלקוח באמצעות הקוד הבא:

Go 

    client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
    DisableNativeMetrics: true,
    })

Java 

Spanner spanner =
  SpannerOptions.newBuilder()
    .setProjectId("test-project")
    .setBuiltInMetricsEnabled(false)
    .build()
    .getService();

Node.js 

  const spanner = new Spanner({
      disableBuiltInMetrics: true
  });

Python 

spanner_client = spanner.Client(
    disable_builtin_metrics=True
)

תמחור

אין עלות לצפייה במדדים בצד הלקוח ב-Cloud Monitoring. ייתכנו חיובים על שימוש ב-Monitoring API. מידע נוסף מופיע במאמר בנושא תמחור של Google Cloud Observability.

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