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

بعد تصدير بيانات 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"

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