۱. قبل از شروع
همانطور که در بخش « اشکالزدایی آزمایشگاه کد خانه هوشمند» پوشش دادهایم، ما معیارها و گزارشهایی را برای پروژههای خانه هوشمند شما منتشر میکنیم. معیارها به شما کمک میکنند تا مشخص کنید که عملکرد خانه هوشمند شما در کجا مشکل دارد و گزارشها هنگام بررسی عمیق برای حل این مشکلات مفید هستند.
شما میتوانید با استفاده از معیارهای ارائه شده به پروژه خود، هشدارهایی را تنظیم کنید تا قطعیها را به صورت خودکار رصد کنید و در صورت بروز اختلال در سرویس، اعلان دریافت کنید. ما در حال انتشار یک معیار اطمینان برای برجسته کردن اختلالات پروژه شما هستیم که در این آزمایشگاه کد، در کنار سایر ابزارهای هشدار موجود در Google Cloud، به آن خواهیم پرداخت.
پیشنیازها
آنچه یاد خواهید گرفت
- چگونه مشکلات عملکرد و اختلالات سرویس را در پروژه خود رصد کنید.
- نحوه ایجاد هشدار مبتنی بر آستانه و دریافت اعلانها در هنگام اختلال.
- چگونه از معیار اطمینان ارائه شده به پروژه خود برای تشخیص قطعی برق استفاده کنید.
۲. نظارت بر عملکرد
نظارت بر عملکرد برای ادغام موفقیتآمیز با اکوسیستم گوگل هوم بسیار مهم است. ما مجموعهای از ابزارهای نظارتی را در اختیار توسعهدهندگان خانه هوشمند در گوگل کلود قرار میدهیم. میتوانید از این ابزارها برای ارزیابی عملکرد پروژه خود استفاده کنید.
دسترسی به داشبوردها
اولین قدم برای دسترسی به دادههایتان، بررسی داشبوردهای گوگل هوم است. برای این کار، وارد کنسول ابری گوگل شوید و به مسیر Operations > Monitoring > Dashboards بروید. خواهید دید که تعدادی داشبورد در دسترس هستند و داشبوردهای مربوط به خانه هوشمند با پیشوند Google Home Analytics ارائه میشوند.
ما داشبوردهای جداگانهای برای نمایش هر نوع ادغام ایجاد کردیم. ادغامهای ابری، محلی و Matter داشبورد مخصوص به خود را دارند و دادههای مربوط به پروتکلهای پخش دوربین در داشبورد کیفیت دوربین ارائه شدهاند. این داشبوردها فقط در صورتی حاوی دادهها خواهند بود که ادغامی از نوع مربوطه به همراه یک پروژه عملیاتی که درخواستها را برآورده میکند، داشته باشید.
وقتی یکی از این داشبوردها را باز میکنید، نمایی که میبینید به شکل زیر خواهد بود:
داشبوردها حاوی نمودارهای مختلفی هستند که جزئیات درخواستهای رسیدگی شده توسط پروژه شما را نشان میدهند. با هر داشبورد ادغام، نموداری را مشاهده خواهید کرد که تعداد کل درخواستهای رسیدگی شده توسط پروژه شما، نموداری که میزان موفقیت برای آن نوع ادغام را نشان میدهد و چندین نمودار که انواع و ویژگیهای دستگاه مربوطه را نشان میدهد.
سه نمودار وجود دارد که برای ارزیابی عملکرد اقدامات خانه هوشمند شما بسیار مهم هستند:
در طول قطعیها، معمولاً شاهد روند نزولی در درصد موفقیت و روند صعودی در نمودار تجزیه خطا خواهید بود. نظارت بر درصد موفقیت اجرا به تشخیص قطعی کمک میکند، در حالی که نگاهی به خطاهای برتر در تجزیه خطا میتواند به اشکالزدایی کمک کند. همچنین ممکن است در طول قطعیها، روند صعودی در تأخیر مشاهده کنید که میتوانید آن را در نمودارهای تأخیر درخواست مشاهده کنید.
توجه داشته باشید که نمای پیشفرض با نمودارهایی که در داشبوردهای Google Home Analytics مشاهده میکنید، فقط نمایی است که ما برای پروژه شما با استفاده از دادههای معیارهای خانه هوشمند ایجاد کردهایم. همچنین میتوانید از Metrics Explorer برای ایجاد نمودارهای خود از همان معیارهای اساسی استفاده کنید و آنها را در داشبوردهای سفارشی خود ذخیره کنید.
کاوشگر معیارها
Metrics Explorer ابزاری برای تجسم بخشهای مختلف مجموعه دادههای پروژه شماست. این ابزار در Google Cloud Console با رفتن به Operations > Monitoring > Metrics Explorer قابل دسترسی است.
گوگل کلود معیارهای مختلفی را به صورت پیشفرض ارائه میدهد، از جمله برخی که به خانه هوشمند مربوط نمیشوند. معیارهایی که ما برای خانه هوشمند ارائه میدهیم در زیر منبع "actions.googleapis.com/smarthome_action/..." فهرست شدهاند و با تایپ کردن "smarthome" در کادر انتخاب معیار، میتوان به راحتی آنها را جستجو کرد.
جستجوی عبارت "خانه هوشمند" تمام معیارهای خانه هوشمندی که ما برای پروژه شما ارائه میدهیم را نمایش میدهد. میتوانید اطلاعات دقیق در مورد هر یک از معیارهای ما را در صفحات نظارت و ثبت وقایع مستندات ما دریافت کنید.
وقتی صحبت از نظارت بر پروژه شما میشود، سادهترین معیاری که میتوان به آن اشاره کرد، معیار تعداد درخواست (که یک معیار دلتا است) است. این معیار برای هر اجرای خانه هوشمند که توسط کاربران شما آغاز میشود، یک ورودی ثبت میکند و فیلدهایی مانند نوع دستگاه، ویژگی، نوع اجرای مربوط به اجرا و فیلد وضعیت که نتیجه را نشان میدهد، ثبت میکند.
انتخاب این معیار، صفحهای را نمایش میدهد که هر سطل داده را مشابه تصویر زیر نشان میدهد:
اساساً، برای هر ترکیبی از برچسبهای داده موجود در این معیار، یک سطل وجود دارد که تغییر (دلتا) بین فواصل زمانی قبلی و فعلی را ثبت میکند. میتوان این سطلها را گروهبندی یا فیلتر کرد تا به برش داده مورد نظر خود برسید. علاوه بر این، دادهها با یک تابع ترازبندی (DELTA، MEAN، MEDIAN، SUM) در فواصل زمانی انتخاب شده ترازبندی میشوند. مگر اینکه خلاف آن مورد نیاز باشد، معمولاً از ترازبندی دلتا با یک معیار دلتا استفاده خواهید کرد.
شما میتوانید اکثر نمودارهای موجود در داشبوردهای Google Home Analytics را با استفاده از Metrics Explorer ایجاد کنید و نمودارهای خود را برای دسترسی بعدی در یک داشبورد سفارشی ذخیره کنید. برای دستیابی به نماهای پیچیدهتر، مانند نمودار نسبت، باید از MQL - Monitoring Query Language استفاده کنید.
۳. معیارهای موفقیت
وقتی صحبت از پیگیری موفقیت ادغام شما میشود، میتوانید از نرخ موفقیتی که ما از معیار تعداد درخواستهای شما محاسبه میکنیم به عنوان شاخص پایه یا از اطمینان موفقیت برای یک رویکرد تخصصیتر استفاده کنید.
میزان موفقیت
نرخ موفقیت برای تمام ادغامهای شما با تقسیم تعداد درخواستهای موفق بر کل درخواستها محاسبه میشود. میتوانید از نمودار نرخ موفقیت تکمیل سفارش در داشبورد Google Home Analytics خود به آن دسترسی داشته باشید.
نمودار نرخ موفقیت تکمیل سفارش برای نظارت بر عملکرد پروژه شما بسیار مفید است، اما هنگام ساخت داشبوردهای سفارشی یا تنظیم هشدارها چندان مفید نیست. از آنجایی که نرخ موفقیت از معیار تعداد درخواست شما مشتق میشود و به خودی خود یک معیار نیست، برای استفاده از آن با هر یک از ویژگیها، باید آن را با استفاده از MQL (زبان پرسوجوی مانیتورینگ) در Metrics Explorer از نو بسازید.
همچنین برای ردیابی اختلالات عملکردی در پروژه شما، فکر میکنیم رویکرد بسیار تخصصیتری مورد نیاز است. به همین دلیل است که ما معیار اطمینان را ایجاد کردهایم که بر اساس میزان انحراف نرخ موفقیت فعلی شما از هنجارهای تاریخی تغییر میکند.
معیار اطمینان
قطعیها میتوانند در اشکال و اندازههای مختلف برای پروژهها وجود داشته باشند. آنها میتوانند از چند ساعت تا فقط چند دقیقه طول بکشند، که میتواند شناسایی آنها را به یک چالش تبدیل کند. برای این منظور، ما یک معیار اطمینان در پروژه شما ایجاد کردهایم که یک مقدار نرمالشده برای پیشبینی قابلیت اطمینان بر اساس عملکرد گذشته ارائه میدهد. میتوانید با جستجوی smarthome در کاوشگر معیارها، و سپس انتخاب اطمینان موفقیت اجرا ، به معیار اطمینان دسترسی پیدا کنید.
وقتی عملکرد یکپارچهسازی خانه هوشمند شما در حد یا بالاتر از عملکرد تاریخی (میانگین ۷ روزه) باشد، این معیار حداکثر مقدار (۱.۰) را نشان میدهد. وقتی درصد موفقیت شما بیش از ۴ برابر انحراف معیار (که در طول ۷ روز محاسبه شده است) انحراف داشته باشد، این معیار حداقل مقدار (۰.۰) را نشان میدهد. برای مواردی که انحراف معیار خیلی کوچک است (کمتر از ۲.۵٪)، این معیار مقدار ۰.۰ را بر اساس افت ۱۰ درصدی درصد موفقیت محاسبه میکند.
برای همه موارد بینابین، این معیار مقادیری بین ۱.۰ (کاملاً مطمئن از عدم وجود قطعی برق) و ۰.۰ (حداکثر اطمینان از وجود قطعی برق) ارائه میدهد.
بنابراین هنگام تنظیم هشدار (که در بخش بعدی به آن خواهیم پرداخت)، توصیه میکنیم مقدار ۰.۵ را به عنوان آستانه در نظر بگیرید. این مقدار معادل ۲ انحراف معیار یا ۵ درصد افت (هر کدام که بیشتر باشد) خواهد بود.
۴. تنظیم هشدارها
مرحله بعدی استفاده از هر آنچه در بخش قبلی آموختهاید برای تنظیم هشدارها در پروژهتان است.
ایجاد یک سیاست هشدار
هشدار خودکار در گوگل کلود از طریق سیاستهای هشدار تنظیم میشود. میتوانید از طریق منوی کناری، عملیات > نظارت > برگه هشدار ، به سیاستهای هشدار دسترسی پیدا کنید. میتوانید با انتخاب گزینه +CREATE POLICY ، یک سیاست هشدار جدید ایجاد کنید که شما را به صفحه ایجاد سیاست هشدار میبرد:
سه بخش برای ایجاد یک سیاست هشدار وجود دارد. ابتدا باید با اضافه کردن یک شرط، مشخص کنید که میخواهید چه چیزی را ردیابی کنید. فشردن دکمه ADD CONDITION پنجرهای مشابه Metrics Explorer را نمایش میدهد که شامل برخی کنترلهای اضافی برای پیکربندی شرط است:
برای هدف، معیار اطمینانی که در بخش قبل به آن پرداختیم را انتخاب کنید. با استفاده از این معیار، مطمئن شوید که ترازکننده روی دلتا تنظیم شده است ( نمایش گزینههای پیشرفته > ترازکننده ). مرحله بعدی پیکربندی شرایط هشدار و استفاده از تنظیمات زیر است:
اگر شرط فعال شود - این پیکربندی اصلی برای تعیین زمان فعال شدن هشدارها است. انتخاب Any time series violation کار خواهد کرد زیرا قرار است یک آستانه برای معیار خود تعیین کنیم و در صورت عبور از مقدار، آن را رصد کنیم.
شرط - ما میخواهیم هشدار زمانی فعال شود که مقدار از آستانه پایینتر بیاید، بنابراین این را روی «زیر» تنظیم میکنیم. با معیار ما، ۱.۰ به این معنی است که ادغام به خوبی کار میکند و ۰.۰ نشاندهنده قطعی قطعی است.
آستانه - ما معیار اطمینان را ایجاد کردهایم تا بهترین نتایج را در زمانی که این مقدار روی ۰.۵ تنظیم شده است، ارائه دهیم. اگر میخواهید هشدارهای مکررتری داشته باشید و برای حوادث کمتر مطلع شوید، میتوانید این مقدار را افزایش دهید (حداکثر ۱.۰). متعاقباً اگر میخواهید هشدارهای کمتری دریافت کنید، فقط برای مشکلات شدیدتر، میتوانید این مقدار را کاهش دهید (حداقل ۰.۰).
برای - این تنظیم برای شناسایی مدت زمان قطعی برق قبل از دریافت هشدار است. توصیه میکنیم این تنظیم را در آخرین مقدار نگه دارید تا در صورت عبور از هر نقطهای از آستانه، هشدار دریافت کنید. معیار اطمینان ما هر ۱۵ دقیقه منتشر میشود و میانگین موفقیت در آن دوره را بررسی میکند.
پس از تکمیل افزودن شرط، مرحله بعدی انتخاب کانال اعلان است. سادهترین روش اعلان، هشدارهای ایمیلی است. میتوانید ایمیلی را که در منوی کشویی کانالهای اعلان فهرست شده است، انتخاب کنید:
اگر گزینه «اعلان در مورد بسته شدن حادثه» را علامت بزنید، پس از علامتگذاری حادثه به عنوان «بسته»، یک اعلان دیگر ارسال خواهد شد. در این صورت، باید مدت زمان بسته شدن خودکار حادثه را نیز انتخاب کنید که به طور پیشفرض ۷ روز تعیین شده است.
مرحله آخر این است که به هشدار خود یک نام بدهید و هر سندی را که میخواهید در اعلانها گنجانده شود، اضافه کنید.
ارائه مستندات توصیه میشود، به خصوص اگر شما کسی نیستید که هشدار را دریافت میکند. اضافه کردن مراحلی مانند محل بررسی در حین حادثه و نحوه اولویتبندی و اشکالزدایی میتواند در هنگام قطع برق مفید باشد. در صورت نیاز میتوانید به راهنمای عیبیابی ما مراجعه کنید.
پس از ذخیره، سیاست هشدار شما در بخش سیاستها در صفحه هشدار فهرست خواهد شد.
۵. کاهش قطعیها
پس از تنظیم هشدارها، در صورت قطع برق از طریق کانالهای اعلانی که ارائه کردهاید، به شما اطلاع داده میشود و همچنین یک ورودی حادثه در صفحه هشدار ایجاد میشود.
دریافت هشدارها
کانال هشداری که در این آزمایشگاه کد ارائه دادیم، یک ایمیل بود. پس از تنظیم، امیدواریم هیچ هشداری دریافت نکنید (قطعی برق نداشته باشید)، اما اگر دریافت کنید، اعلان به شکل زیر خواهد بود:
توجه داشته باشید که اعلان هشدار، مقدار مشاهدهشدهای که از آستانهی مشخصشده توسط شما عبور میکند را ارائه میدهد، و همچنین یک مهر زمانی که زمان شروع حادثه را مشخص میکند.
نظارت بر حوادث
با وقوع حوادث، آنها نیز در بخش حوادث در صفحه هشدار شمارش میشوند.
شما میتوانید روی حادثه خاص کلیک کنید تا جزئیات مربوط به قطعی برق، مانند مدت زمان یا شدت آن را مشاهده کنید.
به یاد داشته باشید، وقتی هشدارهایی دریافت میکنید، بهترین قدم اول این است که نگاهی به معیارهای خود بیندازید، سپس خطاهایی را که باعث قطعی برق شما شدهاند در گزارشهای خود جستجو کنید. میتوانید در آزمایشگاه کد «اشکالزدایی خانه هوشمند» ما، نحوه انجام این کار را مرور کنید.
۶. تبریک
تبریک! شما با موفقیت یاد گرفتید که چگونه با استفاده از معیارهای ارائه شده به پروژه خود، هشدارهایی را تنظیم کنید تا قطعیها را به صورت خودکار رصد کنید و در هنگام اختلال در سرویس، اعلان دریافت کنید.
مراحل بعدی
با تکیه بر این Codelab، تمرینهای زیر را امتحان کنید و منابع اضافی را بررسی کنید:
- شما میتوانید آموختههای خود در این آزمایشگاه کد را با سایر معیارهای ارائه شده به پروژه خود ترکیب کنید. میتوانید لیست کامل معیارهای موجود را در بخش معیارهای پشتیبانی شده در صفحه نظارت مشاهده کنید.
- انواع دیگر کانالهای اعلان برای هشدارها را که در صفحه گزینههای اعلان در مستندات Google Cloud توضیح داده شدهاند، بررسی کنید.