فلترة السجلّات وإنشاء مقاييس مستندة إلى السجلّات

بعد تصدير بيانات Crashlytics وبيانات جلسات Firebase (اختياريًا) إلى Cloud Logging، يمكنك فلترة السجلّات وإنشاء مقاييس مستندة إلى السجلّات. كلاهما مفيد لعرض بيانات محددة واستخدامها وتحليلها.

إذا لم يسبق لك الاطّلاع على مقالة ما الذي يمكنك فعله ببياناتك؟، ننصحك بالاطّلاع عليها للحصول على قائمة شاملة وأمثلة على كيفية استخدام البيانات المخزَّنة في Cloud Logging.

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

تساعدك فلترة السجلّات في عرض بيانات معيّنة، بالإضافة إلى خفض تكاليف تخزين البيانات وإجراء المزيد من التحليلات. يمكنك فلترة السجلّات باستخدام لغة طلب البحث في السجلّات (LQL).

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

أمثلة على الفلاتر

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

  • للعثور على جميع الأعطال الفادحة في إصدار معيّن من التطبيق:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.errorType="FATAL"
jsonPayload.version.displayVersion="3.2.0"

  • تحديد الأعطال التي تحدث في طراز جهاز معيّن (مثل Pixel 6a):

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.device.model="Pixel 6a"

  • البحث عن OutOfMemoryError معيّن في جميع الأحداث الخطيرة:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.errorType="FATAL"
jsonPayload.issue.subtitle="java.lang.OutOfMemoryError"

  • للعثور على أحداث لمعرّف مشكلة معيّن في Crashlytics:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.id="ISSUE_ID"

مخطط السجلّ

يحتوي كل إدخال في السجلّ على بنية محدّدة مسبقًا وحقول قابلة للاستعلام (راجِع LogEntry).

يمكنك الاطّلاع على مخطط السجلّ للبيانات التي تم تصديرها، بما في ذلك بيانات Crashlytics وبيانات جلسات Firebase وسجلّات الجهاز.

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

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

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

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

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

أمثلة على المقاييس المستندة إلى السجلّات

في ما يلي مثالان على مقاييس مستندة إلى السجلّات يحدّدها المستخدم ويمكنك إنشاؤها من بيانات جلسات Crashlytics وFirebase التي تم تصديرها:

  • باستخدام بيانات Crashlytics:
    أنشئ مقياسًا باسم firebase/crashlytics_events مع تصنيف errorType، وحدِّده على النحو التالي:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • باستخدام بيانات جلسات Firebase:
    أنشِئ مقياسًا باسم firebase/session_events مع تصنيف eventType، وحدِّده على النحو التالي:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

ما هي الخطوات التالية؟