Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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 התואמת הספציפית ביותר כי לפלח הימני ביותר 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 מותאמים אישית והנתונים שלהם

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

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

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

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

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

כשמסירים תבנית של כתובת 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 ובעלים או עורך של הפרויקט.

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