1. Başlamadan önce
Akıllı Ev'de hata ayıklama codelab'inde açıkladığımız gibi, Akıllı Ev projeleriniz için metrik ve günlükler yayınlıyoruz. Metrikler, Akıllı Ev İşleminizin nerede sorun yaşadığını belirlemenize yardımcı olur. Günlükler, bu sorunları çözmek için ayrıntılı bir inceleme yaparken faydalıdır.
Kesintileri otomatik bir şekilde izlemek ve hizmet kesintileri sırasında bildirim almak için projenize sağlanan metrikleri kullanarak uyarılar oluşturabilirsiniz. Projenizle ilgili aksaklıkları vurgulamak için bir güven metriği yayınlıyoruz. Bu metrikleri bu codelab'de ve Google Cloud Platform'da size sunulan diğer tüm uyarı araçlarıyla birlikte ele alacağız.
Ön koşullar
- Akıllı Evle Çalışır entegrasyonuna sahip olmalısınız.
- Akıllı Ev'de hata ayıklama codelab'ini tamamlayın.
Neler öğreneceksiniz?
- Projenizdeki performans sorunlarını ve hizmet aksaklıklarını izleme.
- Eşik tabanlı uyarı oluşturma ve kesintiler sırasında bildirim alma.
- Kesintileri tespit etmek için projenize sunulan güven metriğini kullanma.
2. Performans İzleme
Performansı izlemek, Google Akıllı Ev Ekosistemi ile başarılı bir entegrasyon için kritik öneme sahiptir. Google Cloud Platform'da akıllı ev geliştiricilerine bir dizi izleme aracı sunuyoruz. Projenizin performansı hakkında bir fikir edinmek için bu araçları kullanabilirsiniz.
Kontrol Panellerine Erişim
Verilerinize erişmenin ilk adımı, Google Cloud Console'a giriş yapıp İşlemler > İzleme > Kontrol Panelleri'ne giderek Google Home kontrol panellerini kontrol etmektir. Çeşitli kontrol panelleri olduğunu ve akıllı ev kontrol panellerinde Google Home Analytics önekinin bulunduğunu göreceksiniz.
Her entegrasyon türünü temsil eden ayrı bir kontrol paneli oluşturduk. Cloud, Local ve Matter entegrasyonlarının kendi kontrol panelleri vardır ve kamera akış protokollerine ilişkin veriler Kamera Kalitesi kontrol panelinde sağlanır. Bu kontrol panellerinde yalnızca istekleri yerine getiren çalışan bir projenin yanı sıra karşılık gelen türde bir entegrasyonunuz varsa veri yer alır.
Bu kontrol panellerinden birini açtığınızda, aşağıdaki gibi bir görünüm elde edersiniz:
Kontrol panelleri, projenizin ele aldığı isteklerin ayrıntılarını gösteren çeşitli grafikler içerir. Her entegrasyon kontrol panelinde, projenizin ele aldığı toplam istek sayısını gösteren bir grafik, söz konusu entegrasyon türünün başarı oranını gösteren bir grafik ve ilgili cihaz türleri ile özellikleri gösteren çeşitli grafikler görürsünüz.
Akıllı Ev işlemlerinizin performansını değerlendirmek için kritik olan üç grafik vardır:
Kesintiler sırasında genellikle başarı yüzdesinde düşüş ve hata dökümü grafiğinde artış görürsünüz. Yürütme başarısı yüzdesini izlemek, kesintiyi fark etmeye yardımcı olurken hata dökümündeki en yaygın hataları incelemek hata ayıklamaya yardımcı olabilir. Ayrıca kesintiler sırasında gecikmede bir artış gözlemleyebilirsiniz. Bunu istek gecikmesi grafiklerinde görebilirsiniz.
Google Home Analytics kontrol panellerinde gördüğünüz grafikleri içeren varsayılan görünüm, yalnızca akıllı ev metrik verilerini kullanarak projeniz için oluşturduğumuz bir görünümdür. Aynı temel metriklerden kendi grafiklerinizi oluşturmak ve bunları özel kontrol panellerinize kaydetmek için Metrik Gezgini'ni de kullanabilirsiniz.
Metrik Gezgini
Metrik Gezgini, projenizin veri kümesinin kesitlerini görselleştirmeye yarayan bir araçtır. Bu araca Google Cloud Console'da İşlemler > İzleme > Metrik Gezgini bölümünden erişebilirsiniz.
Google Cloud, bazıları akıllı evlerle ilgili olmayanlar da dahil olmak üzere kullanıma hazır birçok metrik sağlar. Akıllı ev için sağladığımız metrikler, "actions.googleapis.com/smarthome_action/..." kaynağının altında listelenir ve metrik seçim kutusuna "smarthome" yazılarak kolayca aranabilir.
"Akıllı ev" araması yaptığınızda projenize sunduğumuz tüm akıllı ev metrikleri gösterilir. Belgelerimizin İzleme ve Günlük Kaydı sayfalarında metriklerimizin her biri hakkında ayrıntılı bilgi edinebilirsiniz.
Projenizi izlemek söz konusu olduğunda, başvurulması gereken en basit metrik İstek sayısı metriğidir (bu bir delta metriği). Bu metrik, kullanıcılarınız tarafından başlatılan her akıllı ev yürütme işlemi için bir giriş kaydeder. Ayrıca cihaz türü, özellik, yürütmede yer alan yürütme türü ve sonucu gösteren durum alanı gibi alanları kaydeder.
Bu metriği seçtiğinizde, her bir veri grubunu aşağıdakine benzer bir şekilde gösteren bir ekran oluşturulur:
Esas olarak, bu metrikte bulunan her veri etiketi kombinasyonu için önceki ve geçerli zaman aralıkları arasındaki değişimi (delta) kaydeden bir paket bulunur. Aradığınız görünüm veri dilimini elde etmek için bu grupları gruplandırabilir veya filtreleyebilirsiniz. Ayrıca veriler, bir hizalama işleviyle (DELTA, MEAN, MEDIAN, SUM) seçilen zaman aralıklarına hizalanır. Aksi takdirde, genellikle Delta hizalamasını bir delta metriğiyle kullanırsınız.
Google Home Analytics kontrol panellerinde bulunan grafiklerin çoğunu Metrik Gezgini'ni kullanarak oluşturabilir ve daha sonra özel bir kontrol panelinde erişmek için grafiklerinizi kaydedebilirsiniz. Oran grafiği gibi daha karmaşık görünümler elde etmek için MQL - İzleme Sorgu Dili'ni kullanmanız gerekir.
3. Başarı Ölçüleri
Entegrasyon başarınızı izlemek söz konusu olduğunda, istek sayısı metriğinize göre hesapladığımız başarı oranını temel gösterge olarak veya daha özelleştirilmiş bir yaklaşım için başarı güvenini kullanabilirsiniz.
Başarı Oranı
Tüm entegrasyonlarınızın başarı oranı, başarılı istek sayısının tüm isteklere bölünmesiyle hesaplanır. Google Home Analytics kontrol panelinizdeki sipariş karşılama başarı oranı grafiğinden erişebilirsiniz.
Sipariş Karşılama Başarı Oranı grafiği, projenizin performansını izlemek için çok yararlıdır, ancak özel kontrol panellerinizi oluştururken veya uyarılar oluştururken pek yararlı olmaz. Başarı oranı kendi başına bir metrikten değil, istek sayısı metriğinizden türetildiğinden, bu iki özellikten biriyle kullanmak için Metrik Gezgini'nde MQL (Monitoring Query Language) kullanarak yeniden oluşturmanız gerekir.
Ayrıca, projenizdeki performans kesintilerini takip etmek için çok daha özel bir yaklaşıma ihtiyaç olduğunu düşünüyoruz. Bu nedenle, mevcut sipariş karşılama başarı oranınızın geçmiş normlardan ne kadar saptığına bağlı olarak değişen güven metriği oluşturduk.
Güven Metriği
Kesintiler projelerde farklı şekillerde ve boyutlarda olabilir. Bu çözümler birkaç saat ile birkaç dakika arasında sürebileceğinden, kullanıcıların tanımlanması zor olabilir. Bunun için projenizde geçmiş performansa dayanarak güvenilirliği tahmin etmek üzere normalleştirilmiş bir değer sağlayan bir Güven Metriği oluşturduk. Güven metriğine, metrik gezgininde akıllı ev araması yapıp Yürütme başarı güveni'ni seçerek erişebilirsiniz.
Akıllı ev entegrasyonunuz geçmiş performansa (7 günlük ortalama) eşit veya bu değerin üzerinde olduğunda bu metrik, maksimum değeri (1,0) verir. Başarı yüzdeniz 4 standart sapmadan daha fazla sapma gösterdiğinde (7 gün içinde hesaplanır), bu metrik minimum değeri (0,0) verir. Standart sapmaların çok küçük olduğu (%2,5'ten az) durumlarda bu metrik, 0,0 değerini başarı yüzdesine göre% 10'luk bir düşüş temel alarak belirler.
Bu metrik, tüm durumlar için 1,0 (kesinti olmadığından tamamen emin olun) ile 0,0 (kesinti olduğuna dair maksimum güven) arasında değerler sağlar.
Bu nedenle, bir uyarı oluştururken (bir sonraki bölümde) eşik olarak 0,5 değerini baz almanızı öneririz. Bu, 2 standart sapmaya veya% 5'lik bir düşüşe (hangisi daha yüksekse) karşılık gelir.
4. Uyarıları Ayarlama
Sonraki adım, projenizde uyarılar oluşturmak için önceki bölümde öğrendiğiniz her şeyi kullanmaktır.
Uyarı Politikası Oluşturma
Google Cloud Platform'daki otomatik uyarılar, Uyarı Politikaları aracılığıyla ayarlanır. Uyarı Politikaları'na, yan menüdeki İşlemler > İzleme > Uyarılar sekmesinden erişebilirsiniz. +OLUŞTUR POLİTİKA OLUŞTUR seçeneğini belirleyerek yeni bir uyarı politikası oluşturabilirsiniz. Bunu yaptığınızda uyarı politikası oluşturma ekranına yönlendirilirsiniz:
Uyarı politikası oluşturmak üç bölümden oluşur. Öncelikle bir koşul ekleyerek neyi izlemek istediğinizi belirlemeniz gerekir. KOŞUL EKLE düğmesine basıldığında, koşulu yapılandırmak için bazı ek kontroller içeren Metrik Gezgini'ne benzer bir pencere açılır:
Hedef için, önceki bölümde ele aldığımız güven metriğini seçin. Bu metriği kullanarak hizalayıcı değerinin delta değerine ayarlandığından emin olun (Gelişmiş Seçenekleri Göster > Hizalayıcı). Sonraki adım, uyarı koşulunu yapılandırmak ve aşağıdaki ayarları kullanmaktır:
Koşulun tetikleneceği durumlar: Uyarıların ne zaman tetikleneceğini belirleyen ana yapılandırmadır. Metriğimizde bir eşik belirleyip değerin aşıp aşmadığını izleyeceğimiz için Tüm zaman serisi ihlallerinde'yi seçmeniz işe yarayacaktır.
Durum: Değer, eşiğin altına düştüğünde uyarının tetiklenmesini istediğimizden, bunu şunun altında olarak ayarlarız. Metriğimizde 1.0 değeri entegrasyonun düzgün çalıştığını, 0.0 değeri ise kesinlikle kesinti olduğunu gösterir.
Eşik: Bu değer 0,5 olarak ayarlandığında en iyi sonuçları sağlamak için güven metriğini oluşturduk. Daha sık uyarı almak ve daha az sayıda olayla ilgili bildirim almak istiyorsanız bu değeri artırmayı deneyebilirsiniz (maks.1, 0). Daha sonra, yalnızca daha ciddi sorunlar için daha az uyarı almak isterseniz bu değeri azaltmayı deneyebilirsiniz (min.0, 0).
Süre: Bu, uyarı almadan önce kesintinin ne kadar sürmesi gerektiğini belirleyen ayardır. Eşiği aşan herhangi bir noktayla ilgili uyarı almak için bu ayarı en son değerde tutmanızı öneririz. Güven metriğimiz, bu dönemdeki ortalama başarı oranına bakılarak her 15 dakikada bir yayınlanır.
Bir koşul eklemeyi tamamladıktan sonra, sıradaki adım bildirim kanalını seçmektir. En basit bildirim yöntemi, e-posta uyarılarıdır. Bildirim Kanalları açılır listesinin altında listelenen bir e-posta adresini seçebilirsiniz:
Olay kapandığında bildir seçeneğini işaretlerseniz, olayın kapalı olarak işaretlenmesinin ardından başka bir bildirim gönderilir. Bu durumda, varsayılan olarak 7 gün şeklinde belirtilmiş bir Olay otomatik kapanma süresi de seçmeniz gerekir.
Son adım, uyarınıza bir ad vermek ve bildirimlere dahil edilmesini istediğiniz tüm dokümanları eklemektir.
Özellikle uyarıyı alacak kişi siz değilseniz belge sağlamanız önerilir. Olay sırasında kontrol edilecek yer, önceliklendirme ve hata ayıklama gibi adımlar eklemek kesinti sırasında yardımcı olabilir. Gerektiğinde Sorun Giderme Kılavuzumuzu inceleyebilirsiniz.
Uyarı politikanız kaydedildikten sonra Uyarılar sayfasındaki Politikalar bölümünde listelenir.
5. Kesintileri Azaltma
Uyarıları ayarladıktan sonra, hizmet kesintileri sırasında sağladığınız bildirim kanallarından bildirim alırsınız ve Uyarılar sayfasında bir olay girişi oluşturulur.
Uyarı Alma
Bu codelab'de sağladığımız uyarı kanalı bir e-postaydı. Bu ayarları yaptıktan sonra herhangi bir uyarı almazsınız (kesinti olmaz), ancak bunu yaptığınızda bildirim aşağıdaki gibi görünür:
Uyarı bildiriminde, belirlediğiniz eşiği aşan gözlemlenen değer ve olayın ilk başladığı zamanı özetleyen bir zaman damgası olduğuna dikkat edin.
Olayları İzleme
Bir olay meydana geldikçe, Uyarılar sayfasındaki olaylar bölümünde de sayılır.
Kesintiyle ilgili ayrıntıları (örneğin, ne kadar sürdüğü veya ne kadar ciddi olduğu gibi) görmek için söz konusu olayı tıklayabilirsiniz.
Uyarı alırken atılacak en iyi ilk adımın metriklerinize göz atıp ardından günlüklerinizde kesintinize neden olan hataları aramaktır. Akıllı Ev'de Hata Ayıklama konulu codelab'imize göz atarak bunları nasıl yapabileceğinizle ilgili bilgilerinizi tazeleyebilirsiniz.
6. Tebrikler
Tebrikler! Projenizde sunulan metrikleri kullanarak, kesintileri otomatik bir şekilde izlemek ve hizmet kesintileri sırasında bildirim almak için nasıl uyarı oluşturacağınızı öğrendiniz.
Sonraki adımlar
Bu Codelab'den yola çıkarak aşağıdaki alıştırmaları yaparak ek kaynakları keşfedin:
- Bu codelab'de öğrendiklerinizi projenize sağlanan diğer metriklerle birleştirebilirsiniz. Kullanılabilir metriklerin tam listesini İzleme sayfasının Desteklenen Metrikler bölümünde görebilirsiniz.
- Google Cloud Platform dokümanlarının Bildirim Seçenekleri sayfasında açıklanan, uyarılar için diğer bildirim kanalı türlerini keşfedin.