Google Home Vitals (Cloud)

Bu kontrol paneli ve uyarı paketi, Google Home ekosistemiyle yüksek kaliteli bir entegrasyonu proaktif olarak sürdürmenize yardımcı olur. Google, tüm müşteriler için yüksek kaliteli bir ekosistem geliştirmede iş ortaklarını desteklemeye kararlıdır.

Gösterge tablosu üç bölümden oluşur. Bu bölümlerin her biri, genel entegrasyon kalitesine katkıda bulunan önemli bir parçayı kapsar.

1. Google'dan İş Ortağı Metriklerine: Google'dan bulut arka ucunuza yapılan çağrıların durumunu ölçer.

2. Sistem Sağlığı - İş Ortağından Google'a Yönelik Metrikler: Sisteminizden Google'a yapılan çağrıların sağlığını ölçer.

3. Cihaz Sağlığı - Durum Doğruluğu: Kullanıcı sorgularına yanıt vermek için kullanılan Google sistemlerinde depolanan durumların doğruluğunu ölçer.

Metrikler hedef değerlerini karşılamadığında, kullanıcı deneyimini etkileyebilecek bir sorunu belirtmek için kırmızı renkle vurgulanır. Aşağıdaki bilgilerde her hedef ve bunun kullanıcılarınız için neden önemli olduğu hakkında ayrıntılar verilmektedir.

Aşağıdaki düğme sizi doğrudan kontrol paneline yönlendirmiyorsa Genel Bakış sayfasını seçip Kontrol Panelleri'ni tıklayarak ve ardından Kontrol Panellerim listesinden Google Home Vitals Kontrol Paneli (Bulut)'u seçerek kontrol panelinizi görüntüleyebilirsiniz.

Kontrol Paneli'ne git

Google'dan iş ortağına metrikler

Sorgu/Yürütme Başarı Oranı >=%99,5 metriği, kullanıcıların komutlarının ne sıklıkta doğru şekilde yerine getirildiğini ölçer.Bu metrik, "Cihaza erişemiyorum" gibi Asistan yanıtlarını veya yerine getirilmeyen bir komutun yanlışlıkla onaylanmasını önlemeye yardımcı olur.

"Başarı"yı ne tanımlar?

Google Home platformu, amaçlanan işlemin gerçekleştirildiğini veya istenen durumun alındığını belirten geçerli bir yanıt aldığında işlem başarılı olarak işaretlenir.

Engelleyici olmayan istisnalar içeren yanıtlar (ör. SUCCESS durumuyla birlikte lowBattery istisnası) başarılı işlemler olarak sayılır. Komut, uyarıya rağmen cihaza ulaştı ve amaç karşılandı.

"Başarısızlık" ne anlama gelir?

Sık karşılaşılan platform hata kodları sayfasında bulunan ve İş Ortağı Tarafından Yapılabilecek İşlem olarak işaretlenen hatalar, SORGULAMA ve YÜRÜTME Başarı Oranları hesaplanırken "Başarısızlık" olarak kabul edilir.

Sorgu/Yürütme Gecikmesi (p90) <= 1000 ms metriği, istenen işlemin bekleme süresini ölçer ve kullanıcıların çok uzun süre beklememesini sağlar. Örneğin, ışıklarının kapanması için birkaç saniye beklemeleri gibi.

Gecikme metrikleri

Gecikme, entegrasyonunuzun son kullanıcıya ne kadar hızlı yanıt verdiğinin önemli bir göstergesidir. Kontrol panelinde, "en yavaş" kullanıcılarınızın deneyimini temsil eden 90. yüzdelik dilim (P90) gecikmesi izlenir (örneğin, 800 ms'lik bir P90, isteklerin% 90'ının 800 ms veya daha kısa sürede onaylandığı anlamına gelir).

Google, teknik doğruluğu sağlamak için durum kontrolleri ile cihaz komutlarındaki gecikmeyi farklı şekilde ölçer.

1. QUERY Latency (Interrogative)

Bu metrik, Google bir cihazın mevcut durumunu istediğinde Cloud-to-cloud gidiş dönüş süresini ölçer.

• Başlangıç: Google, karşılama URL'nize bir action.devices.QUERY isteği gönderir.
• Ölçüm Penceresi: Bulutunuzun tam HTTP yanıtını alması, işlemesi ve Google'a geri iletmesi için geçen süre.
• Son: Google, hizmetinizden gelen son yanıt yükünü alır ve onaylar.

