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

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

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

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

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

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

התפקידים האלה כוללים את הרשאות ה-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

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

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

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

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

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

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