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

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

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

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

כדי ליצור תבנית של כתובת 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.
סיומת שרירותית של נתיב כתובת ה-URL‏ (**)	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 לא תומכת בתחביר של *.file-extension, כמו *.png או *.css.

הצגת תבניות URL בהתאמה אישית והנתונים שלהן

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

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

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

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

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

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

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

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

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

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

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

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