Serangkaian dasbor dan pemberitahuan ini membantu Anda mempertahankan integrasi berkualitas tinggi dengan ekosistem Google Home secara proaktif. Google berkomitmen untuk mendukung partner dalam mengembangkan ekosistem berkualitas tinggi bagi semua pelanggan
Dasbor ini memiliki tiga bagian, yang masing-masing mencakup bagian penting yang berkontribusi pada kualitas integrasi secara keseluruhan.
Metrik Google untuk Partner - Mengukur kondisi panggilan dari Google ke backend cloud Anda.
Kondisi Sistem - Metrik Partner untuk Google - Mengukur kondisi panggilan dari sistem Anda ke Google.
Kondisi Perangkat - Akurasi Status - Mengukur akurasi status yang disimpan dalam sistem Google, yang digunakan untuk menayangkan kueri pengguna.
Jika metrik tidak memenuhi nilai targetnya, metrik tersebut akan ditandai dengan warna merah untuk menunjukkan masalah yang dapat memengaruhi pengalaman pengguna. Informasi berikut memberikan detail tentang setiap target dan alasan target tersebut penting bagi pengguna Anda.
Jika tombol berikut tidak mengarahkan Anda langsung ke dasbor, Anda dapat mengaksesnya dengan memilih halaman Ringkasan , memilih Dasbor , lalu dari daftar Dasbor Saya , pilih Dasbor Vitalitas Google Home (Cloud) untuk melihat dasbor Anda.
Metrik Google untuk Partner
Metrik Rasio Keberhasilan Kueri/Eksekusi >= 99,5% mengukur frekuensi perintah pengguna dipenuhi dengan benar, yang membantu menghindari respons Asisten seperti "Saya tidak dapat menghubungi perangkat" atau mengonfirmasi perintah yang tidak dipenuhi dengan salah.
Apa yang menentukan "Keberhasilan"?
Transaksi ditandai sebagai berhasil jika platform Google Home menerima respons yang valid yang menunjukkan bahwa tindakan yang dimaksud telah dipenuhi atau status yang diminta telah diambil.
Respons yang menyertakan pengecualian non-pemblokiran (misalnya, status SUCCESS yang disertai dengan pengecualian lowBattery) dihitung sebagai transaksi yang berhasil.
Perintah berhasil mencapai perangkat dan intent terpenuhi meskipun ada peringatan.
Apa yang menentukan "Kegagalan"?
Error yang ditemukan di Kode error platform umum yang ditandai sebagai Tindakan Partner dianggap sebagai "Kegagalan" saat menghitung Rasio Keberhasilan QUERY dan EXECUTE. Selain itu, error yang ditemukan di Error dan pengecualian juga merupakan "Kegagalan", dengan pengecualian berikut:
| Pengecualian kegagalan | ||
|---|---|---|
| aboveMaximumLightEffectsDuration | armLevelNeeded | inOffMode |
| alreadyArmed | bagFull | lockedToRange |
| alreadyAtMax | belowMinimumLightEffectsDuration | lowBattery |
| alreadyAtMin | binFull | maxSpeedReached |
| alreadyClosed | cancelArmingRestricted | minSpeedReached |
| alreadyDisarmed | deadBattery | notSupported |
| alreadyDocked | degreesOutOfRange | offline |
| alreadyInState | deviceJammingDetected | percentOutOfRange |
| alreadyLocked | deviceNotMounted | rangeTooClose |
| alreadyOff | deviceNotReady | relinkRequired |
| alreadyOn | deviceOffline | remoteSetDisabled |
| alreadyOpen | deviceTurnedOff | safetyShutOff |
| alreadyPaused | discreteOnlyOpenClose | targetAlreadyReached |
| alreadyStarted | functionNotSupported | tooManyFailedAttempts |
| alreadyStopped | inAutoMode | valueOutOfRange |
| alreadyUnlocked | inEcoMode |
Metrik Latensi Kueri/Eksekusi (p90) <= 1000 md mengukur waktu tunggu tindakan yang diminta dan membantu memastikan pengguna tidak perlu menunggu terlalu lama, misalnya, menunggu beberapa detik agar lampu mereka mati.
Metrik latensi
Latensi adalah indikator penting tentang seberapa responsif integrasi Anda bagi pengguna akhir. Dasbor melacak Latensi Persentil ke-90 (P90), yang mewakili pengalaman pengguna "paling lambat" (misalnya, P90 sebesar 800 md berarti 90% permintaan diakui dalam waktu 800 md atau kurang).
Google mengukur latensi secara berbeda untuk pemeriksaan status dan perintah perangkat guna memastikan akurasi teknis.
1. Latensi QUERY (Interogatif)
Metrik ini mengukur waktu pulang pergi Cloud-to-cloud saat Google meminta status perangkat saat ini.
- Mulai: Google mengirimkan permintaan
action.devices.QUERYke URL pemenuhan Anda. - Jendela Pengukuran: Waktu yang dibutuhkan cloud Anda untuk menerima, memproses, dan mengirimkan kembali respons HTTP lengkap ke Google.
- Akhir: Google menerima dan mengakui payload respons akhir dari layanan Anda.
2. Latensi EXECUTE (Tindakan)
Metrik ini mengukur waktu pengakuan perintah saat Google mengirimkan permintaan kontrol ke perangkat.
- Mulai: Google mengirimkan permintaan
action.devices.EXECUTEke URL pemenuhan Anda. - Jendela Pengukuran: Waktu yang dibutuhkan cloud Anda untuk menerima perintah dan menampilkan respons pengakuan.
- Akhir: Google menerima respons status
SUCCESS,PENDING, atauOFFLINE. - Cakupan Teknis: Metrik ini mengukur waktu "Pengakuan Respons" antara cloud Google dan cloud Anda. Metrik ini tidak mengukur waktu yang dibutuhkan hardware fisik (misalnya, bola lampu) untuk menyelesaikan perubahan status fisik, karena sering kali melibatkan latensi jaringan mesh lokal di luar jalur cloud-to-cloud.
Opsi pengurangan latensi
Rekomendasi arsitektur untuk perutean geografis
Jika penerapan IP Anycast tidak memungkinkan, sebaiknya gunakan alternatif hemat biaya berikut untuk memastikan pengguna dilayani oleh pusat data regional terdekat.
Load Balancing Global (GLB)
Daripada perutean statis, gunakan Load Balancer Aplikasi Global (tersedia dari sebagian besar penyedia cloud utama).
Cara kerjanya: Anda mengonfigurasi satu titik entri global (URL) yang berada di tepi jaringan. Load balancer otomatis mendeteksi asal geografis permintaan dari cluster pemenuhan Google dan merutekan traffic ke backend responsif regional terdekat.
Manfaat: Hal ini memberikan performa Anycast dengan kompleksitas dan biaya konfigurasi yang jauh lebih rendah.
DNS yang Mendeteksi Lokasi Geografis (GeoDNS)
Cara kerjanya: Konfigurasi penyedia DNS Anda untuk me-resolve URL pemenuhan ke alamat IP yang berbeda berdasarkan lokasi geografis kueri DNS.
Penerapan: Pastikan penyedia DNS Anda dioptimalkan untuk titik keluar Google. Saat layanan pemenuhan regional Google (misalnya, di AS, Uni Eropa, atau Asia) me-resolve domain Anda, layanan tersebut akan menerima alamat IP untuk pusat data di wilayah tertentu.
Strategi pengoptimalan di lapisan aplikasi
Selain perutean tingkat infrastruktur, Anda dapat menerapkan strategi berikut di lapisan aplikasi untuk mengurangi latensi dalam pemrosesan permintaan.
Metode Proxy "Trampoline"
Jika Anda harus mempertahankan pusat data utama, gunakan server proxy ringan regional (Trampoline) untuk menangani handshake awal.
Google mengakses URL global Anda.
Proxy regional (misalnya, fungsi Nginx atau Lambda ringan) menerima permintaan.
Proxy meneruskan payload melalui backbone internal berkecepatan tinggi ke database utama.
Manfaat: Hal ini mengurangi waktu "TCP Handshake", yang sering kali menjadi kontributor terbesar latensi untuk permintaan jarak jauh.
Petunjuk Region Token Akses
Selama proses Penautan Akun (OAuth), sistem Anda dapat mengidentifikasi wilayah asal pengguna.
Penerapan: Enkode ID region ke dalam
access_tokenyang dikeluarkan ke Google. Saat Google mengirimkan permintaan pemenuhan, gateway Anda dapat langsung memeriksa token dan merutekan permintaan ke cluster regional yang benar tanpa memerlukan pencarian database.
Kondisi Sistem - Metrik Partner untuk Google
Mempertahankan Rasio Keberhasilan >= 99,5% membantu memastikan status perangkat benar di Google Home, perangkat ditambahkan dan dihapus, otomatisasi dipicu, dan peristiwa histori muncul di tab Aktivitas Google Home app (GHA).
Rasio Keberhasilan dihitung berdasarkan kode respons HTTP yang ditampilkan oleh Google saat cloud Anda mengirimkan update status. Untuk memastikan partner tidak dikenai sanksi atas masalah infrastruktur sisi Google, metrik ini mengecualikan error internal Google dari jumlah kegagalan. Panggilan API yang disertakan dalam perhitungan dapat ditemukan di referensi HomeGraph API.
Apa yang menentukan "Keberhasilan"?
- 2xx (Berhasil): Update status berhasil diterima dan diproses oleh Home Graph.
Apa yang menentukan "Kegagalan"?
- 4xx (Error Partner): Error ini mewakili Kegagalan dan menunjukkan masalah pada permintaan yang dikirim dari cloud Anda. Kode umum mencakup:
- 400 Bad Request: Server tidak dapat memproses permintaan karena sintaksis tidak valid. Penyebab umumnya mencakup JSON yang salah format atau menggunakan null, bukan "" untuk nilai string.
- 404 Not Found: Resource yang diminta tidak dapat ditemukan. Biasanya, hal ini berarti Google tidak dapat menemukan perangkat yang diminta. Hal ini juga dapat berarti akun pengguna tidak ditautkan atau
agentUserIdyang tidak valid diterima. PastikanagentUserIdcocok dengan nilai yang diberikan dalam respons SYNC Anda dan Anda menangani intentDISCONNECTdengan benar. - 429 Resource Exhausted: Integrasi Anda telah melampaui kuota yang dialokasikan. Lihat petunjuk di bagian "Langkah 1" di bagian atas dasbor untuk pengelolaan kuota.
Kondisi Perangkat - Akurasi status
Memenuhi atau melampaui Akurasi Status >= 99,5% membantu memastikan pengguna melihat hasil yang benar saat melihat status perangkat atau menggunakan fitur AI seperti Tanya Home. Jika akurasi status rendah, otomatisasi mungkin tidak akan berjalan dan entri histori mungkin tidak muncul di tab Aktivitas GHA's pada waktu yang tepat. Untuk mengetahui informasi selengkapnya, lihat Melaporkan Status.
Dasbor kualitas melacak hal ini setiap jam menggunakan dua metrik yang berbeda: Akurasi Keseluruhan dan Kombinasi Jenis/Fitur Terendah.
1. Komponen Akurasi
Metrik ini berasal dari "sampel" tempat Google dapat memverifikasi status yang dilaporkan terhadap hasil intent yang diketahui.
2. Metrik Dasbor (Perhitungan Per Jam)
Dasbor menghitung akurasi berdasarkan interval 1 jam. Jika satu jam memiliki total sampel kurang dari 100 (S_Total < 100), akurasi untuk jam tersebut akan ditetapkan ke N/A.
Tampilan 1: Akurasi Keseluruhan (Rata-Rata Global)
Metrik ini mewakili total akurasi integrasi Anda di semua jenis dan fitur perangkat yang digabungkan. Metrik ini memberikan rata-rata tertimbang dari kondisi seluruh ekosistem Anda.
- Perhitungan: Total Akurasi Status di semua perangkat / Total Status di semua perangkat.
Tampilan 2: Kombinasi Jenis/Fitur Terendah
Metrik ini mengidentifikasi kategori tertentu yang paling tidak dapat diandalkan dalam integrasi Anda. Metrik ini mencegah perangkat bervolume tinggi yang berkualitas tinggi menyembunyikan perangkat bervolume rendah yang berkualitas rendah. Misalnya, jika Anda memiliki lampu bervolume tinggi dengan Akurasi Status di atas 99,5%, tetapi volume Sakelar rendah dengan Akurasi Status rendah, hal ini akan menyoroti peningkatan yang diperlukan pada sakelar yang mungkin hilang dalam nilai rata-rata.
- Perhitungan: Minimum Akurasi Status / Total Status untuk semua kombinasi fitur/perangkat.