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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

השלבים הבאים

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

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

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

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

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

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

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

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

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