2. EXECUTE Gecikmesi (İşlem)

Bu metrik, Google bir cihaza kontrol isteği gönderdiğinde komut onay süresini ölçer.

• Başlangıç: Google, karşılama URL'nize action.devices.EXECUTE isteği gönderir.
• Ölçüm Penceresi: Bulutunuzun komutu alıp onay yanıtı göndermesi için geçen süre.
• Bitiş: Google, SUCCESS, PENDING veya OFFLINE durum yanıtını alır.
• Teknik Kapsam: Bu metrik, Google'ın bulutu ile sizin bulutunuz arasındaki"Yanıt Onayı" süresini ölçer. Bu metrik, fiziksel donanımın (ör. ampul) fiziksel durum değişikliğini tamamlaması için gereken süreyi ölçmez. Bu işlem genellikle buluttan buluta yolu dışındaki yerel bağlantılı ağ gecikmesini içerir.

Gecikmeyi azaltma seçenekleri

Coğrafi yönlendirme için mimari öneriler

Anycast IP uygulaması mümkün değilse kullanıcıların en yakın bölgesel veri merkezinden hizmet almasını sağlamak için aşağıdaki uygun maliyetli alternatifleri öneririz.

1. Global Load Balancing (GLB)

   Statik yönlendirme yerine Global Application Load Balancer'ı kullanın (en büyük bulut sağlayıcıların çoğunda kullanılabilir).

   • Nasıl çalışır? Ağın kenarında bulunan tek bir global giriş noktası (URL) yapılandırırsınız. Yük dengeleyici, Google'ın karşılama kümelerinden gelen isteğin coğrafi kaynağını otomatik olarak algılar ve trafiği en yakın bölgesel sağlıklı arka uca yönlendirir.

   • Avantaj: Bu, Anycast'in performansını önemli ölçüde daha düşük yapılandırma karmaşıklığı ve maliyetle sağlar.

