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

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

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

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

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

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

להפעלת ה-API

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

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

  • בעלים של Cloud Datastore
  • כלי להצגת מפתחות ב-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

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

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

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

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

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

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