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

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

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

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

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

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

מערכת Firebase מציגה את כל דפוסי כתובות ה-URL (כולל דפוסי כתובות URL מותאמים אישית) ואת הנתונים המצטברים שלהם בכרטיסייה המשנית בקשות רשת בטבלת המעקב, שנמצאת בחלק התחתון של לוח הבקרה ביצועים במסוף 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 הספציפי ביותר שתואמת, כי הקטע הימני ביותר books ב-example.com/books/* מקבל עדיפות על פני הקטע הימני ביותר * ב-example.com/*/dog.

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

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

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

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

אפשר ליצור תבנית מותאמת אישית של כתובת URL בכרטיסייה המשנית Network requests (בקשות רשת) בטבלת המעקב, שנמצאת בחלק התחתון של לוח הבקרה Performance (ביצועים) במסוף 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. במקום זאת, תבניות URL בהתאמה אישית 'ריקות' ממשיכות להופיע ב-Firebase ברשימה Custom patterns בכרטיסייה המשנית Network requests בטבלת המעקב.

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

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

  1. במרכז הבקרה Performance, גוללים למטה לטבלת המעקב אחר ביצועים ובוחרים בכרטיסייה המשנית Network requests.

  2. בתפריט הנפתח שבכרטיסייה המשנית Network requests, בוחרים באפשרות Custom patterns.

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

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

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

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

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

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

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

השלבים הבאים

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

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

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

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

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

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

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

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

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