يُعدّ التسجيل والمقاييس أداة مهمة لتصحيح أخطاء الرموز البرمجية ومراقبتها. توفّر أداة App Hosting إمكانية الوصول السريع إلى الاطّلاع على السجلات والمقاييس لخدمات Google Cloud التي تشغّل تطبيقك على الويب: Cloud Run وCloud Build وCloud CDN.
باستخدام بنية التسجيل العادية مثل console.log في Node.js، يمكنك كتابة إدخالات log
إلى Cloud Logging.
عرض السجلات في وحدة التحكّم
من قائمة سياق وحدة تحكّم Firebase (قائمة من 3 نقاط في أعلى يسار الصفحة) لطرح ميزة، يمكنك الوصول بسرعة إلى تفاصيل Cloud Run التعديل والأخطاء بالإضافة إلى سجلّات Cloud Build.
تحتوي هذه السجلات على معلومات مفيدة لتصحيح أخطاء عمليات App Hosting
النشر. على سبيل المثال، يتم تسجيل ملاحظات في سجلّ "Cloud Run" في حال عدم العثور على
package.json.
يعرض سجلّ Cloud 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()مستوى السجلّ خطأ. - تملك أوامر
console.error()مستوى السجلّ خطأ. - تحتوي رسائل النظام الداخلية على مستوى السجلّ تصحيح أخطاء.
يُرجى العِلم أنّ console.log يتم توجيهه إلى Cloud Logging في رمز العرض من جهة الخادم لتطبيقك. ويتم إرسال الأحداث المتعلّقة بالعرض الثابت
إلى سجلّات Cloud Build، بينما يتم إرسال عمليات العرض من جهة الخادم إلى سجلّات Cloud Run.
عرض المقاييس في وحدة التحكّم
من وحدة تحكّم Firebase، يمكنك الوصول إلى مقاييس الزيارات ومعدل الاستخدام للخدمة Cloud Run التي تشغّل تطبيق الويب.
من قائمة سياقات وحدة التحكّم Firebase (قائمة النقاط الثلاث في أعلى يسار الصفحة) لمعرفة الطرح الحالي، اختَر عرض مقاييس Cloud Run. ستتمكّن من مراقبة عدد الطلبات التي تصل إلى خدمة Cloud Run، بما في ذلك التقسيم حسب رمز الاستجابة لفهم معدّل الأخطاء في تطبيقك.
ويمكنك أيضًا الاطّلاع على مقاييس وقت استجابة الطلبات واستخدام الحاوية (مثل استخدام وحدة المعالجة المركزية (CPU) واستخدام الذاكرة)، لفهم أداء تطبيقك وقابلية التوسع فيه.
عرض أخطاء الخادم
تعمل ميزة Cloud Error Reporting على تجميع الأخطاء من مثيل App Hosting Cloud Run. يمكنك اختياريًا ضبط ميزة reporting reporting لخدمات Cloud بغرض إرسال إشعارات إليك عند ظهور أخطاء جديدة.