2. Coğrafi Konuma Duyarlı DNS (GeoDNS)

   • İşleyiş şekli: DNS sağlayıcınızı, DNS sorgusunun coğrafi konumuna göre karşılama URL'nizi farklı IP adreslerine çözümleyecek şekilde yapılandırın.

   • Uygulama: DNS sağlayıcınızın Google'ın çıkış noktaları için optimize edildiğinden emin olun. Google'ın bölgesel karşılama hizmetleri (ör. ABD, AB veya Asya'da) alan adınızı çözümlediğinde, söz konusu bölgedeki veri merkezinin IP adresini alır.

Uygulama katmanındaki optimizasyon stratejileri

Altyapı düzeyinde yönlendirmenin ötesinde, istek işlemedeki gecikmeyi azaltmak için uygulama katmanında aşağıdaki stratejileri uygulayabilirsiniz.

1. "Trambolin" Proxy Yöntemi

   Birincil veri merkezini korumanız gerekiyorsa ilk el sıkışmayı işlemek için bölgesel hafif proxy sunucular (Trambolinler) kullanın.

   1. Google, global URL'nize erişir.

   2. İsteği bölgesel bir proxy (ör. basit bir Nginx veya Lambda işlevi) alır.

   3. Proxy, yükü dahili ve yüksek hızlı omurganız üzerinden birincil veritabanına yönlendirir.

   Avantaj: Bu, genellikle uzun mesafeli isteklerde gecikmeye en büyük katkıyı sağlayan "TCP el sıkışma" süresini kısaltır.

2. Erişim Jetonu Bölge İpuçları

   Hesap bağlama (OAuth) işlemi sırasında sisteminiz kullanıcının yaşadığı bölgeyi belirleyebilir.

   Uygulama: Google'a verilen access_token bölge tanımlayıcısını kodlayın. Google bir karşılama isteği gönderdiğinde ağ geçidiniz, jetonu hemen inceleyebilir ve veritabanı araması yapmaya gerek kalmadan isteği doğru bölgesel kümeye yönlendirebilir.

Sistem Sağlığı - İş ortağı ile Google arasındaki metrikler

Başarı oranının >=%99,5 olması, cihaz durumlarının Google Home'da doğru olmasını, cihazların eklenip kaldırılmasını, otomasyonların tetiklenmesini ve geçmiş etkinliklerinin Google Home app (GHA)'nin Etkinlik sekmesinde görünmesini sağlar.

Başarı oranı, bulutunuz durum güncellemelerini gönderdiğinde Google tarafından döndürülen HTTP yanıt kodlarına göre hesaplanır. İş ortaklarının Google tarafındaki altyapı sorunları nedeniyle cezalandırılmaması için metrik, Google'ın dahili hatalarını başarısızlık sayısından çıkarır. Hesaplamaya dahil edilen API çağrıları HomeGraph API referansında yer alır.

"Başarı"yı ne tanımlar?

• 2xx (Başarılı): Durum güncellemesi, Home Graph tarafından başarıyla alındı ve işlendi.

"Başarısızlık" ne anlama gelir?

• 4xx (İş Ortağı Hatası): Bunlar Başarısızlıkları temsil eder ve bulutunuzdan gönderilen istekte bir sorun olduğunu gösterir. Yaygın kodlar şunlardır:
  • 400 Hatalı İstek: Sunucu, geçersiz söz dizimi nedeniyle isteği işleyemedi. Yaygın nedenler arasında hatalı biçimlendirilmiş JSON veya dize değeri için "" yerine null kullanılması yer alır.
  • 404 Bulunamadı: İstenen kaynak bulunamadı. Bu durum genellikle Google'ın istenen cihazı bulamadığı anlamına gelir. Bu, kullanıcı hesabının bağlı olmadığı veya geçersiz bir agentUserId alındığı anlamına da gelebilir. agentUserId değerinin SYNC yanıtınızda sağlanan değerle eşleştiğinden ve DISCONNECT amaçlarını düzgün şekilde işlediğinizden emin olun.
  • 429 Kaynak Tükendi: Entegrasyonunuz, ayrılan kotayı aştı. Kota yönetimi için kontrol panelinin üst kısmındaki "1. adım" bölümündeki talimatlara bakın.

Cihaz durumu - Durum doğruluğu

Durum Doğruluğu >=%99,5 ölçütünü karşılamak veya aşmak, kullanıcıların cihaz durumlarını görüntülerken ya da Home'a Sor gibi yapay zeka özelliklerini kullanırken doğru sonuçlar görmesini sağlar. Durum doğruluğu düşükse otomasyonlar tetiklenmeyebilir ve geçmiş girişleri GHA'nın Etkinlik sekmesinde doğru zamanda görünmeyebilir. Daha fazla bilgi için Rapor Durumu bölümünü inceleyin.

Kalite kontrol paneli, bu değeri saatlik olarak Genel Doğruluk ve En Düşük Tür/Özellik Kombinasyonu olmak üzere iki farklı metrik kullanarak izler.

1. Doğruluk Bileşenleri

Metrik, Google'ın bildirilen durumu bilinen bir amaç sonucuyla karşılaştırarak doğrulayabildiği "örneklerden" elde edilir.

2. Kontrol Paneli Metrikleri (Saatlik Hesaplama)

Kontrol paneli, doğruluğu 1 saatlik aralıklarla hesaplar. Bir saatte toplam örnek sayısı 100'den azsa (S_Total < 100), o saatin doğruluğu Yok olarak ayarlanır.

1. Görünüm: Genel Doğruluk (Genel Ortalama)

Bu metrik, tüm cihaz türleri ve özellikler birleştirildiğinde entegrasyonunuzun toplam doğruluğunu gösterir. Tüm ekosisteminizin sağlığıyla ilgili ağırlıklı bir ortalama sağlar.

• Hesaplama: Tüm cihazlardaki toplam durum doğruluğu / Tüm cihazlardaki toplam durum sayısı.

2. Görünüm: En Düşük Tür/Özellik Kombinasyonu

Bu, entegrasyonunuzdaki en güvenilmez belirli kategoriyi tanımlar. Bu özellik, yüksek kaliteli ve yüksek hacimli cihazların, düşük kaliteli ve düşük hacimli cihazları gizlemesini önler. Örneğin, %99, 5'in üzerinde Durum Doğruluğu olan yüksek hacimli ışıklarınız varsa ancak düşük Durum Doğruluğu olan düşük hacimli anahtarlarınız varsa bu durum, ortalama değerde kaybolabilecek anahtarlarda iyileştirme yapılması gerektiğini gösterir.

• Hesaplama: Tüm özellik / cihaz kombinasyonları için Eyalet Doğruluğu/Eyalet Toplamı'nın minimum değeri.