פרופיל מסד הנתונים שלך

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

יצירת פרופיל

  1. לפני שמתחילים ליצור פרופיל של Firebase Realtime Database, צריך לוודא שמשתמשים בגרסה העדכנית של ה-CLI של Firebase ושהפעלתם אותו במסד הנתונים ובפרויקט שאתם רוצים ליצור להם פרופיל. שימו לב שאתם צריכים להיות בעלי הרשאת עריכה או בעלים של הפרויקט כדי ליצור פרופיל.

  2. כדי להתחיל ליצור פרופיל של מסד הנתונים, מריצים את הפקודה הבאה:

    firebase database:profile
    בזמן שהפרופיילר מתעד פעולות ממסד הנתונים ויוצר את הפרופיל, מוצגת הודעת סטטוס.

  3. מקישים על Enter כדי להשלים את הפרופיל ולהציג את התוצאות.

פירוש התוצאות

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

מהירות

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

דוח המהירות כולל את המאפיינים הבאים:

  • נתיב: הנתיב במסד הנתונים שבו הפעולות התרחשו. אם יש יותר מ-25 צומתי צאצא, הכלי לניתוח הביצועים מכווץ אותם לנתיב הורה ומוסיף את הסימן $wildcard. יכול להיות שתיקיית השורש של מסד הנתונים תופיע בדוח, והיא תיוצג על ידי קו נטוי /.
  • ספירה: מספר הפעולות שהתרחשו בנתיב הנתון.
  • מהירות ביצוע ממוצעת: הזמן הממוצע שלוקח לשרת לבצע את הלוגיקה העסקית שנדרשת כדי לטפל בסוג הפעולה הספציפי בנתיב הזה. מרווח הזמן שנמדד כאן מתחיל אחרי מרווח הזמן שנמדד במדד "זמן המתנה ממוצע" שמתואר בהמשך.
  • זמן המתנה ממוצע: משך הזמן הממוצע שבקשות ממתינות בתור לפני שהן מבוצעות. העיכוב הזה נפוץ בכל הבקשות שמופעלות על ידי הלקוח. זמן האחזור הכולל של בקשה בצד השרת הוא בערך הסכום של זמן ההמתנה של הבקשה ומהירות הביצוע שלה.
  • Permission Denied: מספר הפעולות בנתיב הנתון שנחסמו על ידי כללי מסד הנתונים של Firebase במסד הנתונים שלכם.
דוח מהירות לפי סוג הפעולה
מהירות קריאת הנתונים זמן התגובה של השרת לבקשות של לקוחות לקרוא נתונים ממסד הנתונים. זמן הביצוע של פעולת קריאה בדרך כלל משתנה בהתאם לכמות הנתונים שנקראים, אבל גם פעולות קריאה קטנות עשויות להתעכב בגלל אחזור מראש של מטמון.
מהירות ביצוע הכתיבה זמן התגובה של השרת לבקשות של לקוחות לכתיבת נתונים במסד הנתונים. זמן הביצוע של פעולת הכתיבה משתנה בהתאם לכמות הנתונים שנכתבים.
מהירות הביצוע של Connect זמן התגובה של השרת לבקשות ליצירת לקוחות של מסד נתונים. זמן האחזור של בקשות החיבור מושפע בעיקר מניהול החיבורים בצד השרת בזיכרון.
מהירות הביצוע של השידור

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

המאפיין Count בדוח Broadcast Speed Report צובר את מספר השידורים שהתרחשו, ולא את מספר הלקוחות שקיבלו את המידע. לדוגמה, אם 10 לקוחות האזינו בנתיב מסוים, והשרת שידר עדכון לכל 10 הלקוחות, מספר השידורים משקף שידור אחד בלבד, למרות ש-10 לקוחות קיבלו את הנתונים.

המאפיין Permission Denied לא נכלל בדוח Broadcast Speed.

רוחב פס

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

דוח רוחב הפס כולל את המאפיינים הבאים:

  • נתיב: הנתיב במסד הנתונים שבו הפעולות התרחשו. אם יש יותר מ-25 צומתי צאצא, כלי הפרופיילינג מכווץ אותם לנתיב הורה.

  • סה"כ: המספר הכולל של בייטים יוצאים או נכנסים ששימשו בכל הפעולות בנתיב הנתון.

  • ספירה: מספר הפעולות שהתרחשו בנתיב הנתון.

  • ממוצע: המספר הממוצע של בייטים שהורדו או הועלו בפעולות בנתיב הנתון (בייטים/כתיבה או בייטים/קריאה).

