התאמה אישית של צבירת נתונים לבקשת רשת

Firebase Performance Monitoring צבירה אוטומטית של נתונים לבקשות רשת דומות, כדי לעזור לכם להבין מגמות בביצועים של בקשות הרשת.

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

צבירת נתונים לפי תבניות מותאמות אישית של כתובות URL

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

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

ב-Firebase מוצגים כל דפוסי כתובות ה-URL (כולל דפוסי כתובות URL מותאמים אישית) והנתונים המצטברים שלהם בכרטיסיית המשנה Network requests בטבלת העקבות, שנמצאת בחלק התחתון של לוח הבקרה Performance במסוף Firebase.

איך פועלת התאמה של תבניות URL מותאמות אישית?

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

אם כתובת ה-URL של בקשה תואמת ליותר מתבנית אחת של כתובת URL מותאמת אישית, Firebase ממפה את הבקשה רק לתבנית הספציפית ביותר של כתובת URL מותאמת אישית, לפי סדר הספציפיות הבא: טקסט רגיל > * > ** משמאל לימין בנתיב. לדוגמה, בקשה ל-example.com/books/dog תואמת לשתי תבניות URL מותאמות אישית:

  • example.com/books/*
  • example.com/*/dog

עם זאת, התבנית example.com/books/* היא תבנית כתובת ה-URL הספציפית ביותר שתואמת לכתובת ה-URL, כי לפלח הימני ביותר books ב-example.com/books/* יש עדיפות על פני הפלח הימני ביותר * ב-example.com/*/dog.

כשיוצרים תבנית חדשה של כתובת URL בהתאמה אישית, חשוב לשים לב לנקודות הבאות:

  • התאמות ונתונים נצברים מבקשות קודמות לא מושפעים מיצירה של תבנית חדשה של כתובת URL בהתאמה אישית. מערכת Firebase לא מבצעת צבירה מחדש של נתוני בקשות באופן רטרואקטיבי.

  • יצירת תבנית חדשה של כתובת URL מותאמת אישית משפיעה רק על בקשות עתידיות. יכול להיות שתצטרכו להמתין עד 12 שעות עד ש-Performance Monitoring יאסוף ויצבור נתונים לפי דפוס חדש של כתובת URL מותאמת אישית.

יצירת תבנית מותאמת אישית של כתובת URL

אפשר ליצור תבנית מותאמת אישית של כתובת URL מכרטיסיית המשנה בקשות רשת בטבלת העקבות, שנמצאת בתחתית לוח הבקרה ביצועים של מסוף Firebase.

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

אפשר ליצור עד 400 תבניות כתובות URL מותאמות אישית לכל אפליקציה, ועד 100 תבניות כתובות URL מותאמות אישית לכל דומיין של האפליקציה.

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

  • טקסט פשוט – התאמה למחרוזת מדויקת
  • ‫* — תואם לקטע הראשון של תת-הדומיין או לכל מחרוזת בקטע נתיב יחיד
  • ‫** – תואם לסיומת שרירותית של נתיב

בטבלה הבאה מתוארות כמה אפשרויות להתאמה של תבניות URL מותאמות אישית.

