Google Home Vitals (Cloud)

Ten zestaw paneli i alertów pomaga aktywnie utrzymywać wysoką jakość integracji z ekosystemem Google Home. Google dokłada wszelkich starań, aby wspierać partnerów w tworzeniu ekosystemu wysokiej jakości dla wszystkich klientów

Panel ma 3 sekcje, z których każda obejmuje kluczowy element wpływający na jakość ogólnej integracji.

1. Dane od Google do partnera – mierzy stan połączeń z Google do Twojego zaplecza w chmurze.

2. Stan systemu – dane partnera dla Google – mierzy stan połączeń z Twojego systemu do Google.

3. Stan urządzenia – dokładność stanu – mierzy dokładność stanów przechowywanych w systemach Google, które są używane do obsługi zapytań użytkowników.

Gdy dane nie osiągają wartości docelowych, są wyróżniane na czerwono, aby wskazać problem, który może mieć wpływ na wrażenia użytkownika. Poniższe informacje zawierają szczegóły dotyczące każdego celu i wyjaśnienie, dlaczego jest on ważny dla użytkowników.

Otwórz Panel

Dane od Google do partnera

Dane Query/Execute Success Rate >= 99.5% mierzą, jak często polecenia użytkowników są wykonywane prawidłowo, co pomaga uniknąć odpowiedzi Asystenta, takich jak „Nie mogę się połączyć z urządzeniem”, lub nieprawidłowego potwierdzania polecenia, które nie zostało wykonane.

Co oznacza „Sukces”?

Transakcja jest oznaczana jako zakończona, jeśli platforma Google Home otrzyma prawidłową odpowiedź wskazującą, że zamierzone działanie zostało wykonane lub żądany stan został pobrany.

Odpowiedzi, które zawierają wyjątki nieblokujące (np. stan SUCCESS z wyjątkiem lowBattery), są liczone jako udane transakcje. Polecenie dotarło do urządzenia, a intencja została zrealizowana pomimo ostrzeżenia.

Co oznacza „niepowodzenie”?

Błędy znalezione w sekcji Typowe kody błędów platformy, które są oznaczone jako Wymagające działania ze strony partnera, są uznawane za „Niepowodzenia” podczas obliczania odsetka udanych zapytań i wykonań.

Wskaźnik Opóźnienie zapytania/wykonania (p90) <= 1000 ms mierzy czas oczekiwania na żądane działanie i pomaga zapewnić, że użytkownicy nie będą musieli zbyt długo czekać, np. kilka sekund na wyłączenie światła.

Dane o czasie oczekiwania

Opóźnienie to kluczowy wskaźnik tego, jak szybko integracja reaguje na działania użytkownika. Panel śledzi opóźnienie na 90 percentylu (P90), które odzwierciedla wrażenia „najwolniejszych” użytkowników (np. P90 na poziomie 800 ms oznacza, że 90% żądań jest potwierdzanych w ciągu 800 ms lub krótszym).

Google mierzy opóźnienie w przypadku sprawdzania stanu i poleceń urządzenia w inny sposób, aby zapewnić dokładność techniczną.

1. Czas oczekiwania na odpowiedź na zapytanie (interrogative)

Mierzy czas Cloud-to-cloud, jaki upływa od momentu, gdy Google poprosi o bieżący stan urządzenia, do momentu, gdy go otrzyma.

• Początek: Google wysyła action.devices.QUERY żądanie na adres URL realizacji.
• Okres pomiaru: czas, jaki zajmuje Twojej chmurze otrzymanie, przetworzenie i przesłanie pełnej odpowiedzi HTTP z powrotem do Google.
• Koniec: Google otrzymuje i potwierdza ostateczną odpowiedź z Twojej usługi.

2. Opóźnienie EXECUTE (działanie)

Mierzy czas potwierdzenia polecenia, gdy Google wysyła do urządzenia żądanie sterowania.

• Początek: Google wysyła action.devices.EXECUTE żądanie na adres URL realizacji.
• Okres pomiaru: czas potrzebny na odebranie polecenia przez chmurę i odesłanie odpowiedzi z potwierdzeniem.
• Zakończenie: Google otrzymuje odpowiedź ze stanem SUCCESS, PENDING lub OFFLINE.
• Zakres techniczny: ten wskaźnik mierzy czas „potwierdzenia odpowiedzi” między chmurą Google a Twoją chmurą. Nie mierzy czasu potrzebnego na zmianę stanu fizycznego urządzenia (np. żarówki), ponieważ często wiąże się to z opóźnieniem w lokalnej sieci mesh, które nie jest związane ze ścieżką chmura-chmura.

