عرض سجلات طلبات الويب على موقعك والبحث فيها وتصفيتها باستخدام تسجيل الدخول إلى السحابة الإلكترونية

يمكنك ربط مشروعك على Firebase بخدمة Cloud Logging لعرض سجلّات طلبات الويب والبحث فيها وفلترتها لكل موقع من مواقعك على Hosting. تأتي هذه السجلات من شبكة توصيل المحتوى (CDN) التي توفّرها Firebase تلقائيًا، لذا يتم تسجيل كل طلب يتم إرساله إلى موقعك الإلكتروني وبيانات الطلب المرتبطة به.

في ما يلي بعض الإجراءات التي يمكنك تنفيذها باستخدام سجلّات Cloud Logging. يُرجى الانتقال إلى كل قسم من هذه الصفحة للاطّلاع على التفاصيل.

إذا كان لديك عدة مواقع Hosting في مشروعك، يمكنك اختيار المواقع التي سيتم تصدير السجلات منها.Hosting يمكنك بعد ذلك فلترة بيانات السجلّات وعرضها حسب الموقع الإلكتروني Hosting وحتى حسب النطاق. من خلال اختيار مواقع إلكترونية معيّنة لتصدير السجلات، يمكنك أيضًا التحكّم في كمية البيانات التي تتم معالجتها لمشروعك.Hosting

  1. انقر على ربط في بطاقة دمج Cloud Logging في وحدة تحكّم Firebase.

    لربط Cloud Logging أو إلغاء ربطه، يجب أن تتوفّر لك الأذونات المضمّنة في أيّ من الأدوار التالية: مالك المشروع أو محرّره أو مشرف تطوير Firebase.

  2. اتّبِع التعليمات الظاهرة على الشاشة لاختيار المواقع الإلكترونية Hosting التي يجب أن تصدّر السجلات إلى Cloud Logging.

    إذا كان لديك موقع إلكتروني واحد أو أكثر من مواقع Hosting النشطة، ستعرض عملية الربط مستوى تقديريًا لاستخدام البيانات في السجلات من كل مواقع Hosting. يتم تقدير هذه القيمة من آخر 30 يومًا.

بعد الربط بـ Cloud Logging، ستظهر عادةً سجلّات أي طلبات جديدة إلى مواقعك الإلكترونية Hosting خلال 30 دقيقة من تقديم الطلب.

يمكنك أيضًا إلغاء ربط Firebase Hosting بحساب Cloud Logging، ما يؤدي إلى إيقاف عمليات تصدير سجلّات طلبات الويب إلى Cloud Logging.

مراقبة استخدام البيانات للسجلات

بعد الربط بـ Cloud Logging، يمكنك الاطّلاع على مستوى استخدام البيانات للسجلات من مواقعك الإلكترونية على Hosting:

  • في بطاقة دمج Cloud Logging في وحدة تحكّم Firebase

  • في واجهة Logs Viewer في وحدة تحكّم Google Cloud (مقياس log_bytes)

فهم موقعك الإلكتروني بشكل أفضل

