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

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

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

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

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

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

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

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

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

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

שדה תיאור
השדות הבאים נשמרים על ידי Firebase Hosting ב אובייקט httpRequest של היומן רשומה.
השדות האלה מוגדרים במפרט ה-HTTP.
cacheHit האם המשאב של התגובה היה במטמון של ה-CDN של Hosting
latency משך הבקשה, בשניות עם Postfix של 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 not populated
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, ושליחת שאילתות לגבי הנתונים האלה בדרכים חדשות.