דוח רוחב פס
בייטים שהורדו נתונים שנצרכים באמצעות פעולות קריאה ושידור שנשלחות דרך ערכות ה-SDK של הלקוח ו-API בארכיטקטורת REST.
בייטים שהועלו נתונים שנצרכים באמצעות בקשות כתיבה שמגיעות לשרת של מסד הנתונים. מחיקות מופיעות ככתיבות עם 0 בייטים בקטע "נכנסות".

שאילתות שלא נוספו לאינדקס

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

בדוח "שאילתות שלא נוספו לאינדקס" מוצגים המאפיינים הבאים:

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

יצירת פרופילים מתקדמת

כדי לראות את כל הפעולות שמסד הנתונים מטפל בהן, משתמשים בדגל --raw כשמגדירים את הפרופיל של מסד הנתונים, באופן הבא:

firebase database:profile --raw

הפלט הגולמי כולל גם מידע על הלקוח לכל פעולה, כמו מחרוזות userAgent וכתובות IP. בקטע סוגי פעולות שבדף הזה מוסבר על הפעולות השונות שמופיעות בפרופיל של Firebase Realtime Database.

כלי הפרופיילינג: לא כלי חיוב

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

הנה כמה דוגמאות נפוצות לתנועה ברשת ש-Firebase מחייבת עליה, שלא נכללת בפרופיל מסד הנתונים:

  • תקורה של פרוטוקול: כדי ליצור סשן ולתחזק אותו, נדרשת תנועה נוספת בין השרת ללקוחות. בהתאם לפרוטוקול הבסיסי, התנועה הזו עשויה לכלול: תקורה של פרוטוקול בזמן אמת של מסד נתונים בזמן אמת ב-Firebase, תקורה של WebSocket ותקורה של כותרת HTTP. בכל פעם שנוצר חיבור, התקורה הזו, בשילוב עם תקורה של הצפנת SSL, תורמת לעלויות החיבור. בדרך כלל לא מדובר ברוחב פס גדול, אבל הוא יכול להיות משמעותי אם המטענים הייעודיים קטנים מאוד או אם אתם יוצרים חיבורים קצרים לעיתים קרובות.
  • תקורה של הצפנת SSL: יש עלות שמשויכת לתקורה של הצפנת SSL שנדרשת לחיבורים מאובטחים. בממוצע, העלות הזו היא בערך 3.5KB ללחיצת היד הראשונית, ובערך 40B לכותרות של רשומות TLS בכל הודעה יוצאת. ברוב האפליקציות, מדובר באחוז קטן מהחשבון. עם זאת, האחוז הזה יכול להיות גדול יותר אם במקרה הספציפי שלכם נדרשים הרבה לחיצות ידיים של SSL. לדוגמה, מכשירים שלא תומכים בכרטיסי סשן של TLS עשויים לדרוש מספר גדול של לחיצות ידיים (handshakes) של חיבורי SSL.

הסבר על החיוב והערכת החיוב

סוגי פעולות ודגלי פקודות של Profiler

בקטע הזה מפורטות אפשרויות הדגלים של הפקודה firebase database:profile ומתוארים סוגי הפעולות שכלי הפרופיילינג מדווח עליהם.

אפשרויות דיווח

הפקודה firebase database:profile תומכת באפשרויות הדגלים הבאות:

אפשרויות דיווח תיאור
-h, --help הצגת נתוני שימוש.
-o, --output FILENAME שומרים את הפלט בקובץ שצוין.
-i, --input FILENAME יצירת הדוח על סמך הקובץ שצוין במקום יומני הסטרימינג מהשרת.
-d, --duration SECONDS איסוף נתוני שימוש במסד הנתונים למשך מספר השניות שצוין.
--raw פלט של הנתונים הסטטיסטיים הגולמיים שנאספו כ-JSON שמופרד באמצעות שורה חדשה.

סוגי פעולות

הפקודה firebase database:profile מדווחת על סוגי הפעולות הבאים:

concurrent-connect

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

{
    "name": "concurrent-connect",
    "timestamp": 1484776334900
}

concurrent-disconnect

המדד "ניתוקים בו-זמניים" משקף חיבור שנותק ממסד הנתונים (לדוגמה, כשלקוח מתנתק או יוצא מהחשבון).

{
    "name": "concurrent-disconnect",
    "timestamp": 1484776341844
}

realtime-write

בקשות כתיבה מחיבורים בזמן אמת. לדוגמה, פעולות set() ו-push() ללקוחות אינטרנט. גם בקשות מחיקה נספרות כפעולות מסוג realtime-write, והן משקפות כתיבה של 0 בייטים.