توفّر واجهة Logs Viewer في وحدة تحكّم Google Cloud أدوات لعرض سجلاتك وبياناتك المحدّدة باستخدام طلبات البحث والفلاتر المضمّنة ولوحات البيانات. يمكنك الاطّلاع على مزيد من المعلومات حول فلترة سجلّاتك باستخدام طلبات البحث في القسم التالي أدناه.

  • ما هو مصدر الزيارات إلى موقعك الإلكتروني على مستوى تفصيلي؟
    يمكنك الاطّلاع على معلومات حول كل طلب، بما في ذلك عنوان IP المصدر، والمُحيل، والمدينة، والحالة.

  • متى يزور المستخدمون موقعك الإلكتروني؟
    يمكنك استخدام لوحة المدرّج التكراري للاطّلاع على التوزيع حسب النطاقات الزمنية المحدّدة. ويمكن أن يقدّم لك ذلك إحصاءات حول الارتفاعات والانخفاضات العادية في استخدام تطبيقك، بالإضافة إلى الكشف عن أي ارتفاعات غير متوقّعة في عدد الزيارات.

  • ما هو توزيع الحالات لطلبات المستخدمين النهائيين؟
    يمكنك الاطّلاع على حالة كل طلب وحتى تشخيص الطلبات التي تتلقّى أخطاء. يمكنك فلترة سجلّاتك حسب Critical أو Error أو Warning.

  • كم من الوقت يستغرق موقعك الإلكتروني للاستجابة لطلب معيّن؟
    يمكنك الاطّلاع على وقت استجابة موقعك الإلكتروني لكل طلب باستخدام latency القيمة التي تم تسجيلها في كل سجلّ.

  • هل يستفيد موقعك الإلكتروني من التخزين المؤقت للمحتوى؟
    يحتوي كل سجلّ على حقل cacheHit يوضّح ما إذا كان قد تم عرض مورد موقعك الإلكتروني بسرعة من ذاكرة التخزين المؤقت لشبكة توصيل المحتوى (CDN) التابعة لـ Hosting، أو ما إذا كان قد تم إجراء عملية نقل كاملة إلى الخلفية في Hosting. يمكن أن يساعدك ذلك في تحسين أداء موقعك الإلكتروني من خلال الاستفادة إلى أقصى حد من شبكة توصيل المحتوى (CDN) العالمية من Firebase. على سبيل المثال، يمكنك استخدام البيانات لتحسين عادات التخزين المؤقت للأصول الثابتة والمحتوى الديناميكي.

  • ما هو توزيع الزيارات على نطاقاتك المختلفة؟
    إذا كان لديك نطاقات أو مواقع إلكترونية متعددة Hosting، يمكنك فلترة السجلات حسب النطاق أو الموقع الإلكتروني. يتيح لك ذلك الاطّلاع على كيفية توزيع عدد الزيارات. عند الفلترة حسب النطاق، يمكنك تتبُّع النطاق الذي يتم الانتقال إليه بشكل متكرّر.

فلترة السجلّات باستخدام طلبات البحث

للتعرّف على كيفية فلترة سجلّاتك باستخدام طلبات البحث، يمكنك الانتقال إلى طلبات بحث نموذجية باستخدام "عارض السجلات" و إنشاء طلبات بحث في السجلّ. يوضّح الجدول أدناه الحقول المتاحة لطلبات البحث هذه.

بالنسبة إلى Hosting، إليك بعض الفلاتر الأولية لطلب البحث:

  • المورد (resource.type) — firebase_domain (Firebase Hosting نطاق الموقع)
  • اسم السجلّ (logName): webrequests (Firebase Hosting)

يتضمّن كل إدخال في السجلّ بنية محدّدة مسبقًا وحقولاً قابلة للبحث (راجِع LogEntry). بالنسبة إلى Hosting، تكون بعض الحقول عادية في طلب HTTP، ولكن هناك قيم حقول أخرى تأتي من عملية المعالجة التي ينفّذها Hosting في كل طلب.

