רישום ביומן ומדדים הם כלים חשובים לניפוי באגים ולמעקב אחרי קוד. App Hosting מספק גישה מהירה לצפייה ביומנים ובמדדים של שירותי Google Cloud שמפעילים את אפליקציית האינטרנט: Cloud Run, Cloud Build ו-Cloud CDN.
באמצעות תחביר רישום סטנדרטי כמו console.log של Node.js, אפשר לכתוב רשומות ביומן ל-Cloud Logging.
הצגת השימוש במסוף
לכל קצה עורפי יש כרטיסייה Overview, עם סיכום של התנועה באפליקציה (מספר הבקשות) ושיעור השגיאות בשבעת הימים האחרונים.
בכרטיסייה Logs של קצה עורפי אפשר לראות ולסנן את Build logs (מ-Cloud Build) ואת Runtime logs (מ-Cloud Run ומ-Cloud CDN).
לכל בקאנד יש גם כרטיסיית Usage עם כמה תרשימי שימוש לפעילות ולשימוש באפליקציה. הנתונים המוצגים כוללים רוחב פס ובקשות של CDN, ניצול מעבד (CPU) וניצול זיכרון של Cloud Run ועוד.
במסוף Google Cloud אפשר למצוא מדדי ניצול נוספים של Cloud Run (כמו ניצול המעבד וניצול הזיכרון).
הצגת היומנים במסוף
מתפריט ההקשר של מסוף Firebase (תפריט של 3 נקודות בפינה הימנית העליונה) של השקה, אתם יכולים לקבל גישה מהירה לצפייה בפרטי הגרסה של Cloud Run ובשגיאות, וגם ביומני ה-build.
היומנים האלה מכילים מידע שימושי לניפוי באגים בפריסות של App Hosting. לדוגמה, ביומן Cloud Run מצוין מתי לא נמצא package.json.
ביומן ה-build מוצג פלט ה-build, שמאפשר לכם לבדוק אם אירעו שגיאות בהגדרות של ה-framework או בהגדרות של 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, צריך לעשות משהו כזה:
export async function GET(request) {
console.log("Handling GET request");
return Response.json({ message: "Hello, world!" });
}
- לפקודות
console.log()יש רמת רישום ביומן של INFO. - לפקודות
console.info()יש רמת רישום ביומן של INFO. - לפקודות
console.warn()יש רמת יומן ERROR. - לפקודות
console.error()יש רמת יומן ERROR. - להודעות מערכת פנימיות יש רמת יומן של ניפוי באגים.
שימו לב שהערך של console.log מועבר אל Cloud Logging בקוד של האפליקציה שמעובד בצד השרת. אירועים שקשורים לעיבוד סטטי נשלחים ליומנים של Cloud Build, ואירועים שקשורים לעיבוד בצד השרת נשלחים ליומנים של Cloud Run.
הצגת שגיאות בחיבור לשרת
ב-Cloud Error Reporting מרוכזות השגיאות ממכונות App Hosting ב-Cloud Run. אפשר להגדיר את Cloud Error Reporting כך שתקבלו התראה כשיופיעו שגיאות חדשות.