المقاييس المستنِدة إلى السجلّ للمنزل المزوّد بأجهزة ذكية

1- قبل البدء

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

848f483bfcd2997a.png

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

المتطلبات الأساسية

المعلومات التي ستطّلع عليها

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

2- التعامل مع السجلّات

كما تناولنا باختصار في تصحيح أخطاء الدرس التطبيقي حول ترميز المنزل الذكي، يُعدّ العمل باستخدام السجلات عاملاً أساسيًا لنجاح مشروعك. تتوفّر أدوات رائعة على Google Cloud Platform لمراقبة سجلّاتك وتحليلها. للوصول إلى جميع السجلات المتاحة لمشروعك، يمكنك استخدام مستكشف السجلات.

الوصول إلى السجلّات

إنّ الخطوة الأولى للوصول إلى سجلّاتك هي تسجيل الدخول إلى Google Cloud Platform واختيار مشروعك. انتقِل إلى مستكشف السجلات باستخدام القائمة الجانبية، من خلال الانتقال إلى العمليات > التسجيل > مستكشف السجلات. بعد فتح الأداة، من المفترض أن ترى هذا العرض:

78982d8b6d19b827.png

يتكوّن مستكشف السجلات من قسمين رئيسيين: قسم لكتابة طلبات البحث أعلاه (أداة إنشاء طلبات البحث)، ومساحة لعرض النتائج المطابقة (نتائج طلب البحث).

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

طلبات البحث

يتم نشر السجلّات للمشاريع ضمن نوع مورد. ويمثل كل نوع من أنواع الموارد نظامًا أساسيًا مختلفًا في Google. تتوفّر السجلّات الواردة من منصة Smart Home لمشروعك ضمن نوع المرجع assistant_action_project.

ويتم أيضًا تعيين مستوى خطورة لجميع السجلات عند إنشائها. في سجلّات المنزل الذكي، نستخدم المستوى ERROR للسجلّات التي تمثّل الأخطاء والاستثناءات، والمستوى DEBUG لكل العناصر الأخرى.

في المثال التالي، سنكتب استعلامًا لتصفية السجلات الواردة من نظامنا الأساسي فقط والتي تمثل الأخطاء، وذلك على النحو التالي:

753bfe72a9f8e959.png

بمجرد الانتهاء من كتابة الاستعلام، انقر فوق الزر Run query (تشغيل الاستعلام) لبدء الاستعلام. من المفترض أن يؤدي ذلك إلى ظهور أخطاء ناتجة عن دمج المنزل المزوّد بأجهزة ذكية:

3ef42da5a6c322e1.png

يتّضح مما سبق أن لاحظنا عددًا من الأخطاء التي حدثت في أوقات مختلفة خلال الساعة الماضية. ويمثل كل سطر سجل أخطاء واحدًا. يمكنك أيضًا النقر على السجلّات الفردية وتوسيع الحقول المتداخلة للاطّلاع على المعلومات المضمَّنة فيها.

استخدام المدرّج التكراري

يوفر مستكشف السجلات ميزة مدرّج تكراري مفيدة لمعرفة توزيع وقت السجلات التي تطابق طلب بحثك. لتنشيط المدرج التكراري، انقر على تخطيط الصفحة من الأزرار في الزاوية العلوية اليسرى وحدد المدرج التكراري لتفعيل الميزة.

10eaf1d204decf3c.png

بعد تفعيل هذه الميزة، سيظهر لك توزيع للسجلّات التي تتطابق مع طلب بحثك:

dd3410e65a83cf5d.png

وكما ترى في الصورة أعلاه، لدينا العديد من الأخطاء التي تم تجميعها بشكل متفرق في الساعة الماضية. يبدو أنها تشكل ثلاث مجموعات عنقودية حوالي 1:45 و2:00 و2:15 بعد الظهر. يمكن أن يساعدك المدرّج التكراري في اكتشاف الأنماط التي يصعب رؤيتها عن طريق التحقق من قيم الطابع الزمني فقط.

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

طلبات البحث المتقدّمة

عند فحص سجلّ أحداث المنزل المزوّد بأجهزة ذكية، ستظهر لك حقول مختلفة يمكنك جمع المعلومات منها:

825c57c36800844e.png

action

  • trait: استهداف سمة الجهاز حسب المستخدِم (على سبيل المثال، Onإيقاف، وStartStop، والسطوع)
  • actionType: الحالة الدقيقة للسمة (مثلاً، تفعيل أو إيقاف أو إيقاف مؤقت أو إيقاف أو استئناف)

