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

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

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

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

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

تتيح لك علامة التبويب السجلات الخاصة بخادم الخلفية عرض "سجلات الإنشاء" (من Cloud Build) و "سجلات وقت التشغيل" (من Cloud Run وCloud CDN) وفلترتها.

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

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

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

من قائمة السياق في 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.
• تحتوي رسائل النظام الداخلية على مستوى السجلّ DEBUG.

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

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

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