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

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

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

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

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

يحتوي كل خادم خلفي أيضًا على علامة التبويب الاستخدام التي تتضمّن العديد من الرسومات البيانية للاستخدام توضّح نشاط تطبيقك واستخدامه. وتشمل البيانات المعروضة النطاق الترددي والطلبات على شبكة توصيل المحتوى (CDN)، واستخدام وحدة المعالجة المركزية (CPU) والذاكرة في 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.
• تحتوي رسائل النظام الداخلية على مستوى السجلّ DEBUG.

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

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

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