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

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

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

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

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

כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

להפעלת ה-API

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

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

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

התפקידים האלה כוללים את הרשאות ה-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 שניות ובטווח המפתחות התואמים.

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