device

  • deviceType: استهداف نوع الجهاز حسب المستخدِم (على سبيل المثال، الضوء أو مفتاح تبديل أو غسّالة)

status

  • isSuccess: ما إذا كانت نتيجة الإجراء ناجحة (صحيح / خطأ)
  • statusType: رمز الحالة لنتيجة الإجراء (يشير إلى رمز خطأ في حال لم يتم ذلك)
  • externalDebugString: سلسلة تصحيح أخطاء الإجراء (تصف الخطأ بالتفصيل)

حقول أخرى

هناك أيضًا حقول إضافية يمكنك اشتقاق معلومات منها:

  • requestId: معرّف فريد مرتبط بالطلب (تنشئه Google)
  • executionType: المسار الذي يستخدمه الطلب (يشير إلى ما إذا كانت السحابة الإلكترونية أو المستوى المحلي)
  • latencyMsec: وقت الاستجابة الذي تم رصده للطلب على خوادم Google (بالمللي ثانية)
  • locale: زوج اللغة/المنطقة الذي يتم إرسال الطلب منه (مثلاً en-US, fr-FR)

باستخدام حقل السمات من القائمة أعلاه، سنعدِّل طلب البحث لتضمين الأخطاء الواردة من السمة OnOff فقط على النحو التالي:

resource.type="assistant_action_project" AND severity=ERROR AND
jsonPayload.executionLog.executionResults.actionResults.action.trait="TRAIT_ON_OFF"

بعد تشغيل الاستعلام المحدّث، يحدد النظام السجلات ويعرض لنا النتيجة المقابلة:

76176d7a41962341.png

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

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

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

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

لإنشاء مقياس مستند إلى سجلّ، انتقِل إلى العمليات > التسجيل > المقاييس المستندة إلى السجلّ. سيُظهر لك هذا قائمة المقاييس المستندة إلى السجل المتوفرة بالفعل في مشروعك. بعد النقر على الزر إنشاء مقياس، ستظهر لك شاشة إنشاء المقياس المستند إلى السجلّ:

296af6e7d8dcf6cf.png

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

بالتمرير لأسفل سترى قسمًا للتصفية يمكنك من خلاله كتابة طلب البحث.

f7f2093fa1bce2ac.png

سنلصق طلب البحث من القسم السابق في مربّع النصّ إنشاء فلتر.

​​resource.type="assistant_action_project" AND severity=ERROR AND
jsonPayload.executionLog.executionResults.actionResults.action.trait="TRAIT_ON_OFF"

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

عرض بيانات المقاييس المستندة إلى السجلّ

الآن وبعد إنشاء المقياس المستند إلى السجلّ، سيكون متاحًا في قسم المقاييس التي يحدِّدها المستخدِم في صفحة "المقاييس المستندة إلى السجلّ".

1b2c88c18533fbcd.png

من القائمة المقابلة للمقياس المستند إلى السجلّ (3 نقاط)، انقر على عرض في مستكشف المقاييس للاطّلاع على البيانات التي تم جمعها في المقياس المستند إلى السجلّ:

54a836fdc3a666a3.png

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

المراقبة من خلال لوحات البيانات المخصّصة

بعد أن نلاحظ أنّ المقياس الجديد المستند إلى السجلّ يعمل على النحو المطلوب، يحين وقت حفظ عرض الرسم البياني هذا في لوحة بيانات مخصّصة. لإجراء ذلك، انقر على الزر Save Chart (حفظ الرسم البياني) في أعلى يسار صفحة مستكشف المقاييس. سيؤدي ذلك إلى ظهور مطالبة بتسمية المخطط وتحديد لوحة المعلومات التي تريد الحفظ فيها:

52329085f841782e.png

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

44961e7cb3663341.png

لقد حفظنا الرسم البياني في لوحة بيانات باسم "لوحة بيانات الدرس التطبيقي حول الترميز". سيؤدي فتحه إلى عرض العرض التالي:

f7e025c27f30f996.png

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

4- تهانينا

674c4f4392e98c1.png

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

الخطوات التالية

بناءً على هذا الدرس التطبيقي حول الترميز، جرِّب التمارين التالية واستكشِف مراجع إضافية:

  • اطلع على دليل إنشاء مقاييس التوزيع لإنشاء مقاييس مستندة إلى السجل في الحقول الرقمية مثل وقت الاستجابة.
  • راجِع مكتبة نماذج طلبات البحث التي تقدّمها Google Cloud للاطّلاع على بعض الفلاتر المعقدة التي يمكنك استخدامها للمقاييس المستنِدة إلى السجلّ.