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

يُعدّ التسجيل والمقاييس أداة مهمة لتصحيح أخطاء الرموز البرمجية ومراقبتها. توفّر أداة 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 (قائمة من 3 نقاط في أعلى يسار الصفحة) ل عملية الطرح الحالية، اختَر عرض مقاييس Cloud Run. ستتمكّن من مراقبة عدد الطلبات التي تصل إلى خدمة Cloud Run، بما في ذلك التقسيم حسب رمز الاستجابة لفهم معدّل الأخطاء في تطبيقك.

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

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

تعمل ميزة Cloud Error Reporting على تجميع الأخطاء من مثيل App Hosting Cloud Run. يمكنك اختياريًا ضبط ميزة reporting reporting لخدمات Cloud بغرض إرسال إشعارات إليك عند ظهور أخطاء جديدة.