Akıllı Ev Kesintilerini İzleme

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.

dd44868a4ff2df6e.png

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

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.

317697e52ced2437.png

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:

f8bfd69286c569a4.png

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:

f511fafd3aaaa1eb.png

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.

538d851edfd34764.png

"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:

b1c18141d15a0e09.png

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.

55ea8930fbf48d9e.png

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.

ab467a1777281526.png

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:

6e417d88c2274b3d.png

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:

df1ccf7da741e1c7.png

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:

4192e0f4ea00dd28

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:

3cc10629830e7f13.png

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.

686fb1c537fee10.png

Ö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.

c71a001e4df035ee.png

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:

43217b0a145c2cd.png

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.

fdd883a9604ed981.png

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

17d485868a6771bc.png

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.