Google Cloud cung cấp cho bạn các công cụ để giám sát độ tin cậy của các dự án với Google Cloud Monitoring và khắc phục sự cố bằng Google Cloud Logging nhật ký lỗi. Bất cứ khi nào lỗi xảy ra khi thực hiện ý định của người dùng, Quy trình Google Home Analytics ghi lại lỗi trên các chỉ số của bạn, và xuất bản nhật ký lỗi trong nhật ký dự án.
Có hai bước để khắc phục sự cố:
- Theo dõi trạng thái dự án bằng các chỉ số của nhà thông minh.
- Điều tra vấn đề bằng cách kiểm tra nội dung mô tả chi tiết về lỗi trong nhật ký lỗi.
Lỗi giám sát
Bạn có thể sử dụng Google Cloud Monitoring dashboard để truy cập vào các chỉ số của dự án. Có một số biểu đồ chính đặc biệt hữu ích cho việc giám sát chất lượng và gỡ lỗi:
- Biểu đồ Tỷ lệ thành công là biểu đồ đầu tiên bắt đầu khi bạn theo dõi độ tin cậy của các dự án. Sự sụt giảm trong biểu đồ này có thể cho biết sự cố ngừng dịch vụ đối với một phần hoặc toàn bộ cơ sở người dùng của bạn. Bạn nên theo dõi chặt chẽ biểu đồ này để phát hiện mọi điều bất thường sau mỗi thay đổi hoặc cập nhật dự án.
- Biểu đồ Độ trễ ở phân vị thứ 95 là một chỉ báo quan trọng cho biết cách Hành động trong nhà thông minh đang mang lại hiệu quả cho người dùng. Dao động đột ngột Biểu đồ này có thể cho biết rằng hệ thống của bạn có thể không bắt kịp với các yêu cầu. Bạn nên định kỳ kiểm tra biểu đồ này để xem bất kỳ hành vi không mong muốn nào.
- Biểu đồ Bảng chi tiết lỗi hữu ích nhất khi nói đến giúp khắc phục các sự cố liên quan đến các công cụ tích hợp. Đối với mọi lỗi được đánh dấu trong biểu đồ tỷ lệ phần trăm thành công, một mã lỗi sẽ xuất hiện trong bảng phân tích lỗi. Bạn có thể thấy những lỗi bị gắn cờ bởi Google Home platform và cách khắc phục sự cố trong bảng dưới đây.
Mã lỗi nền tảng
Dưới đây là một số mã lỗi phổ biến mà bạn có thể thấy trong nhật ký dự án xác định các vấn đề mà Google Home platform phát hiện được. Vui lòng tham khảo bảng sau đây để biết thông tin khắc phục sự cố.
| Mã lỗi | Mô tả |
|---|---|
BACKEND_FAILURE_URL_ERROR |
Google đã nhận được mã lỗi HTTP 4xx không phải 401 từ
.
Sử dụng requestId trong phần Ghi nhật ký GCP để kiểm tra
nhật ký dịch vụ gia đình.
|
BACKEND_FAILURE_URL_TIMEOUT |
Đã hết thời gian chờ yêu cầu của Google khi cố gắng kết nối với dịch vụ của bạn.
Xác minh rằng dịch vụ của bạn đang trực tuyến, chấp nhận kết nối, và không vượt quá dung lượng. Ngoài ra, hãy xác minh rằng mục tiêu thiết bị đã bật, trực tuyến và đã đồng bộ hoá. |
BACKEND_FAILURE_URL_UNREACHABLE |
Google đã nhận được mã lỗi HTTP 5xx từ dịch vụ của bạn.
Sử dụng requestId trong phần Ghi nhật ký GCP để kiểm tra
nhật ký dịch vụ gia đình.
|
DEVICE_NOT_FOUND |
Thiết bị này không tồn tại ở phía dịch vụ đối tác.
Điều này thường cho thấy đã xảy ra lỗi trong quá trình đồng bộ hoá dữ liệu hoặc đang chạy đua . |
GAL_BAD_3P_RESPONSE |
Google không thể phân tích cú pháp phản hồi từ dịch vụ liên kết tài khoản của bạn
do định dạng hoặc giá trị không hợp lệ trong tải trọng.
Sử dụng requestId trong phần Ghi nhật ký GCP để kiểm tra nhật ký lỗi
trong dịch vụ liên kết tài khoản.
|
GAL_INTERNAL |
Đã xảy ra lỗi nội bộ của Google khi Google cố truy xuất
mã truy cập.
Nếu bạn thấy tỷ lệ lỗi này tăng lên trong phần Ghi nhật ký GCP, hãy liên hệ với để biết thêm thông tin. |
GAL_INVALID_ARGUMENT |
Đã xảy ra lỗi nội bộ của Google khi Google cố truy xuất
mã truy cập.
Nếu bạn thấy tỷ lệ lỗi này tăng lên trong phần Ghi nhật ký GCP, hãy liên hệ với để biết thêm thông tin. |
GAL_NOT_FOUND |
Mã truy cập và mã làm mới của người dùng được lưu trữ trong Google
không còn hợp lệ và không thể làm mới được nữa. Người dùng cần
liên kết lại tài khoản của họ để tiếp tục sử dụng dịch vụ của bạn.
Nếu bạn thấy tỷ lệ lỗi này tăng lên trong phần Ghi nhật ký GCP, hãy liên hệ với để biết thêm thông tin. |
GAL_PERMISSION_DENIED |
Đã xảy ra lỗi nội bộ của Google khi không chia sẻ mã thông báo
được uỷ quyền.
Nếu bạn thấy tỷ lệ lỗi này tăng lên trong phần Ghi nhật ký GCP, hãy liên hệ với để biết thêm thông tin. |
GAL_REFRESH_IN_PROGRESS |
Mã truy cập của người dùng đã hết hạn và một lần thử truy cập đồng thời khác để
quá trình làm mới đang được thực hiện.
Đây không phải là vấn đề và bạn không cần làm gì cả. |
INVALID_AUTH_TOKEN |
Google đã nhận được mã lỗi HTTP 401 từ dịch vụ của bạn.
Mã truy cập chưa hết hạn nhưng dịch vụ của bạn đã làm mã này hết hiệu lực. Sử dụng requestId trong phần Ghi nhật ký GCP để kiểm tra
nhật ký dịch vụ gia đình.
|
INVALID_JSON |
Không thể phân tích cú pháp hoặc hiểu được phản hồi JSON.
Kiểm tra cấu trúc của phản hồi JSON để tìm cú pháp không hợp lệ, chẳng hạn như như dấu ngoặc không khớp, thiếu dấu phẩy, ký tự không hợp lệ. |
OPEN_AUTH_FAILURE |
Mã truy cập của người dùng đã hết hạn và Google không thể làm mới mã đó.
hoặc Google đã nhận được mã lỗi HTTP 401 từ dịch vụ của bạn.
Nếu bạn thấy tỷ lệ tăng của mã này, hãy kiểm tra xem bạn cũng thấy tỷ lệ lỗi liên quan đến ý định hoặc quy trình làm mới nhà thông minh mã thông báo. |
PARTNER_RESPONSE_INVALID_ERROR_CODE |
Phản hồi cho biết mã lỗi không xác định.
Nếu nội dung phản hồi cho yêu cầu của bạn cho thấy có lỗi, hãy nhớ sử dụng một lỗi được cung cấp từ của chúng tôi các mã lỗi được hỗ trợ. |
PARTNER_RESPONSE_INVALID_PAYLOAD |
Không thể phân tích cú pháp trường phản hồi payload dưới dạng JSON
Đối tượng.
Kiểm tra xem trường tải trọng trong phản hồi yêu cầu của bạn có thông tin phù hợp hay không và có cấu trúc chính xác như một trường JSON. |
PARTNER_RESPONSE_INVALID_STATUS |
Phản hồi không chỉ ra trạng thái hoặc chỉ ra trạng thái không chính xác.
Phản hồi các yêu cầu thực hiện ý định phải cho biết trạng thái bằng một trong hai SUCCESS, OFFLINE, ERROR, EXCEPTIONS. Bạn
có thể tìm thêm thông tin trên
xử lý lỗi và ngoại lệ.
|
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES |
Một hoặc nhiều ý định có trong yêu cầu bị thiếu trên
của bạn.
Xác minh rằng phản hồi thực thi được cấu trúc chính xác và kết quả đối với tất cả ý định trong yêu cầu đều có trong phản hồi của bạn. |
PARTNER_RESPONSE_MISSING_DEVICE |
Thiếu một hoặc nhiều thiết bị có trong yêu cầu trên
của bạn.
Xác minh rằng phản hồi thực thi có cấu trúc chính xác và tất cả thiết bị có các mã nhận dạng trong yêu cầu trong phản hồi của bạn. |
PARTNER_RESPONSE_MISSING_PAYLOAD |
Phản hồi không chứa trường payload.
Hãy nhớ đưa trường tải trọng vào phản hồi yêu cầu của bạn. Bạn có thể tìm hiểu thêm về cách tạo một phản hồi thực thi. |
PARTNER_RESPONSE_NOT_OBJECT |
Không thể phân tích cú pháp phản hồi dưới dạng Đối tượng JSON.
Kiểm tra tất cả các trường trong phản hồi yêu cầu của bạn để tìm các ký tự không mong muốn, dấu ngoặc không khớp hoặc lỗi định dạng. Một số ký tự unicode có thể không được hỗ trợ. Đồng thời, hãy đảm bảo rằng câu trả lời của bạn là chính xác có cấu trúc dưới dạng đối tượng JSON. |
PROTOCOL_ERROR |
Không xử lý được yêu cầu.
Sử dụng requestId trong Google Cloud Logging để kiểm tra
nhật ký dịch vụ nhà thông minh.
|
RESPONSE_TIMEOUT |
Đã hết thời gian chờ phản hồi yêu cầu.
Thời gian chờ để gửi phản hồi là 9 giây kể từ khi thì yêu cầu sẽ được gửi đi. Hãy đảm bảo bạn gửi câu trả lời trong khoảng thời gian này thời gian. |
RESPONSE_UNAVAILABLE |
Không nhận được phản hồi nào hoặc phản hồi không cho biết trạng thái.
Bạn nên cấu trúc các phản hồi cho các yêu cầu thực hiện ý định theo tài liệu nhà thông minh và cho biết trạng thái. |
TRANSIENT_ERROR |
Lỗi tạm thời là lỗi sẽ tự khắc phục.
Thông thường, các lỗi này xuất hiện dưới dạng kết nối với thiết bị hoặc dịch vụ bị ngắt. Ngoài ra, nếu không thể kết nối mới với máy chủ đã mở. |
Nhật ký Tìm kiếm
Khi bạn có thể thoải mái theo dõi các tích hợp của mình bằng cách sử dụng chỉ số, bước là khắc phục các lỗi cụ thể bằng cách sử dụng Cloud Logging. Nhật ký lỗi là một mục giống JSON với các trường chứa thông tin hữu ích như thời gian, lỗi mã và thông tin chi tiết liên quan đến ý định ban đầu của nhà thông minh.
Có nhiều hệ thống trong Google Cloud gửi nhật ký đến dự án của bạn mọi lúc. Bạn cần viết truy vấn để lọc nhật ký và tìm những bản nhạc bạn cần. Truy vấn có thể dựa trên Phạm vi thời gian, Tài nguyên, Mức độ nghiêm trọng nhật ký hoặc mục nhập tuỳ chỉnh.
Bạn có thể sử dụng các nút truy vấn để giúp tạo bộ lọc tuỳ chỉnh.
Để chỉ định Phạm vi thời gian, hãy nhấp vào nút chọn phạm vi thời gian rồi chọn một trong các lựa chọn được cung cấp . Thao tác này sẽ lọc nhật ký và hiển thị những nhật ký bắt nguồn từ khoảng thời gian đã chọn.
Để chỉ định Resource (Tài nguyên), hãy nhấp vào trình đơn thả xuống Resource (Tài nguyên). rồi chọn Google Assistant Action Project (Dự án hành động của Trợ lý Google). Thao tác này sẽ thêm một bộ lọc trong truy vấn của mình để hiển thị nhật ký bắt nguồn từ dự án của bạn.
Sử dụng nút Mức độ nghiêm trọng để lọc theo Khẩn cấp, Thông tin, Gỡ lỗi, và các mức độ nghiêm trọng khác trong nhật ký về mức độ nghiêm trọng.
Bạn cũng có thể sử dụng trường Truy vấn trong Logs Explorer
để nhập các mục tuỳ chỉnh. Công cụ truy vấn mà trường này sử dụng hỗ trợ cả
các truy vấn cơ bản như so khớp chuỗi và các loại truy vấn nâng cao hơn bao gồm
phép so sánh (<, >=, !=) và toán tử boolean (AND, OR, NOT).
Ví dụ: mục nhập tuỳ chỉnh bên dưới sẽ trả về các lỗi
bắt nguồn từ một loại thiết bị LIGHT:
resource.type = "assistant_action_project" AND severity = ERROR AND jsonPayload.executionLog.executionResults.actionResults.device.deviceType = "LIGHT"
Truy cập Thư viện truy vấn để tìm thêm ví dụ về việc truy vấn nhật ký một cách hiệu quả.
Kiểm thử bản sửa lỗi
Khi xác định được lỗi và áp dụng bản cập nhật để khắc phục lỗi, bạn nên kiểm tra khắc phục triệt để bằng Google Home Test Suite. Chúng tôi cung cấp hướng dẫn sử dụng về cách sử dụng Test Suite. Công cụ này sẽ hướng dẫn bạn cách kiểm thử thay đổi một cách hiệu quả.
Tài nguyên học tập
Tài liệu này trình bày các bước khắc phục lỗi trong Nhà thông minh Hành động. Bạn cũng có thể tham khảo các lớp học lập trình của chúng tôi để tìm hiểu thêm về cách gỡ lỗi:
- Gỡ lỗi lớp học lập trình về nhà thông minh: Hướng dẫn bắt đầu nhanh gỡ lỗi tích hợp nhà thông minh trên đám mây.
- Gỡ lỗi lớp học lập trình trên Local Home: Hướng dẫn bắt đầu nhanh gỡ lỗi tích hợp cục bộ trong nhà thông minh.