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

يمكنك ربط مشروعك على 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:

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

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

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

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

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

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

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

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

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

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

بالنسبة إلى 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 لم يتمّ ملؤها
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 وإجراء طلبات بحث عنها بطرق جديدة.