الحقل الوصف
يخزّن Firebase Hosting الحقول التالية في عنصر httpRequest الخاص بإدخال السجلّ.
يتم تحديد هذه الحقول في مواصفات HTTP.
cacheHit ما إذا كانت شبكة توصيل المحتوى (CDN) الخاصة بـ Hosting تتضمّن مصدر الرد في ذاكرة التخزين المؤقت أم لا
latency مدة الطلب بالثواني مع اللاحقة s (مثلاً، 1.256s)
protocol البروتوكول المستخدَم في الطلب (على سبيل المثال، HTTP/1.1 وHTTP/2 وwebsocket)
referer عنوان صفحة الويب السابقة التي تم الانتقال منها إلى الصفحة المطلوبة حاليًا (إذا كان متوفرًا)
remoteIp عنوان IP الخاص بالعميل المصدر للطلب
requestMethod طريقة الطلب (GET أو POST أو PUT أو غير ذلك)
requestSize حجم الطلب بالبايت
requestUrl عنوان URL الكامل للطلب (على سبيل المثال،
https://foo.web.app/bar أو https://custom.domain.com?query=param)
responseSize حجم استجابة HTTP بالبايت
serverIp not populated
status حالة استجابة HTTP (مثلاً، 200 أو 404)
userAgent عنوان الطلب الذي يرسله وكيل المستخدم
يخزّن Firebase Hosting حقولاً إضافية في عنصر jsonPayload ضمن إدخال السجلّ.
acceptEncoding (من طلب HTTP) ترميز المحتوى الذي يتيحه العميل، وهو عادةً خوارزمية ضغط (مثل gzip أو compress)
billable تحديد ما إذا تم تحصيل رسوم من مشروعك مقابل الطلب
customDomain ما إذا تم تقديم الطلب ضد نطاق مخصّص
hostname اسم المضيف الذي تم تقديم الطلب بشأنه
remoteIpCountry بلد المنشأ للطلب
remoteIpCity المدينة التي تم تقديم الطلب منها

استخدام المقاييس المستندة إلى السجلّات

يمكنك عرض المقاييس المستندة إلى السجلات وإنشاؤها، ثم استخدام هذه المقاييس في Cloud Monitoring لإنشاء رسوم بيانية وسياسات تنبيه.

  • استفِد من مقاييس النظام المحدّدة مسبقًا التي يتم تسجيلها تلقائيًا، مثل عدد أحداث التسجيل التي حدثت خلال فترة زمنية محدّدة.

  • أنشئ مقاييس من تحديد المستخدم لمشروعك. يمكنك احتساب عدد إدخالات السجلّ التي تتطابق مع طلب بحث معيّن أو تتبُّع قيم معيّنة باستخدام إدخالات السجلّ المطابقة. يمكنك الفلترة باستخدام التعبيرات العادية.

  • استخدِم Cloud Monitoring لتسجيل عدد إدخالات السجلّ التي تتضمّن رسائل معيّنة أو لاستخراج معلومات وقت الاستجابة الواردة في إدخالات السجلّ. يمكنك بعد ذلك استخدام هذه المقاييس في الرسوم البيانية وسياسات التنبيه.

تنشئ Firebase Hosting أيضًا مقاييس تسجيل خاصة بـ Hosting على النحو التالي. لا تنطبق هذه المقاييس على إدخال سجلّ معيّن، بل على Hosting الموقع الإلكتروني المحدّد ككل.

  • log_bytes: إجمالي وحدات البايت لاستخدام البيانات لكل موقع إلكتروني

  • response_count: إجمالي عدد الردود المكتوبة للموقع الإلكتروني

    يتضمّن هذا المقياس حقل حالة HTTP، لذا يمكنك رسم استجابات HTTP حسب الحالة (كمثال).

تصدير السجلات إلى أدوات Google Cloud أخرى

يمكنك أيضًا تصدير سجلّات موقعك الإلكتروني إلى أدوات Google Cloud أخرى، مثل Cloud Monitoring أو BigQuery، على سبيل المثال:

  • باستخدام Cloud Monitoring، يمكنك إنشاء مقاييس مستندة إلى السجلّات يمكنك استخدامها في الرسومات البيانية وسياسات التنبيه.

  • باستخدام BigQuery، يمكنك إجراء أي مما يلي:

    • استخدِم "مركز البيانات" لإنشاء لوحات بيانات تتضمّن بيانات Hosting.
    • تنفيذ طلبات بحث للحصول على المزيد من الإحصاءات حول طلباتك (متوسط حجم الردود، وعدد مرات الاستفادة من ذاكرة التخزين المؤقت مقارنةً بعدد مرات عدم الاستفادة منها، وما إلى ذلك)
    • التعرّف على عناوين URL التي يطلبها المستخدمون فعلاً
    • يمكنك دمج بيانات Hosting مع بيانات Firebase الأخرى التي صدّرتها إلى BigQuery، ثمّ إجراء طلبات بحث بطرق جديدة.