عرض السجلّات والمقاييس

التسجيل والمقاييس من الأدوات المهمة لتصحيح الأخطاء ومراقبة الرموز البرمجية. توفّر خدمة "استضافة التطبيقات" وصولاً سريعًا لعرض السجلّات والمقاييس الخاصة بخدمات Google Cloud التي تشغّل تطبيق الويب، وهي: Cloud Run وCloud Build وCloud CDN.

باستخدام بنية تسجيل عادية مثل console.log في Node.js، يمكنك كتابة إدخالات السجلات إلى Cloud Logging.

عرض السجلّات في وحدة التحكّم

من قائمة سياق وحدة تحكُّم Firebase (قائمة النقاط الثلاث في أعلى يسار الشاشة) لطرحها، يمكنك الوصول سريعًا لعرض تفاصيل وأخطاء النسخة السابقة من "تشغيل السحابة الإلكترونية" بالإضافة إلى سجلّات Cloud Build.

تحتوي هذه السجلات على معلومات مفيدة لتصحيح أخطاء عمليات نشر استضافة التطبيقات. مثلاً، تظهر ملاحظات سجلّ تشغيل السحابة الإلكترونية عند عدم العثور على package.json.

يعرض سجلّ Cloud Build نتائج التصميم، ما يسمح لك بفرز ما إذا كانت هناك أخطاء في الإعدادات في إطار العمل أو في إعدادات "استضافة التطبيق". وتعرض أيضًا إعدادات 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 Run، حيث يتم تشغيل الرمز المعروض من الخادم. استخدِم طلبات تسجيل JavaScript العادية، مثل console.log وconsole.error. على سبيل المثال، لكتابة إدخال مخصص من رمز لمعالج مسار Next.js، يمكنك تنفيذ ما يلي:

• أوامر console.log() على مستوى السجل INFO.
• أوامر console.info() على مستوى السجل INFO.
• تحتوي أوامر console.warn() على مستوى السجلّ ERROR.
• تحتوي أوامر console.error() على مستوى السجلّ ERROR.
• تتضمّن رسائل النظام الداخلي مستوى السجلّ تصحيح الأخطاء.

يُرجى العلم أنّ ممرات console.log يمر إلى Cloud Logging في الرمز البرمجي الذي يعرضه الخادم لتطبيقك. ويتم إرسال الأحداث ذات الصلة بالعرض الثابت إلى سجلات Cloud Build، بينما يتم إرسال عرض الخادم إلى سجلات Cloud Run.

عرض المقاييس في وحدة التحكّم

من وحدة تحكُّم Firebase، يمكنك الوصول إلى مقاييس عدد الزيارات والاستخدام لخدمة Cloud Run التي تشغِّل تطبيق الويب.

من قائمة سياق وحدة تحكُّم Firebase (قائمة النقاط الثلاث في أعلى يسار الصفحة) لعملية الطرح الحالية، اختَر عرض مقاييس تشغيل السحابة الإلكترونية. ستتمكن من مراقبة عدد الطلبات التي تصل إلى خدمة Cloud Run، بما في ذلك التقسيم حسب رمز الاستجابة لمعرفة معدل الخطأ في تطبيقك.

ويمكنك أيضًا الاطّلاع على مقاييس وقت استجابة الطلبات واستخدام الحاوية (مثل استخدام وحدة المعالجة المركزية (CPU) واستخدام الذاكرة)، لفهم أداء تطبيقك وقابلية تطويره.

عرض الأخطاء في الخادم

يدمج إعداد تقارير الأخطاء في السحابة الإلكترونية الأخطاء الواردة من مثيل "استضافة التطبيق في السحابة الإلكترونية". يمكنك اختياريًا ضبط ميزة "الإبلاغ عن أخطاء Cloud" من أجل إشعارك عند ظهور أخطاء جديدة.