{
    "allowed": true, // If security rules allow the operation
    "bytes": 1,
    "millis": 2,
    "name": "realtime-write",
    "path": [
        "foo"
    ],
    "timestamp": 1484776538763
}

realtime-transaction

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

{
    "allowed": true,
    "bytes": 20,
    "millis": 2,
    "name": "realtime-transaction",
    "path": [
        "foo"
    ],
    "timestamp": 1484776854610
}

realtime-update

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

{
    "allowed": true,
    "bytes": 5,
    "millis": 2,
    "name": "realtime-update",
    "path": [
        "foo"
    ],
    "timestamp": 1484776538769
}

listener-listen

הפעולות האלה משקפות את הבקשה הראשונית של לקוח לנתונים במיקום ספציפי. לדוגמה, השיטות on() או once() ללקוחות אינטרנט.

{
    "allowed": true,
    "bytes": 0,
    "millis": 26,
    "name": "listener-listen",
    "path": [
        "foo"
    ],
    "querySet": [],
    "timestamp": 1484776335024,
    "unIndexed": false
}

listener-broadcast

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

{
    "bytes": 56, // Total bytes sent across clients
    "clientsUpdated": 3, // This may be 0 if no clients are listening
    "millis": 17,
    "name": "listener-broadcast",
    "path": [
        "baz",
        "mar"
    ],
    "timestamp": 1484775969928
}

listener-unlisten

הפעולות האלה משקפות לקוחות מאזינים שמתנתקים או מפסיקים להאזין באמצעות שיטות הניתוק (לדוגמה, off() לאינטרנט או removeAllObservers ל-iOS).

{
    "name": "listener-unlisten",
    "path": [
        "foo"
    ],
    "timestamp": 1484776335044
}

rest-read

בקשות GET דרך ה-API בארכיטקטורת REST.

{
    "allowed": true,
    "bytes": 348, // This would be 0 if the read data was null
    "millis": 26,
    "name": "rest-read",
    "path": [],
    "querySet": [
        {
            "default": true,
            "endIndexValue": "[MAX_NAME]",
            "equality": false,
            "index": {},
            "limit": null,
            "range": false,
            "simpleLimit": false,
            "startIndexValue": "[MIN_NAME]",
            "viewFrom": null
        }
    ],
    "timestamp": 1484775747416
}

rest-write

בקשות PUT ו-POST דרך ה-API בארכיטקטורת REST. DELETE בקשות משקפות rest-write פעולות של 0 בייטים.

{
    "allowed": true,
    "bytes": 13,
    "millis": 116,
    "name": "rest-write",
    "path": [],
    "timestamp": 1484775917216
}

rest-transaction

כדי לקבל התנהגות דמוית טרנזקציה, צריך להשתמש בבקשות מותנות. הפעולה rest-transaction מתעדת בקשות באמצעות הכותרות Etag או if-match.

{
    "allowed": true,
    "bytes": 13,
    "millis": 116,
    "name": "rest-transaction",
    "path": [],
    "timestamp": 1484775917216
}

rest-update

עדכונים דרך ה-API בארכיטקטורת REST משקפים בקשות של PATCH.

{
    "allowed": true,
    "bytes": 5,
    "millis": 11,
    "name": "rest-update",
    "path": [
        "baz",
        "mar"
    ],
    "timestamp": 1484775969930
}

on-disconnect-put

הפעולות האלה משקפות את ההוספה של מאזינים (listeners) לפעולות כתיבה של onDisconnect. לדוגמה, כשמשתמשים ב-onDisconnect().setValue().

{
    "allowed": true,
    "bytes": 4,
    "millis": 2,
    "name": "on-disconnect-put",
    "path": [
        "baz",
        "mar"
    ],
    "timestamp": 1484775969930
}

on-disconnect-update

הפעולות האלה משקפות את ההוספה של מאזינים מסוג onDisconnect לפעולות עדכון. לדוגמה, כשמשתמשים ב-onDisconnect().updateChildren().

{
    "allowed": true,
    "bytes": 4,
    "millis": 2,
    "name": "on-disconnect-update",
    "path": [
        "baz",
        "mar"
    ],
    "timestamp": 1484775969930
}

on-disconnect-cancel

הפעולות האלה משקפות את ההסרה של מאזינים מסוג onDisconnect. לדוגמה, כשמשתמשים ב-onDisconnect().set().cancel().

{
    "millis": 2,
    "name": "on-disconnect-cancel",
    "path": [
        "baz",
        "mar"
    ],
    "timestamp": 1484775969930
}

run-on-disconnect

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

{
    "bytes": 4,
    "millis": 2,
    "name": "run-on-disconnect",
    "timestamp": 1484775969930
}