כדי להתאים... יוצרים תבנית מותאמת אישית של כתובת URL כמו... דוגמאות להתאמות לתבנית כתובת ה-URL הזו
כתובת URL מדויקת example.com/foo/baz example.com/foo/baz
כל פלח נתיב יחיד (*) example.com/*/baz example.com/foo/baz
example.com/bar/baz
example.com/*/*/baz example.com/foo/bar/baz
example.com/bah/qux/baz
example.com/foo/* example.com/foo/baz
example.com/foo/bar

הערה: התבנית הזו לא תתאים ל-example.com/foo.
סיומת שרירותית של נתיב (**) example.com/foo/** example.com/foo
example.com/foo/baz
example.com/foo/baz/more/segments
subdomain.example.com/foo.bar/** subdomain.example.com/foo.bar
subdomain.example.com/foo.bar/baz
subdomain.example.com/foo.bar/baz/more/segments
הפלח הראשון של תת-הדומיין (*) *.example.com/foo bar.example.com/foo
baz.example.com/foo

הצגת דפוסי כתובות URL מותאמים אישית והנתונים שלהם

ב-Firebase מוצגים כל דפוסי כתובות ה-URL (כולל דפוסי כתובות URL מותאמים אישית) והנתונים המצטברים שלהם בכרטיסיית המשנה Network requests בטבלת העקבות, שנמצאת בחלק התחתון של לוח הבקרה Performance במסוף Firebase.

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

כאשר תקופת השמירה של הנתונים מסתיימת עבור הנתונים שמצטברים בתבנית URL, מערכת Firebase מוחקת את הנתונים האלה מתבנית ה-URL. אם כל הנתונים שמצטברים לפי תבנית מותאמת אישית של כתובת URL פג תוקפם, Firebase לא מוחק את התבנית המותאמת אישית של כתובת ה-URL ממסוף Firebase. במקום זאת, Firebase ממשיך להציג תבניות URL מותאמות אישית 'ריקות' ברשימה Custom patterns (תבניות בהתאמה אישית) בכרטיסיית המשנה Network requests (בקשות מהרשת) בטבלת העקבות.

הסרה של תבנית URL מותאמת אישית

אפשר להסיר מהפרויקט דפוסי כתובות URL מותאמות אישית. שימו לב שאי אפשר להסיר תבנית URL אוטומטית.

  1. בלוח הבקרה 'ביצועים', גוללים למטה לטבלת העקבות ובוחרים בכרטיסיית המשנה בקשות רשת.

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

  3. מעבירים את העכבר מעל השורה של תבנית כתובת ה-URL המותאמת אישית שרוצים להסיר.

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

כשמסירים תבנית של כתובת URL מותאמת אישית, חשוב לשים לב לנקודות הבאות:

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

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

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

  • בכרטיסיית המשנה בקשות רשת (כשמסומנת האפשרות תבניות בהתאמה אישית) לא מופיעות תבניות מותאמות אישית של כתובות URL שהוסרו.

השלבים הבאים

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

התאמה אישית של אופן החישוב של שיעור ההצלחה

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

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

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

לדוגמה, אם לאפליקציה שלכם יש API של נקודת קצה לחיפוש, אתם יכולים לספור תגובות 404 כ'מוצלחות' כי תגובות 404 צפויות לנקודת קצה לחיפוש. נניח שיש 100 דוגמאות לנקודת הקצה הזו של החיפוש בכל שעה, ו-60 מהן הן תגובות מסוג 200 ו-40 מהן הן תגובות מסוג 404. לפני שתגדירו את שיעור ההצלחה, שיעור ההצלחה יהיה 60%. אחרי שתגדירו את חישוב שיעור ההצלחה כך שייכללו בו תגובות 404, שיעור ההצלחה יהיה 100%.

הגדרת חישוב שיעור ההצלחה

כדי להגדיר את חישוב שיעור ההצלחה של תבנית URL של רשת, צריכה להיות לכם הרשאה firebaseperformance.config.update. ההרשאה הנדרשת הזו כלולה כברירת מחדל בתפקידים הבאים: אדמין ב-Firebase Performance,‏ אדמין ב-Firebase Quality,‏ אדמין ב-Firebase ובעלים או עורך בפרויקט.

  1. עוברים לכרטיסייה Performance Monitoring לוח הבקרה במסוף Firebase ובוחרים את האפליקציה שעבורה רוצים להגדיר חישוב של שיעור ההצלחה.
  2. גוללים למטה לטבלת העקבות בתחתית המסך ובוחרים בכרטיסייה בקשות רשת.
  3. מאתרים את תבנית כתובת ה-URL שרוצים להגדיר עבורה את חישוב שיעור ההצלחה.
  4. בקצה השמאלי של השורה, פותחים את תפריט האפשרויות הנוספות () ובוחרים באפשרות הגדרת שיעור ההצלחה.
  5. פועלים לפי ההוראות במסך כדי לבחור את קודי התשובה שרוצים לספור כקודי תשובה מוצלחים.