תחילת העבודה עם Key Visualizer

בדף הזה מוסבר איך להשתמש ב-Key Visualizer כדי לבדוק אם יש בעיות בביצועים שקשורות לדפוסי השימוש ב-Cloud Firestore.

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

כדי להשתמש ב-Key Visualizer עבור Cloud Firestore, צריך להפעיל את Firestore Key Visualizer API.

תפקידים שנדרשים להפעלת ממשקי API

כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של שימוש בשירות' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים

להפעלת ה-API

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

מוודאים שמוקצה לחשבון שלכם אחד מתפקידי ה-IAM הבאים:

  • בעלים של Cloud Datastore
  • בעל הרשאת צפייה ב-Cloud Datastore Key Visualizer
  • הרשאת עריכה
  • בעלים

התפקידים האלה כוללים את הרשאות ה-IAM הבאות שנדרשות כדי לגשת לכלי Key Visualizer:

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

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

צפייה בסריקה לתקופה מסוימת

כל סריקה של Key Visualizer מכסה תקופה של שעתיים. סריקה לתקופה מסוימת זמינה למסדי נתונים עם תנועה שעולה על 3,000 פעולות מסמך בדקה מסוימת בתקופה הזו.

כדי להפעיל את Key Visualizer:

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

    מעבר אל Databases

  2. בוחרים את מסד הנתונים הרצוי מתוך רשימת מסדי הנתונים.

  3. בתפריט הניווט, לוחצים על Key Visualizer.

  4. בוחרים טווח זמן ומדד מתוך הסריקות הזמינות של Key Visualizer:

    1. לוחצים על סמל העיפרון בפינה הימנית העליונה. בוחרים תאריך וטווח זמן.

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

    2. בוחרים באפשרות כל נתוני המסמך או באפשרות כל נתוני האינדקס כמקור.

    3. לוחצים על עדכן.

  5. בוחרים מדד לניתוח:

    לוחצים על התפריט הנפתח של המדדים בפינה הימנית העליונה ובוחרים מדד להצגה. כברירת מחדל, הכלי Key Visualizer נפתח במדד Ops/s למפתחות מסמכים ובמדד Index Write Ops/s למפתחות אינדקס.

כדי להשוות בין מדדים או לחפש קורלציות בין נתונים, אפשר להציג כמה מדדים של Key Visualizer ביחד. איך מוצאים קשרים בין מדדים שונים

צפייה בסקירה כללית של פעילות

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

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

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

דוגמה לסריקה של Key Visualizer

סריקת מפתחות של מסמכים

המדד Ops/s (פעולות/שנייה) מודד את מספר הבקשות בשנייה לכל טווח מפתחות. המדד הזה הוא סכום של בקשות כתיבה, חיפוש ושאילתה. המדד הזה מוצג כברירת מחדל ב-Key Visualizer כשפותחים מפת חום.

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

סריקת מפתחות אינדקס

המדד Index Write Ops/s בתא מסוים מודד את ממוצע פעולות הכתיבה לאינדקס לשנייה במרווח הזמן של 10 שניות ובטווח המפתחות התואם.

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