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

يُعدّ التسجيل والمقاييس أداة مهمة لتصحيح أخطاء الرموز البرمجية ومراقبتها. توفّر أداة App Hosting إمكانية الوصول السريع إلى الاطّلاع على السجلات والمقاييس لخدمات Google Cloud التي تشغّل تطبيقك على الويب: Cloud Run وCloud Build وCloud CDN.

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

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

تحتوي كل خلفية على علامة تبويب نظرة عامة تتضمّن ملخّصًا للزيارات التي تلقّاها تطبيقك (عدد الطلبات) ومعدّل الأخطاء خلال آخر سبعة أيام.

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

يمكنك العثور على مقاييس استخدام إضافية لخدمة Cloud Run (مثل استخدام وحدة المعالجة المركزية واستخدام الذاكرة) في Google Cloud Console.

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

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

تحتوي هذه السجلات على معلومات مفيدة لتصحيح أخطاء عمليات App Hosting النشر. على سبيل المثال، يُسجِّل Cloud Run عندما لا يتم العثور على package.json.

يعرض سجلّ الإنشاء الناتج عن عملية الإنشاء، ما يتيح لك تحديد أولويات المعالجة سواء حدثت أخطاء في الإعداد في إطار العمل أو في إعدادات 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() مستوى التسجيل ERROR.
• تتضمن رسائل النظام الداخلية مستوى السجلّ تصحيح أخطاء.

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

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

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