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 kısmı kapsar.
Google'dan İş Ortağı Metrikleri: Google'dan bulut arka ucunuza yapılan çağrıların durumunu ölçer.
Sistem Sağlığı - İş Ortağından Google'a Yönelik Metrikler: Sisteminizden Google'a yapılan çağrıların sağlığını ölçer.
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ı renkte vurgulanır. Aşağıdaki bilgilerde her hedef ve kullanıcılarınız için neden önemli olduğu hakkında ayrıntılar verilmektedir.
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 İşlem Yapılabilir 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 yeterlidir.
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, 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.QUERYisteğ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 bir
action.devices.EXECUTEisteği gönderir. - Ölçüm Penceresi: Bulutunuzun komutu alıp onay yanıtı göndermesi için geçen süre.
- Bitiş: Google,
SUCCESS,PENDINGveyaOFFLINEdurum 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. Bunun nedeni, bu işlemin genellikle buluttan buluta yolun dışında yerel bağlantılı ağ gecikmesini içermesidir.
Sistem Sağlığı - İş ortağından Google'a 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.
"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, hataları 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ı Hatası: İ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
agentUserIdalındığı anlamına da gelebilir.agentUserIddeğerinin SYNC yanıtınızda sağlanan değerle eşleştiğinden veDISCONNECTamaç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 (Global 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ı 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ı minimum değeri.