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

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

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

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

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

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

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

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

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

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

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

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

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