סקירה כללית של Key Visualizer

בדף הזה יש סקירה כללית על כלי האבחון Key Visualizer ל-Firestore.

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

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

מה זה Key Visualizer?

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

הכלי Key Visualizer יכול לספק תובנות לגבי דפוסי שימוש בקנה מידה נרחב. השימושים ב-Key Visualizer כוללים:

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

כדי להשיג את המטרות האלה, Key Visualizer יכול לעזור לכם לבצע את המשימות הבאות:

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

בדיקת הזכאות לסריקה

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

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

סריקות של Key Visualizer

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

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

שיתוף כתובות URL של סריקות

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

מפות חום

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

במפת חום של מפתחות מסמך, ציר ה-X מייצג את הזמן וציר ה-Y מייצג את מפתחות המסמך. במפת חום של מפתחות אינדקס, ציר ה-X מייצג את הזמן וציר ה-Y מייצג את מפתחות האינדקס.

כל סריקה של Key Visualizer ל-Firestore מכסה שעתיים של פעילות שמחולקות לקטעים של 10 שניות.

ערך נמוך של מדד נחשב ל'קר' ומופיע כצבע כהה. ערך גבוה הוא 'חם' ומוצג כצבע בהיר. הערכים הגבוהים ביותר מופיעים בלבן.

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

הכלי Key Visualizer מספק כלים שיעזרו לכם להבין את הנתונים בכל סריקה. אפשר לקרוא את המאמרים איך מתחילים להשתמש ב-Key Visualizer וניתוח מפות חום.

קטגוריות של מילות מפתח

הכלי Key Visualizer מחלק את כל המפתחות במסד הנתונים שלכם ל-1,000 טווחים רציפים לכל היותר, עם בערך אותו מספר של מפתחות ופעולות קלט/פלט בשנייה בכל טווח. הטווחים האלה נקראים key buckets.

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

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

מדדים

המדדים הבאים זמינים למפתחות של מסמכים בסריקות של Key Visualizer:

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

המדד הבא זמין למפתחות אינדקס בסריקות של Key Visualizer:

מדדים תיאור
פעולות כתיבה לאינדקס לשנייה המספר הממוצע של כתיבות לאינדקס בשנייה.

ממוצעי ביצועים

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

מגבלות

למרות ש-Key Visualizer מציג מגוון מדדים, הוא לא מציג כל מדד שיכול להשפיע על הביצועים של Firestore. לדוגמה:

  • יכול להיות שלא תראו בעיות ברשת בין האפליקציה לבין Google Cloud . הן עשויות להופיע כפסים אנכיים בכל המפתחות ב-Key Visualizer, אבל זה רק ייתן לכם רמזים לגבי מתי הבעיות התרחשו.

משך הנתונים

הנתונים שנאספים על ידי Key Visualizer for Firestore נמחקים אחרי 14 ימים.

הנתונים של הכלי להמחזת נתונים מרכזיים זמינים מ-14 הימים האחרונים. לדוגמה, אם מפעילים את הכלי Key Visualizer ב-19 בדצמבר בשעה 12:45, שעת ההתחלה המוקדמת ביותר שאפשר לבחור לטווח זמן של שעתיים היא 5 בדצמבר בשעה 13:00.

ההגבלה הזו גם אומרת שאם מוסיפים לסימנייה או משתפים את כתובת ה-URL של סריקה ב-Key Visualizer, כתובת ה-URL תהיה פעילה למשך 14 ימים לכל היותר.

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