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

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

דרישות לגבי מהדורה ומצב

המסמך הזה רלוונטי למהדורת Firestore Standard ב-Firestore במצב Native.

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

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

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

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

להפעלת ה-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

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

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

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

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

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

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