בדף הזה מוסבר איך להשתמש ב-Key Visualizer כדי לבדוק אם יש בעיות בביצועים שקשורות לדפוסי השימוש ב-Cloud Firestore.
לפני שמתחילים
כדי להשתמש ב-Key Visualizer ב-Cloud Firestore, צריך להפעיל את Firestore Key Visualizer API.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, אתם יכולים לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים
התפקידים הנדרשים
מוודאים שבחשבון שלכם מוגדר אחד מתפקידי ה-IAM הבאים:
- בעלים של Cloud Datastore
- צפייה ב-Key Visualizer של Cloud Datastore
- עריכה
- בעלים
התפקידים האלה כוללים את הרשאות ה-IAM הבאות, שנדרשות כדי לגשת ל-Key Visualizer:
datastore.keyVisualizerScans.getdatastore.keyVisualizerScans.listdatastore.databases.getMetadataresourcemanager.projects.get
אפשר גם להגדיר תפקיד בהתאמה אישית עם ההרשאות הנדרשות.
צפייה בסריקה של תקופה מסוימת
כל סריקה של Key Visualizer נמשכת שעתיים. אפשר לסרוק תקופה מסוימת במסדי נתונים עם תנועה של יותר מ-3,000 פעולות במסמכים בכל דקה נתונה באותה תקופה.
כדי להפעיל את Key Visualizer:
נכנסים לדף Databases במסוף Google Cloud.
בוחרים את מסד הנתונים הרצוי מרשימת מסדי הנתונים.
בתפריט הניווט, לוחצים על Key Visualizer.
בוחרים טווח זמן ומדד מתוך הסריקות הזמינות של Key Visualizer:
לוחצים על סמל העיפרון בפינה השמאלית העליונה. בוחרים תאריך וטווח זמן.
הסריקות זמינות בהתאם לדרישות הסף לסריקה. אי אפשר לבחור טווחי זמן שלא עומדים בדרישות לסריקה או שעדיין נמצאים בתהליך עיבוד. שתי הסריקות האחרונות של היום יעברו עיבוד ויהיו זמינות אחרי זמן מה.
בוחרים באפשרות כל נתוני המסמכים או כל נתוני האינדקס כמקור.
לוחצים על עדכן.
בוחרים מדד לניתוח:
לוחצים על התפריט הנפתח של המדדים בפינה הימנית העליונה ובוחרים מדד לצפייה. כברירת מחדל, הכלי Key Visualizer נפתח במדד Ops/s למפתחות של מסמכים ובמדד Index Write Ops/s למפתחות של אינדקסים.
כדי להשוות בין מדדים או לחפש מתאמים בין נתונים, אפשר להציג כמה מדדים של Key Visualizer ביחד. איך מוצאים קשרים בין מדדים שונים
צפייה בסקירה כללית של הפעילות
כדי לקבל סקירה כללית של הפעילות במהלך פרק הזמן של שעתיים שנבחר, עיינו במפת החום של מדד ברירת המחדל.
בדוגמה הבאה מוצגת מפת חום שבה יש הבדלים משמעותיים בדפוס השימוש בטווחי מפתחות שונים:
- טווחים שמוצגים בצבעים כהים מציינים פעילות מועטה או חוסר פעילות.
- בטווחים שמוצגים בצבעים בהירים יש הרבה יותר פעילות.
- הטווח הלבן הזוהר באמצע מייצג פעילות גבוהה מאוד.
סריקת מפתחות למסמכים
המדד Ops/s מודד את מספר הבקשות לשנייה לכל טווח מפתחות. המדד הזה הוא סכום של בקשות כתיבה, חיפוש ושאילתות. כברירת מחדל, המדד הזה מוצג ב-Key Visualizer כשפותחים מפת חום.
אחרי שתקבלו מושג על הפעילות הכוללת במסד הנתונים, תוכלו להמשיך את הבדיקה על ידי בחינת מדדים אחרים והתמקדות בטווחי מפתח שעשויים לגרום לבעיות. מידע נוסף
סריקת מפתחות אינדקס
המדד Index Write Ops/s בתא נתון מודד את הממוצע של פעולות הכתיבה באינדקס לשנייה, בטווח המפתחות ובמרווח הזמן של 10 שניות שתואמים לתא.
המאמרים הבאים
- לומדים לזהות דפוסים נפוצים במפות חום של מפתחות מסמכים.
- איך מזהים דפוסים נפוצים במפות חום של מפתחות אינדקס
- איך בוחנים מפת חום לעומק