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

1. قبل البدء

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

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

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

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

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

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

2. التعامل مع السجلات

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

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

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

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

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

كتابة طلبات البحث

يتم نشر السجلات للمشاريع ضمن نوع مورد. يمثل كل نوع من أنواع الموارد نظامًا أساسيًا مختلفًا داخل Google. إنّ السجلّات الواردة من منصة المنزل المزوّد بأجهزة ذكية متوفّرة لمشروعك ضمن نوع المصدر "assistant_action_project".

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

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

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

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

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

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

وبعد تفعيلها، سترى توزيعًا للسجلات التي تطابق طلب بحثك:

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

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

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

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

action

• trait: استهداف سمة الجهاز حسب المستخدم (مثل OnOff وStartStop وBrightness)
• 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"

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

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

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

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

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

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

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

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

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

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

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

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

بعد أن تم إنشاء مقياس مستند إلى السجلّ، سيصبح متاحًا في قسم المقاييس من تحديد المستخدم من صفحة المقاييس المستندة إلى السجلّ.

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

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

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

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

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

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

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

4. تهانينا

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

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

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

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