Stan systemu – dane od partnera do Google

Utrzymywanie odsetka sukcesów na poziomie co najmniej 99,5% pomaga zapewnić, że stany urządzeń w Google Home są prawidłowe, urządzenia są dodawane i usuwane, automatyzacje są wywoływane, a wydarzenia z historii pojawiają się na karcie Aktywność w Google Home app (GHA).

Współczynnik powodzenia jest obliczany na podstawie kodów odpowiedzi HTTP zwracanych przez Google, gdy Twoja chmura wysyła aktualizacje stanu. Aby mieć pewność, że partnerzy nie będą karani za problemy z infrastrukturą po stronie Google, w liczbie błędów nie uwzględniamy błędów wewnętrznych Google. Wywołania interfejsu API uwzględnione w obliczeniach znajdziesz w dokumentacji interfejsu HomeGraph API.

Co oznacza „Sukces”?

• 2xx (Sukces): aktualizacja stanu została odebrana i przetworzona przez Home Graph.

Co oznacza „niepowodzenie”?

• 4xx (błąd partnera): te błędy oznaczają niepowodzenia i wskazują na problem z żądaniem wysłanym z Twojej chmury. Typowe kody to:
  • 400 Nieprawidłowe żądanie: serwer nie mógł przetworzyć żądania z powodu nieprawidłowej składni. Najczęstsze przyczyny to nieprawidłowy format JSON lub użycie wartości null zamiast „” w przypadku wartości ciągu znaków.
  • 404 – nie znaleziono: nie udało się znaleźć żądanego zasobu. Zwykle oznacza to, że Google nie może znaleźć urządzenia, które wysłało żądanie. Może to też oznaczać, że konto użytkownika nie jest połączone lub otrzymano nieprawidłowy agentUserId. Upewnij się, że agentUserId jest zgodne z wartością podaną w odpowiedzi SYNC i że prawidłowo obsługujesz intencje DISCONNECT.
  • 429 Wyczerpanie zasobów: Twoja integracja przekroczyła przydzielony limit. Instrukcje zarządzania limitami znajdziesz w sekcji „Krok 1” w górnej części panelu.

Stan urządzenia – dokładność stanu

Spełnienie lub przekroczenie dokładności stanu >= 99,5% pomaga zapewnić użytkownikom wyświetlanie prawidłowych wyników, gdy sprawdzają stany urządzeń lub korzystają z funkcji AI, takich jak Zapytaj Home. Jeśli dokładność stanu jest niska, automatyzacje mogą się nie uruchamiać, a wpisy w historii mogą się nie pojawiać we właściwym czasie na karcie Aktywność GHA. Więcej informacji znajdziesz w artykule Stan raportu.

Panel jakości śledzi te dane co godzinę za pomocą 2 rodzajów danych: Ogólna dokładność i Najniższa kombinacja typu/cechy.

1. Komponenty dokładności

Dane są uzyskiwane na podstawie „próbek”, w przypadku których Google może zweryfikować zgłoszony stan na podstawie znanego wyniku intencji.

2. Dane w panelu (obliczane co godzinę)

Panel oblicza dokładność na podstawie godzinnego przedziału czasu. Jeśli w ciągu godziny liczba wszystkich próbek (S_Total) jest mniejsza niż 100, dokładność w tym okresie jest ustawiana na N/A.

Widok 1. Ogólna dokładność (średnia globalna)

Jest to łączna dokładność integracji na wszystkich typach urządzeń i w przypadku wszystkich cech. Jest to średnia ważona kondycji całego ekosystemu.

• Obliczenia: łączna dokładność stanu na wszystkich urządzeniach / łączna liczba stanów na wszystkich urządzeniach.

Widok 2. Najniższa kombinacja typu/cechy

Wskazuje to najbardziej zawodną kategorię w integracji. Zapobiega to ukrywaniu przez urządzenia o dużej liczbie wyświetleń i wysokiej jakości urządzeń o małej liczbie wyświetleń i niskiej jakości. Jeśli na przykład masz dużą liczbę świateł o dokładności stanu powyżej 99,5%, ale małą liczbę przełączników o niskiej dokładności stanu, wskazuje to na konieczność poprawy w przypadku przełączników, co może zostać pominięte w wartości średniej.

• Obliczenia: minimum z wartości State Accuracy / State Total dla wszystkich kombinacji cech i urządzeń.