Entegrasyon hatalarını giderme

Buluttan buluta    Konu

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:

  1. Akıllı ev metriklerini kullanarak projelerinizin durumunu izleyin.
  2. Şu sayfadaki ayrıntılı hata açıklamalarını kontrol ederek sorunları araştırın: hata günlüklerine ekleyebilirsiniz.

Süreç, Local Home SDK Sorun giderme akışında ustalaştıktan sonra günlükler ve metrikler arasında kolayca geçiş yaparak kullanabileceğiniz hatalar.

İ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 olarak kontrol ettiğinizde, 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.

Akıllı ev hizmet günlüklerinizi kontrol etmek için GCP Günlük
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 alır.
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 jetonundan yararlanabilirsiniz.

GCP Logging'de bu hatada artış görürseniz iletişime geçin bize ulaşabilirsiniz.
GAL_INVALID_ARGUMENT Google, erişim jetonu almaya çalışırken Google dahili bir hata oluştu.

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ı yetkilendirilmediğinde Google'da dahili bir hata oluştu.

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ılamaz veya anlaşılamaz.

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 dolmuş ve Google bu jetonu yenileyemiyordur veya Google, hizmetinizden bir HTTP 401 hata kodu almıştır.

Bu kodun oranında artış görürseniz akıllı ev intent'leri veya yenileme jetonu istekleriyle ilgili hata oranında da artış olup olmadığını kontrol edin.
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ında eşleşen parantez olup olmadığını ve alanın JSON alanı olarak doğru şekilde yapılandırılıp yapılandırılmadığını kontrol edin.
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 yanıtta eksik.

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 bir 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 JSON nesnesi olarak doğru şekilde yapılandırıldığından emin olun.
PROTOCOL_ERROR İstek işlenemedi.

Verilerinizi kontrol etmek için Google Cloud Logging'deki requestId akıllı ev hizmeti günlükleri.
RESPONSE_TIMEOUT Yanıt beklenirken istek zaman aşımına uğradı.

Yanıt gönderme için zaman aşımı süresi, istek gönderildikten 9 saniye sonradır. 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'te, projenize her zaman günlük gönderen birden fazla sistem vardır. Ş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.

Bulut Günlüklerini Sorgulama

Özel filtrelerinizi oluşturmanıza yardımcı olması için sorgu düğmelerini kullanabilirsiniz.

Cloud Log Sorguları Derleme

Zaman aralığı belirtmek için zaman aralığı seçim düğmesini tıklayın ve sunulan seçeneklerden birini belirleyin. Bu işlem, günlükleri filtreler ve seçilen zaman aralığındaki günlükleri gösterir.

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.

Acil durum, Bilgi, Hata ayıklama ve diğer önem derecesi günlük düzeylerine göre filtrelemek için Önem derecesi düğmesini kullanın.

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:

Önceki
Cloud Logging