הצגה, חיפוש וסינון של יומני בקשות האינטרנט של האתר שלך באמצעות Cloud Logging

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

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

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

  1. לוחצים על Link (קישור) בכרטיס השילוב Cloud Logging במסוף Firebase.

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

  2. פועלים לפי ההוראות במסך כדי לבחור אילו אתרים של Hosting צריכים לייצא יומנים אל Cloud Logging.

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

אחרי הקישור אל Cloud Logging, יומנים של כל הבקשות החדשות לאתרים שלכם ב-Hosting יופיעו בדרך כלל תוך 30 דקות מרגע שליחת הבקשה.

אפשר גם לבטל את הקישור של Firebase Hosting אל Cloud Logging, וכך להפסיק את הייצוא של יומני בקשות האינטרנט אל Cloud Logging.

מעקב אחר השימוש בנתונים ביומנים

אחרי שמקשרים אל Cloud Logging, אפשר לראות את רמת השימוש בנתונים ביומנים מהאתרים שלכם ב-Hosting:

להבין טוב יותר את האתר

בממשק של Logs Viewer במסוף Google Cloud יש כלים לצפייה ביומנים ובנתונים הספציפיים שלכם באמצעות שאילתות, מסננים מובנים ולוחות נתונים. מידע נוסף על סינון היומנים באמצעות שאילתות מופיע בקטע הבא.

  • מה מקור התנועה באתר שלך ברמה מפורטת?
    אפשר לראות מידע על כל בקשה, כולל כתובת ה-IP של המקור, כתובת האתר המפנה, העיר והסטטוס.

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

  • מהי התפלגות הסטטוסים של בקשות משתמשי קצה?
    אפשר לראות את הסטטוס של כל בקשה ואפילו לאבחן בקשות שמתקבלות לגביהן שגיאות. אפשר לסנן את היומנים לפי Critical, Error או Warning.

  • כמה זמן לוקח לאתר להגיב לבקשה?
    אפשר לראות את זמן האחזור של האתר לכל בקשה באמצעות הערך שמתועד בכל יומן.latency

  • האם באתר נעשה שימוש במטמון תוכן?
    כל יומן מכיל שדה cacheHit שבו מצוין אם המשאב של האתר הוגש במהירות ממטמון ה-CDN של Hosting, או אם הוא נאלץ לעבור את כל הדרך אל קצה העורף של Hosting. השימוש ב-CDN הגלובלי של Firebase יכול לעזור לכם לשפר את הביצועים של האתר. לדוגמה, אפשר להשתמש בנתונים כדי לשפר את הרגלי הקאשינג של נכסים סטטיים ותוכן דינמי.

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

סינון היומנים באמצעות שאילתות

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

לגבי Hosting, הנה כמה מסננים ראשוניים לשאילתה:

  • משאב (resource.type) – firebase_domain (Firebase Hosting דומיין האתר)
  • שם היומן (logName) – webrequests (Firebase Hosting)

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

שדה תיאור
Firebase Hosting מאחסן את השדות הבאים באובייקט httpRequest של הרשומה ביומן.
השדות האלה מוגדרים במפרט ה-HTTP.
cacheHit האם משאב התגובה היה במטמון של Hosting CDN
latency משך הבקשה, בשניות עם הסיומת s (לדוגמה, 1.256s)
protocol הפרוטוקול שבו נעשה שימוש בבקשה (לדוגמה, HTTP/1.1, HTTP/2, websocket)
referer הכתובת של דף האינטרנט הקודם שממנו בוצעה לחיצה על קישור לדף הנוכחי (אם יש כזה)
remoteIp כתובת ה-IP של הלקוח ששלח את הבקשה
requestMethod שיטת הבקשה (GET, POST,‏ PUT וכו')
requestSize גודל הבקשה בבייטים
requestUrl כתובת ה-URL המלאה של הבקשה (לדוגמה,
https://foo.web.app/bar או https://custom.domain.com?query=param)
responseSize גודל תגובת ה-HTTP בבייטים
serverIp לא מאוכלס
status סטטוס תגובת ה-HTTP (לדוגמה, 200 או 404)
userAgent כותרת סוכן המשתמש של הבקשה
Firebase Hosting שומר שדות נוספים באובייקט jsonPayload של הרשומה ביומן.
acceptEncoding (מבקשת ה-HTTP) קידוד התוכן, בדרך כלל אלגוריתם דחיסה, שהלקוח תומך בו (לדוגמה, gzip או compress)
billable האם הפרויקט שלכם חויב על הבקשה
customDomain האם הבקשה הוגשה לגבי דומיין מותאם אישית
hostname שם המארח שאליו נשלחה הבקשה
remoteIpCountry מדינת המקור של הבקשה
remoteIpCity העיר שממנה הגיעה הבקשה

שימוש במדדים מבוססי-יומנים

אפשר להציג ולבנות מדדים שמבוססים על יומנים, ואז להשתמש במדדים האלה ב-Cloud Monitoring כדי ליצור תרשימים ומדיניות התראות.

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

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

  • אפשר להשתמש ב-Cloud Monitoring כדי לתעד את מספר הרשומות ביומן שמכילות הודעות מסוימות, או כדי לחלץ מידע על זמן האחזור שדווח ברשומות ביומן. אחר כך תוכלו להשתמש במדדים האלה בתרשימים ובמדיניות התראות.

Firebase Hosting יוצר גם מדדים ספציפיים ל-Hosting של רישום ביומן. המדדים האלה לא ספציפיים לרשומה ביומן, אלא לאתר Hosting הספציפי בכללותו.

  • log_bytes: סך הבייטים של השימוש בנתונים בכל אתר

  • response_count: המספר הכולל של התשובות שנכתבו לאתר

    המדד הזה כולל את השדה של סטטוס HTTP, כך שאפשר לשרטט תשובות HTTP לפי סטטוס (כדוגמה).

ייצוא יומנים לכלים אחרים של Google Cloud

אפשר גם לייצא את היומנים של האתר לכלים אחרים של Google Cloud, כמו Cloud Monitoring או BigQuery. לדוגמה:

  • באמצעות Cloud Monitoring, אפשר ליצור מדדים מבוססי-יומן שאפשר להשתמש בהם בתרשימים ובמדיניות התראות.

  • באמצעות BigQuery, אתם יכולים לבצע כל אחת מהפעולות הבאות:

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