רישום ביומן ומדדים הם כלים חשובים לניפוי באגים ולמעקב אחר קוד. App Hosting מספק גישה מהירה לצפייה ביומני ובמדדים של שירותי Google Cloud שמפעילים את אפליקציית האינטרנט שלכם: Cloud Run, Cloud Build ו-Cloud CDN.
באמצעות תחביר סטנדרטי של רישום ביומן, כמו console.log
של Node.js, אפשר לכתוב רשומות ביומן ב-Cloud Logging.
הצגת השימוש במסוף
לכל קצה עורפי יש כרטיסייה סקירה כללית, עם סיכום של התנועה באפליקציה (מספר הבקשות) ושיעור השגיאות ב-7 הימים האחרונים.
לכל קצה עורפי יש גם כרטיסייה Usage עם כמה תרשימים של שימוש לפעילות ולשימוש באפליקציה. הנתונים שמוצגים כוללים את רוחב הפס והבקשות של ה-CDN, את ניצול המעבד והזיכרון ב-Cloud Run ועוד.
מדדי ניצול נוספים של Cloud Run (כמו ניצול מעבד וניצול זיכרון) זמינים במסוף Google Cloud.
הצגת יומנים במסוף
בתפריט ההקשר של מסוף Firebase (תפריט של 3 נקודות בפינה השמאלית העליונה) של השקה, אפשר לקבל גישה מהירה לפרטים ולשגיאות של הגרסה Cloud Run, וגם ליומני ה-build.
היומנים האלה מכילים מידע שימושי לניפוי באגים בפריסות של 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, צריך לעשות משהו כזה:
- לפקודות
console.log()
יש את רמת היומן INFO. - לפקודות
console.info()
יש את רמת היומן INFO. - לפקודות
console.warn()
יש את רמת היומן ERROR. - לפקודות
console.error()
יש את רמת היומן ERROR. - להודעות מערכת פנימיות יש את רמת היומן DEBUG.
שימו לב ש-console.log
מועבר ל-Cloud Logging בקוד המתבצע על השרת של האפליקציה. אירועים שקשורים לעיבוד סטטי נשלחים ליומנים של Cloud Build, ואילו עיבוד על השרת נשלחים ליומנים של Cloud Run.
הצגת שגיאות שרת
Cloud Error Reporting מרכז את השגיאות ממכונות App Hosting Cloud Run. אפשר גם להגדיר את Cloud Error Reporting כך שתקבלו התראות כשיהיו שגיאות חדשות.