תחילת העבודה עם 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 ביחד. איך מוצאים קשרים בין מדדים שונים

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

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

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

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

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

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

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

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

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

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

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