צפייה ביומנים ובמדדים

רישום ביומן ומדדים הם כלים חשובים לניפוי באגים ולמעקב אחר קוד. ‫App Hosting מספק גישה מהירה לצפייה ביומנים ובמדדים של שירותי Google Cloud שמפעילים את אפליקציית האינטרנט שלכם: Cloud Run, ‏ Cloud Build ו-Cloud CDN.

אפשר לכתוב רשומות ביומן ל-Cloud Logging באמצעות תחביר סטנדרטי של רישום ביומן, כמו console.log של Node.js.

צפייה בשימוש במסוף

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

בכרטיסייה Logs (יומנים) של קצה עורפי אפשר לראות ולסנן את Build logs (יומני בנייה) (מ-Cloud Build) ואת Runtime logs (יומני זמן ריצה) (מ-Cloud Run ומ-Cloud CDN).

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

במסוף Google Cloud אפשר למצוא מדדי שימוש נוספים עבור Cloud Run (כמו שימוש ב-CPU ושימוש בזיכרון).

צפייה ביומנים במסוף

בתפריט ההקשר של המסוף Firebase (תפריט 3 הנקודות בפינה השמאלית העליונה) של פריסה, אפשר לגשת במהירות לפרטי הגרסה Cloud Run ולשגיאות, וגם ליומני הבנייה.

היומנים האלה מכילים מידע שימושי לניפוי באגים בפריסות של App Hosting. לדוגמה, Cloud Run מתעד ביומן מקרים שבהם package.json לא נמצא.

פלט ה-build מוצג ביומן ה-build, וכך אפשר לבדוק אם אירעו שגיאות בהגדרות של המסגרת או בהגדרות של App Hosting. בנוסף, מוצגות ההגדרות הבסיסיות של runConfig, ומופיעה אינדיקציה אם חסרות הגדרות או אם apphosting.yaml לא קיים:

> next build

   ▲ Next.js 14.1.4
   -   Environments: .env

   ...

Route (app)                              Size     First Load JS
┌ λ /                                    4.79 kB         214 kB
├ λ /_not-found                          882 B          85.3 kB
└ λ /restaurant/[id]                     5.28 kB         207 kB
+   First Load JS shared by all            84.4 kB
  ├ chunks/69-6678c81190a8fe82.js        29 kB
  ├ chunks/fd9d1056-51920e345d2966e8.js  53.4 kB
  └ other shared chunks (total)          1.98 kB

כתיבת יומנים אל Cloud Logging

אם רוצים לתעד אירועים בהתאמה אישית, אפשר לכתוב ל-Cloud Logging מ-Cloud Run, שבו קוד הרינדור של השרת פועל. משתמשים בקריאות רגילות לרישום ביומן של JavaScript, כמו console.log ו-console.error. לדוגמה, כדי לכתוב רשומה מותאמת אישית מקוד עבור Next.js route handler, צריך לעשות משהו כזה:

  • פקודות console.log() הן ברמת היומן INFO.
  • פקודות console.info() הן ברמת היומן INFO.
  • פקודות console.warn() הן ברמת היומן ERROR.
  • פקודות console.error() הן ברמת היומן ERROR.
  • הודעות מערכת פנימיות הן ברמת היומן DEBUG.

שימו לב: console.log מועבר דרך Cloud Logging בקוד server-rendered של האפליקציה. אירועים שקשורים לרינדור סטטי נשלחים ליומנים של Cloud Build, ואירועים שקשורים לרינדור בצד השרת נשלחים ליומנים של Cloud Run.

הצגת שגיאות שרת

‫Cloud Error Reporting מרכז את השגיאות מהמופע של App Hosting Cloud Run. אפשר גם להגדיר את Cloud Error Reporting כך שתקבלו התראות כשמתרחשות שגיאות חדשות.