הצגת יומנים ומדדים

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

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

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

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

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