يُعدّ التسجيل والمقاييس من الأدوات المهمة لتصحيح أخطاء الرموز البرمجية ومراقبتها. 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".
عرض السجلّات في وحدة التحكّم
من قائمة السياق في وحدة تحكّم Firebase (قائمة النقاط الثلاث في أعلى يسار الصفحة) لعملية طرح، يمكنك الوصول بسرعة إلى تفاصيل وأخطاء نسخة 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،
يمكنك تنفيذ ما يلي:
export async function GET(request) {
console.log("Handling GET request");
return Response.json({ message: "Hello, world!" });
}
- تتضمّن أوامر
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 لإعلامك عند حدوث أخطاء جديدة.