Google Cloud projelerinizin güvenilirliğini izlemeniz için gerekli araçları sunar Google Cloud Monitoring ile birlikte sorun ve Google Cloud Logging ile ilgili hataları ayıklayın hata günlüklerine ekleyebilirsiniz. Kullanıcının amaçları gerçekleştirilirken bir hata oluştuğunda Google Home Analytics ardışık düzeni, metriklerinizde hata olduğunu kaydeder ve proje günlüklerinizde bir hata günlüğü yayınlar.
Hatalarınızı gidermek için izlenecek iki adım vardır:
- Akıllı ev metrikleriyle projelerinizin durumunu izleyin.
- Şu sayfadaki ayrıntılı hata açıklamalarını kontrol ederek sorunları araştırın: hata günlüklerine ekleyebilirsiniz.
İzleme hataları
Google Cloud Monitoring dashboard kullanabilirsiniz ve proje metriklerinize erişebilirsiniz. Elektronik tablo kullanmanıza rağmen Kaliteyi izlemek ve hata ayıklamak için kullanışlıdır:
- Başarı Oranı grafiği, hedefe ulaştığınızda yardımcı olur. Bu grafikteki düşüşler kullanıcı tabanınızın bir kısmı veya tamamı için bir kesinti olduğunun göstergesi olabilir. Önerilerimiz: her değişiklikten sonra düzensizlikler olup olmadığını görmek için bu grafiği yakından izleme veya güncellemeniz gerekir.
- 95. Yüzdelik Dilim Gecikmesi grafiği, dönüşüm sayısının kullanıcılarınız için nasıl performans gösterdiğini anlamanızı sağlar. Ani dalgalanmalar bu grafik, sistemlerinizin arayı kapatamadığına işaret edebilir kararlaştırdık. Bu grafiği düzenli aralıklarla kontrol etmeniz önerilir. tespit edebilirsiniz.
- Hata Dökümü grafikleri, ve entegrasyonlarınızla ilgili sorunları giderme. Her hata için başarı yüzdesi grafiğinizde vurgulanmışsa, bir hata kodu görüntülenir kullanabilirsiniz. Burada, olası hataları kontrol etmek için Google Home platform tarafından ve bu sorunların nasıl giderileceği bulabilirsiniz.
Platform Hata Kodları
Proje günlüklerinizde karşılaşabileceğiniz bazı yaygın hata kodlarını aşağıda bulabilirsiniz Google Home platform tarafından yakalanan sorunları belirleyin. Daha fazla bilgi için lütfen sorun giderme bilgileri için aşağıdaki tabloya bakın.
| Hata Kodu | Açıklama |
|---|---|
BACKEND_FAILURE_URL_ERROR |
Google, sizden 401 dışında bir HTTP 4xx hata kodu aldı
geliştirmenizi sağlar.
GCP Logging'deki requestId kullanarak akıllı
ev hizmetleri günlükleri.
|
BACKEND_FAILURE_URL_TIMEOUT |
Google'ın isteği, hizmetinize ulaşmaya çalışırken zaman aşımına uğradı.
Hizmetinizin internete bağlı olduğunu, bağlantıları kabul ettiğini ve kapasitenin üzerinde olmadığından emin olun. Ayrıca hedefin Cihazın açık, çevrimiçi ve senkronize edilmiş olduğundan emin olun. |
BACKEND_FAILURE_URL_UNREACHABLE |
Google, hizmetinizden bir HTTP 5xx hata kodu aldı.
GCP Logging'deki requestId kullanarak akıllı
ev hizmetleri günlükleri.
|
DEVICE_NOT_FOUND |
Cihaz, iş ortağı hizmeti tarafında mevcut değil.
Bu durum genellikle veri senkronizasyonunda bir hata olduğunu veya koşul. |
GAL_BAD_3P_RESPONSE |
Google, hesap bağlama hizmetinizden gelen yanıtı ayrıştıramıyor
(yükteki geçersiz biçim veya değerlerden dolayı)
Hata günlüklerini kontrol etmek için GCP Logging'de requestId kullanın
inceleyebilirsiniz.
|
GAL_INTERNAL |
Google bir
erişim jetonu.
GCP Logging'de bu hatada artış görürseniz iletişime geçin bize ulaşabilirsiniz. |
GAL_INVALID_ARGUMENT |
Google bir
erişim jetonu.
GCP Logging'de bu hatada artış görürseniz iletişime geçin bize ulaşabilirsiniz. |
GAL_NOT_FOUND |
Kullanıcının Google'da depolanan erişim jetonları ve yenileme jetonları
geçersiz kılındı ve artık yenilenemiyor. Kullanıcının yapması gerekenler
hizmetinizi kullanmaya devam etmek için hesabını yeniden bağlayın.
GCP Logging'de bu hatada artış görürseniz iletişime geçin bize ulaşabilirsiniz. |
GAL_PERMISSION_DENIED |
Jeton paylaşımı kullanılamadığında Google'ın dahili hatası oluştu
yetkilendirildi.
GCP Logging'de bu hatada artış görürseniz iletişime geçin bize ulaşabilirsiniz. |
GAL_REFRESH_IN_PROGRESS |
Kullanıcının erişim jetonunun süresi doldu ve aynı anda başka bir deneme
ve yenileme süreci devam ediyor.
Bu bir sorun değildir ve herhangi bir işlem yapmanız gerekmez. |
INVALID_AUTH_TOKEN |
Google, hizmetinizden bir HTTP 401 hata kodu aldı.
Erişim jetonunun süresi dolmadı ancak hizmetiniz, jetonu geçersiz hale getirdi. GCP Logging'de requestId kullanarak akıllı
ev hizmetleri günlükleri.
|
INVALID_JSON |
JSON yanıtı ayrıştırılamıyor veya anlaşılamıyor.
JSON yanıtınızın yapısında geçersiz söz dizimi olup olmadığını kontrol edin. eşleşmeyen parantez, eksik virgüller, geçersiz karakterler olarak işaretleyebilirsiniz. |
OPEN_AUTH_FAILURE |
Kullanıcının erişim jetonunun süresi doldu ve Google jetonu yenileyemiyor.
veya Google, hizmetinizden bir HTTP 401 hata kodu aldı.
Bu kodda artış görürseniz aynı zamanda bir Akıllı ev amaçları veya yenilemeyle ilgili hata sayısında artış jeton istekleri. |
PARTNER_RESPONSE_INVALID_ERROR_CODE |
Yanıt, tanınmayan bir hata kodu belirtiyor.
İstek yanıtınızda hata görünüyorsa bir hata kodu kullandığınızdan emin olun desteklenen hata kodları hakkında daha fazla bilgi edinin. |
PARTNER_RESPONSE_INVALID_PAYLOAD |
Yanıt payload alanı JSON olarak ayrıştırılamıyor
Nesne.
İstek yanıtınızdaki yük alanının eşleşip eşleşmediğini kontrol edin köşeli parantezleri ve bir JSON alanı olarak doğru şekilde yapılandırılmıştır. |
PARTNER_RESPONSE_INVALID_STATUS |
Yanıt bir durum belirtmiyor veya yanlış bir durumu belirtmiyor.
Amaç yerine getirme isteklerine verilen yanıtlar bir durum belirtmelidir SUCCESS, OFFLINE, ERROR, EXCEPTIONS ile değiştirin. Siz
şunun hakkında daha fazla bilgi bulabilirsiniz:
ele alma konusunda daha fazla bilgi edinin.
|
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES |
İstekte bulunan bir veya daha fazla intent
tıklayın.
Sitenizin test yanıtının doğru yapılandırılmış olduğundan ve yanıtınızda mevcut olması gerekir. |
PARTNER_RESPONSE_MISSING_DEVICE |
İstekte bulunan bir veya daha fazla cihaz
tıklayın.
Sitenizin tüm cihazların doğru şekilde yapılandırıldığından ve tüm cihazların istekteki kimlikler yanıtınızda mevcuttur. |
PARTNER_RESPONSE_MISSING_PAYLOAD |
Yanıt payload alanı içermiyor.
İstek yanıtınıza bir yük alanı eklediğinizden emin olun. Siz doğru şekilde geliştirmenin yanıt ekleyin. |
PARTNER_RESPONSE_NOT_OBJECT |
Yanıt, JSON nesnesi olarak ayrıştırılamıyor.
İstek yanıtınızdaki tüm alanlarda istenmeyen karakterler olup olmadığını kontrol edin. eşleşmeyen parantezler veya biçimlendirme hataları var. Bazı unicode karakterleri desteklenmeyebilir. Ayrıca yanıtınızın doğru olduğundan emin olun JSON nesnesi olarak yapılandırılır. |
PROTOCOL_ERROR |
İstek işlenemedi.
Verilerinizi kontrol etmek için Google Cloud Logging'deki requestId
akıllı ev hizmeti günlükleri.
|
RESPONSE_TIMEOUT |
İstek, yanıt beklenirken zaman aşımına uğradı.
Yanıt gönderme süresi, istek gönderilir. Bu süre içinde yanıt gönderdiğinizden emin olun kazanıyor. |
RESPONSE_UNAVAILABLE |
Yanıt alınamadı veya yanıtta durum belirtilmiyor.
Amaç yerine getirme isteklerine verilen yanıtlar yapılandırılmalıdır uyarınca akıllı ev dokümanlarına ve durumu belirtmesine olanak tanır. |
TRANSIENT_ERROR |
Geçici hata, kendi kendine çözülecek bir hatadır.
Bu hatalar genellikle bir cihaz bağlantısı veya hizmeti iptal edebilirsiniz. Ayrıca sunucuya yeni bağlantılar yapılamıyorsa açıldı. |
Arama Günlükleri
Metrikleri kullanarak entegrasyonlarınızı izleme konusunda alışkın olduğunuza göre adım adım belirli hataları gidermek için Cloud Logging. Hata günlüğü, zaman, hata gibi yararlı bilgiler içeren alanlara sahip JSON benzeri bir giriş kaynak akıllı ev amacı ile ilgili kod ve ayrıntılara yer verir.
Google Cloud içinde günlükleri gönderen birden fazla sistem var. daima tecrübe edin. Şunları yapmanız gerekir: günlüklerinizi filtrelemek için sorgular yazın ve ihtiyacınız olanları bulabilirsiniz. Sorgular Zaman Aralığı'na bağlı olabilir: Kaynak, günlük Önem derecesi veya özel girişlerdir.
Özel filtrelerinizi oluşturmanıza yardımcı olması için sorgu düğmelerini kullanabilirsiniz.
Zaman Aralığı belirtmek için, zaman aralığı seçim düğmesini tıklayın. ve sağlanan seçeneklerden birini belirleyin seçenekleri vardır. Bu işlem, günlükleri filtreler ve seçilen zaman aralığı.
Kaynak belirtmek için Kaynak açılır menüsünü tıklayın. ardından Google Asistan İşlem Projesi'ni seçin. Bu, filtre ekleyebilirsiniz. günlüklerin gösterilmesini sağlayabilirsiniz.
Önem derecesi düğmesini kullanarak Acil durum, Bilgi, Hata ayıkla ve ve diğer önem günlüğü düzeylerinden birini seçebilirsiniz.
Sorgu alanını Logs Explorer
kullanabilirsiniz. Bu alan tarafından kullanılan sorgu motoru, her ikisini de destekler
dize eşleştirme gibi temel sorgular ve şunlar da dahil olmak üzere daha gelişmiş sorgu türleri:
karşılaştırıcılar (<, >=, !=) ve boole operatörleri (AND, OR, NOT).
Örneğin, aşağıdaki özel giriş şu hataları döndürür:
kaynağı LIGHT cihaz türü:
resource.type = "assistant_action_project" AND severity = ERROR AND jsonPayload.executionLog.executionResults.actionResults.device.deviceType = "LIGHT"
Sorgu Kitaplığı'nı ziyaret edin. başlıklı makalemize göz atın.
Test Düzeltmeleri
Hataları belirleyip düzeltmek için güncellemeleri uyguladıktan sonra, kullanarak Google Home Test Suite. Google'da retrospektif toplantısı düzenleme test etmenize yardımcı olan Test Suite etkili biçimde değişir.
Eğitici Kaynaklar
Bu dokümanda, akıllı evinizdeki hataları giderme adımları yer almaktadır İşlem. Hata ayıklama hakkında daha fazla bilgi edinmek için codelab'lerimizi de kontrol edebilirsiniz:
- Akıllı Ev Codelab'inde hata ayıklama: Akıllı ev bulut entegrasyonuyla ilgili hata ayıklama hızlı başlangıç kılavuzu
- Yerel Ev Codelab'inde Hata Ayıklama: Akıllı ev yerel entegrasyonunda hata ayıklama hızlı başlangıç kılavuzu.