Bộ trang tổng quan và cảnh báo này giúp bạn chủ động duy trì khả năng tích hợp chất lượng cao với hệ sinh thái Google Home. Google cam kết hỗ trợ các đối tác phát triển một hệ sinh thái chất lượng cao cho tất cả khách hàng
Trang tổng quan có 3 phần, mỗi phần bao gồm một phần chính góp phần vào chất lượng của quá trình tích hợp tổng thể.
Chỉ số từ Google đến Đối tác – Đo lường tình trạng của các lệnh gọi từ Google đến phần phụ trợ trên đám mây của bạn.
Tình trạng hệ thống – Chỉ số từ Đối tác đến Google – Đo lường tình trạng của các lệnh gọi từ hệ thống của bạn đến Google.
Tình trạng thiết bị – Độ chính xác của trạng thái – Đo lường độ chính xác của các trạng thái được lưu trữ trong hệ thống của Google, được dùng để phục vụ các truy vấn của người dùng.
Khi các chỉ số không đạt giá trị mục tiêu, chúng sẽ được đánh dấu màu đỏ để cho biết vấn đề có thể ảnh hưởng đến trải nghiệm người dùng. Thông tin sau đây cung cấp thông tin chi tiết về từng mục tiêu và lý do mục tiêu đó quan trọng đối với người dùng.
Chỉ số từ Google đến Đối tác
Chỉ số Tỷ lệ thành công của truy vấn/thực thi >= 99,5% đo lường tần suất các lệnh của người dùng được thực hiện chính xác, giúp tránh các phản hồi của Trợ lý như "Tôi không thể kết nối với thiết bị" hoặc xác nhận không chính xác một lệnh chưa được thực hiện.
Điều gì xác định một "Thành công"?
Một giao dịch được đánh dấu là thành công nếu nền tảng Google Home nhận được một phản hồi hợp lệ cho biết hành động dự định đã được thực hiện hoặc trạng thái được yêu cầu đã được truy xuất.
Các phản hồi bao gồm các ngoại lệ không chặn (ví dụ: trạng thái SUCCESS đi kèm với ngoại lệ lowBattery) được tính là giao dịch thành công.
Lệnh đã đến thiết bị và ý định đã được đáp ứng bất chấp cảnh báo.
Điều gì xác định một "Thất bại"?
Các lỗi được tìm thấy trên Mã lỗi nền tảng phổ biến được đánh dấu là Đối tác có thể thực hiện được coi là "Thất bại" khi tính toán Tỷ lệ thành công của truy vấn và thực thi.
Chỉ số Độ trễ truy vấn/thực thi (p90) <= 1000 ms đo lường thời gian chờ hành động được yêu cầu và giúp đảm bảo người dùng không phải chờ quá lâu, ví dụ: chờ vài giây để đèn tắt.
Chỉ số độ trễ
Độ trễ là một chỉ báo quan trọng về mức độ phản hồi của quá trình tích hợp đối với người dùng cuối. Trang tổng quan theo dõi Độ trễ ở phân vị thứ 90 (P90), thể hiện trải nghiệm của những người dùng "chậm nhất" (ví dụ: P90 là 800 ms có nghĩa là 90% yêu cầu được xác nhận trong vòng 800 ms trở xuống).
Google đo lường độ trễ theo cách khác nhau đối với các lệnh kiểm tra trạng thái so với các lệnh thiết bị để đảm bảo độ chính xác về kỹ thuật.
1. Độ trễ truy vấn (Hỏi)
Chỉ số này đo lường thời gian khứ hồi Cloud-to-cloud khi Google yêu cầu trạng thái hiện tại của một thiết bị.
- Bắt đầu: Google gửi yêu cầu
action.devices.QUERYđến URL thực hiện của bạn. - Cửa sổ đo lường: Thời gian để đám mây của bạn nhận, xử lý và truyền toàn bộ phản hồi HTTP trở lại Google.
- Kết thúc: Google nhận và xác nhận gói dữ liệu phản hồi cuối cùng từ dịch vụ của bạn.
2. Độ trễ thực thi (Hành động)
Chỉ số này đo lường thời gian xác nhận lệnh khi Google gửi yêu cầu kiểm soát đến một thiết bị.
- Bắt đầu: Google gửi yêu cầu
action.devices.EXECUTEđến URL thực hiện của bạn. - Cửa sổ đo lường: Thời gian để đám mây của bạn nhận lệnh và trả về phản hồi xác nhận.
- Kết thúc: Google nhận được phản hồi trạng thái
SUCCESS,PENDINGhoặcOFFLINE. - Phạm vi kỹ thuật: Chỉ số này đo lường thời gian "Xác nhận phản hồi" giữa đám mây của Google và đám mây của bạn. Chỉ số này không đo lường thời gian để phần cứng thực (ví dụ: bóng đèn) hoàn tất việc thay đổi trạng thái thực, vì điều đó thường liên quan đến độ trễ của mạng lưới cục bộ bên ngoài đường dẫn từ đám mây đến đám mây.
Tình trạng hệ thống – Chỉ số từ Đối tác đến Google
Duy trì Tỷ lệ thành công >= 99,5% giúp đảm bảo rằng trạng thái thiết bị chính xác trong Google Home, thiết bị được thêm và xoá, quá trình tự động hoá kích hoạt, và các sự kiện trong nhật ký xuất hiện trong thẻ Hoạt động của Google Home app (GHA).
Tỷ lệ thành công được tính dựa trên mã phản hồi HTTP do Google trả về khi đám mây của bạn đẩy các bản cập nhật trạng thái. Để đảm bảo đối tác không bị phạt do các vấn đề về cơ sở hạ tầng phía Google, chỉ số này sẽ loại trừ các lỗi nội bộ của Google khỏi số lượng lỗi. Bạn có thể tìm thấy các lệnh gọi API có trong phép tính trong tài liệu tham khảo HomeGraph API.
Điều gì xác định một "Thành công"?
- 2xx (Thành công): Home Graph đã nhận và xử lý thành công bản cập nhật trạng thái.
Điều gì xác định một "Thất bại"?
- 4xx (Lỗi của đối tác): Các lỗi này thể hiện Thất bại và cho biết có vấn đề với yêu cầu được gửi từ đám mây của bạn. Các mã phổ biến bao gồm:
- 400 Yêu cầu không hợp lệ: Máy chủ không thể xử lý yêu cầu do cú pháp không hợp lệ. Các nguyên nhân phổ biến bao gồm JSON không hợp lệ hoặc sử dụng giá trị rỗng thay vì "" cho giá trị chuỗi.
- 404 Không tìm thấy: Không tìm thấy tài nguyên được yêu cầu. Thông thường, điều này
có nghĩa là Google không tìm thấy thiết bị được yêu cầu. Điều này cũng có thể có nghĩa là tài khoản người dùng
không được liên kết hoặc đã nhận được
agentUserIdkhông hợp lệ. Đảm bảoagentUserIdkhớp với giá trị được cung cấp trong phản hồi SYNC và rằng bạn đang xử lý đúng cáchDISCONNECTý định. - 429 Đã sử dụng hết tài nguyên: Quá trình tích hợp của bạn đã vượt quá hạn mức được phân bổ. Hãy xem hướng dẫn trong phần "Bước 1" ở phía trên trang tổng quan để biết cách quản lý hạn mức.
Tình trạng thiết bị – Độ chính xác của trạng thái
Đạt hoặc vượt quá Độ chính xác của trạng thái >= 99,5% giúp đảm bảo người dùng thấy kết quả chính xác khi xem trạng thái thiết bị hoặc sử dụng các tính năng AI như Hỏi Home. Nếu độ chính xác của trạng thái thấp, quá trình tự động hoá có thể không kích hoạt và các mục trong nhật ký có thể không xuất hiện trong thẻ Hoạt động của GHA vào đúng thời điểm. Để biết thêm thông tin, hãy xem Báo cáo trạng thái.
Trang tổng quan về chất lượng theo dõi chỉ số này hằng giờ bằng cách sử dụng 2 chỉ số riêng biệt: Độ chính xác tổng thể và Tổ hợp loại/đặc điểm thấp nhất.
1. Thành phần độ chính xác
Chỉ số này được lấy từ "mẫu" mà Google có thể xác minh trạng thái được báo cáo dựa trên kết quả ý định đã biết.
2. Chỉ số trang tổng quan (Tính toán hằng giờ)
Trang tổng quan tính toán độ chính xác dựa trên khoảng thời gian 1 giờ. Nếu một giờ có ít hơn 100 mẫu (S_Total < 100), thì độ chính xác cho giờ đó được đặt thành N/A.
Chế độ xem 1: Độ chính xác tổng thể (Mức trung bình toàn cầu)
Chỉ số này thể hiện tổng độ chính xác của quá trình tích hợp trên tất cả các loại thiết bị và đặc điểm kết hợp. Chỉ số này cung cấp mức trung bình có trọng số về tình trạng của toàn bộ hệ sinh thái.
- Tính toán: Tổng độ chính xác của trạng thái trên tất cả các thiết bị / Tổng số trạng thái trên tất cả các thiết bị.
Chế độ xem 2: Tổ hợp loại/đặc điểm thấp nhất
Chỉ số này xác định danh mục cụ thể không đáng tin cậy nhất trong quá trình tích hợp. Chỉ số này ngăn các thiết bị có số lượng lớn và chất lượng cao ẩn các thiết bị có số lượng thấp và chất lượng thấp. Ví dụ: nếu bạn có số lượng lớn đèn có Độ chính xác của trạng thái trên 99, 5%, nhưng số lượng Công tắc thấp với Độ chính xác của trạng thái thấp, thì chỉ số này sẽ làm nổi bật sự cải thiện cần thiết đối với các công tắc có thể bị mất trong giá trị trung bình.
- Tính toán: Mức tối thiểu của Độ chính xác của trạng thái / Tổng số trạng thái cho tất cả các tổ hợp đặc điểm/thiết bị.