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

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

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

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

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

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

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

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

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

בתפריט ההקשר של המסוף 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 של האפליקציה. אירועים שקשורים ל-static rendering נשלחים ליומנים של Cloud Build, ואירועים שקשורים ל-server rendering נשלחים ליומנים של Cloud Run.

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

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