Catch up on highlights from Firebase at Google I/O 2023. Learn more

اعرض ، ابحث ، وفلتر سجلات طلبات الويب لموقعك باستخدام Cloud Logging

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

فيما يلي بعض الأشياء التي تفعلها باستخدام سجلات Cloud Logging. قم بزيارة كل قسم من هذه الصفحة لمعرفة التفاصيل.

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

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

    لربط أو إلغاء ربط التسجيل في السحاب ، تحتاج إلى تجميع الأذونات في أي من الأدوار التالية: مالك المشروع أو المحرر أو مسؤول تطوير Firebase .

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

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

بعد الارتباط بـ Cloud Logging ، ستظهر عادةً سجلات أي طلبات جديدة لمواقع الاستضافة الخاصة بك في غضون 30 دقيقة من تقديم الطلب.

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

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

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

فهم أفضل لموقعك

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

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

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

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

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

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

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

تصفية السجلات الخاصة بك مع الاستفسارات

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

للاستضافة ، فيما يلي بعض عوامل التصفية الأولية للاستعلام:

  • المورد ( resource.type ) - firebase_domain (مجال موقع استضافة Firebase)
  • اسم السجل ( logName ) - webrequests (استضافة Firebase)

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

مجال وصف
يخزن Firebase Hosting الحقول التالية في كائن httpRequest لإدخال السجل.
تم تحديد هذه الحقول في مواصفات HTTP.
cacheHit ما إذا كان لدى Hosting CDN مورد الاستجابة في ذاكرة التخزين المؤقت أم لا
latency مدة الطلب بالثواني باستخدام s postfix (على سبيل المثال ، 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 لإنشاء مخططات وسياسات تنبيه.

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

  • قم بإنشاء مقاييس محددة من قبل المستخدم لمشروعك. يمكنك حساب عدد إدخالات السجل التي تطابق استعلامًا معينًا أو تتبع قيم معينة بإدخالات السجل المتطابقة. يمكنك التصفية باستخدام التعبيرات العادية.

  • استخدم مراقبة السحابة لتسجيل عدد إدخالات السجل التي تحتوي على رسائل معينة أو لاستخراج معلومات زمن الانتقال التي تم الإبلاغ عنها في إدخالات السجل. يمكنك بعد ذلك استخدام هذه المقاييس في المخططات وسياسات التنبيه.

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

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

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

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

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

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

  • باستخدام المراقبة السحابية ، يمكنك إنشاء مقاييس قائمة على السجل يمكنك استخدامها في المخططات وسياسات التنبيه.

  • باستخدام BigQuery ، يمكنك القيام بأي مما يلي:

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