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 kluczową część wpływającą na jakość ogólnej integracji.
Dane Google dotyczące partnera – mierzy stan połączeń z Google do Twojego zaplecza w chmurze.
Stan systemu – dane partnera w porównaniu z danymi Google – mierzy stan połączeń z Twojego systemu do Google.
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żytkowników. Poniższe informacje zawierają szczegóły dotyczące każdego celu i wyjaśnienie, dlaczego jest on ważny dla użytkowników.
Dane od Google do partnera
Wskaźnik Odsetek udanych zapytań/wykonań ≥ 99,5% mierzy, jak często polecenia użytkowników są wykonywane prawidłowo.Pomaga to 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 i zostało wykonane 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 partnera, są uznawane za „Niepowodzenia” podczas obliczania wskaźników powodzenia ZAPYTANIA i WYKONANIA.
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 końcowego. 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 w obie strony, gdy Google prosi o aktualny stan urządzenia.
- 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 ostateczny ładunek odpowiedzi 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,PENDINGlubOFFLINE. - 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 typu 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 zdarzenia historyczne 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.
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. Częstymi przyczynami są 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ę, żeagentUserIdjest zgodne z wartością podaną w odpowiedzi SYNC i że prawidłowo obsługujesz intencjeDISCONNECT. - 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 podczas sprawdzania stanów urządzeń lub korzystania z funkcji opartych na AI, takich jak Pytanie do 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 pochodzą z „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 nie dotyczy.
Widok 1. Ogólna dokładność (średnia globalna)
Jest to łączna dokładność integracji na wszystkich typach urządzeń i w przypadku wszystkich cech. Zawiera on ważoną średnią 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 urządzeń o niskiej jakości przez urządzenia o wysokiej jakości, które generują duży ruch. 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 działania przełączników, co może być niewidoczne w wartości średniej.
- Obliczenia: minimum z wartości State Accuracy / State Total dla wszystkich kombinacji cech i urządzeń.