Bộ trang tổng quan và cảnh báo này giúp bạn chủ động duy trì một hoạt độ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 trong việ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 đề cập đến 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 trạng thái của các lệnh gọi từ Google đến phần phụ trợ đám mây của bạn.
Tình trạng hệ thống – Chỉ số về mối quan hệ đối tác giữa bạn và 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ân phát các truy vấn của người dùng.
Khi các chỉ số không đạt được giá trị mục tiêu, chúng sẽ được đánh dấu bằng màu đỏ để cho biết có 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 câu trả lờ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ì định nghĩa 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ự kiến đã được thực hiện hoặc trạng thái được yêu cầu đã được truy xuất.
Những phản hồi bao gồm các trường hợp ngoại lệ không chặn (ví dụ: trạng thái SUCCESS đi kèm với trường hợp ngoại lệ lowBattery) được tính là giao dịch thành công.
Lệnh đã đến được thiết bị và ý định đã được đáp ứng mặc dù có cảnh báo.
Điều gì định nghĩa một "Lỗi"?
Những lỗi được tìm thấy trên Mã lỗi thường gặp của nền tảng được đánh dấu là Đối tác có thể thực hiện hành động được coi là "Lỗi" khi tính Tỷ lệ thành công của QUERY và EXECUTE.
Chỉ số Độ trễ truy vấn/thực thi (p90) <= 1000 mili giây đo lường thời gian chờ của 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ố về độ trễ
Độ trễ là một chỉ báo quan trọng cho biết mức độ phản hồi của hoạt động 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 mili giây có nghĩa là 90% yêu cầu được xác nhận trong vòng 800 mili giây hoặc ít hơn).
Google đo độ 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ễ của truy vấn (Nghi vấn)
Chỉ số này đo 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 một yêu cầu
action.devices.QUERYđến URL thực hiện của bạn. - Khoảng thời gian đo lường: Thời gian cần thiết để đá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 tải trọng phản hồi cuối cùng từ dịch vụ của bạn.
2. Độ trễ EXECUTE (Hành động)
Chỉ số này đo thời gian phản hồi lệnh khi Google gửi yêu cầu điều khiển đến một thiết bị.
- Bắt đầu: Google gửi một yêu cầu
action.devices.EXECUTEđến URL thực hiện của bạn. - Khoảng thời gian đo: Khoảng thời gian cần thiết để đám mây của bạn nhận được lệnh và trả về một 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 "Phản hồi Ack" 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 cần thiết để phần cứng thực (ví dụ: bóng đèn) hoàn tất quá trình thay đổi trạng thái thực, vì quá trình này 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ố đối tác với Google
Duy trì Tỷ lệ thành công >= 99, 5% giúp đảm bảo trạng thái thiết bị chính xác trong Google Home, các thiết bị được thêm và xoá, các hoạt động tự động hoá được 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 mà Google trả về khi đám mây của bạn gửi các bản cập nhật trạng thái. Để đảm bảo đối tác không bị phạt vì 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.
Điều gì định nghĩa một "Thành công"?
- 2xx (Thành công): Home Graph đã nhận và xử lý thành công nội dung cập nhật trạng thái.
Điều gì định nghĩa một "Lỗi"?
- 4xx (Lỗi của đối tác): Những lỗi này đại diện cho các lỗ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. Sau đây là một số mã phổ biến:
- 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 thường gặp bao gồm JSON bị lỗi 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 chưa đượ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à bạn đang xử lý đúng cách các ý địnhDISCONNECT. - 429 Resource Exhausted (Hết tài nguyên): Mức sử dụng của chế độ tích hợp đã 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 trong trang tổng quan để quản lý hạn mức.
Tình trạng thiết bị – Độ chính xác của trạng thái
Việc đáp ứng 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, các hoạt động tự động 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 phần Báo cáo trạng thái.
Trang tổng quan về chất lượng theo dõi chỉ số này theo 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ả dự kiến đã biết.
2. Chỉ số trên trang tổng quan (Tính toán theo 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ổng số mẫu ít hơn 100 (S_Total < 100), thì độ chính xác cho giờ đó được đặt thành Không áp dụng.
Chế độ xem 1: Độ chính xác tổng thể (Trung bình toàn cầu)
Đây là độ chính xác tổng thể 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 giá trị trung bình có trọng số về tình trạng của toàn bộ hệ sinh thái.
- Cách tính: Tổng số trạng thái chính xác 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 kiểu/đặc điểm thấp nhất
Điều 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. Điều này ngăn các thiết bị có số lượng lớn và chất lượng cao che giấu các thiết bị có số lượng ít và chất lượng thấp. Ví dụ: nếu bạn có số lượng đèn lớn với Độ chính xác về 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 về trạng thái thấp, thì điều này cho thấy cần cải thiện công tắc có thể bị mất trong giá trị trung bình.
- Cách tính: Giá trị tối thiểu của Độ chính xác theo 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ị.