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

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

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

• إنشاء رسومات بيانية مؤقتة لعرض البيانات بسرعة

• إنشاء لوحات بيانات مخصّصة للمراقبة المتقدّمة على المدى الطويل:

• إعداد تنبيهات مخصّصة وإرسالها إلى قنوات إشعارات مخصّصة