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

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

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

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

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

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

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

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

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

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

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

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