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

يمكنك ربط مشروع 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 Console أدوات لعرض سجلاتك وبياناتك المحددة باستخدام طلبات البحث والفلاتر المضمنة ولوحات البيانات. مزيد من المعلومات عن فلترة سجلّاتك باستخدام طلبات البحث في القسم التالي أدناه

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

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

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

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

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

  • ما هو توزيع الزيارات إلى نطاقاتك المختلفة؟
    إذا كان لديك نطاقات أو مواقع متعدّدة على Firebase Hosting، يمكنك فلترة سجلّاتك حسب النطاق أو الموقع الإلكتروني. 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 غير مكتمل
status حالة استجابة HTTP (مثلاً، 200 أو 404)
userAgent عنوان User-Agent للطلب
يخزّن Firebase Hosting حقولاً إضافية في عنصرjsonPayload لإدخال في السجلّ.
acceptEncoding (من طلب HTTP) ترميز المحتوى الذي يتيحه العميل (عادةً ما يكون خوارزمية ضغط)، مثلاً gzip أو compress
billable ما إذا تم تحصيل رسوم من مشروعك مقابل الطلب
customDomain ما إذا تم تقديم الطلب إلى نطاق مخصّص
hostname اسم المضيف الذي تم تقديم الطلب إليه
remoteIpCountry البلد الذي أرسل الطلب
remoteIpCity المدينة التي أرسل الطلب

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

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

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

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

  • response_count: إجمالي عدد الردود التي تم إنشاؤها للموقع الإلكتروني

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

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

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

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

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

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