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

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

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

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