Google Home ekosistemi için Cloud Logging

Buluttan buluta    Matter

Entegrasyonlarınızın etkinlik günlüklerine Google Cloud Logging adresinden erişebilirsiniz. Günlükleri keşfetmek, metrik ve uyarı oluşturmak ya da Google Cloud Pub/Sub'ı kullanarak günlükleri diğer uygulamalara aktarmak için Cloud Logging simgesini kullanın.

Erişim Günlüğü

Google Cloud Console sayfasından Cloud Logging'e erişmek için Tüm ürünleri görüntüle'yi tıklayın, ardından İşlemler > Günlük'e gidin.

Cloud Logging adresine gidin

Günlük verilerine erişim, Actions projenizin kullanıcıları için Kimlik ve Erişim Yönetimi (IAM) aracılığıyla yönetilir. Günlük verilerine yönelik roller ve izinler hakkında daha fazla bilgi için Cloud Logging erişim denetimi başlıklı makaleyi inceleyin.

Günlük girişleri, Cloud Logging saklama politikası uyarınca 30 gün boyunca saklanır ve ardından silinmek üzere planlanır. Günlük Gezgini arayüzünü kullanarak da girişleri istediğiniz zaman silebilirsiniz.

Günlükleri etkili bir şekilde kullanma hakkında daha fazla bilgiyi Sorun giderme kılavuzunun Günlükleri Arama bölümünde bulabilirsiniz.

Cloud Logging aşağıdaki kaynak türlerini sağlar:

Kaynak Türü Görünen Ad Açıklama Etiketler
assistant_action_project Google Asistan İşlem Projesi Asistan işlemiyle ilişkili Google Cloud projesi için bir kapsayıcı.
  • project_id: Mevcut projenizin bu kaynakla ilişkili tanımlayıcısı (ör. my-project).

Olay günlükleri

Cloud-to-cloud projeleri, Cloud Logging'da aşağıdaki etkinlikleri destekler:

Cloud Logging kaynağı Etkinlik
Google Asistan İşlem Projesi SYNC intent hataları
QUERY intent hataları
EXECUTE intent hataları
Bildirimler hataları
Hesap bağlama hataları
Local Home SDK HandlerError

Senkronizasyon günlükleri

Aşağıdaki tabloda bir syncLog girişinin şeması listelenmiştir:

Mülk Açıklama
requestId Akıllı ev intent istek kimliği.
httpLatencyMsec Yanıt alıncaya kadar geçen süre.
status Intent yanıtının durumunu gösterir.

Yürütme günlükleri

Aşağıdaki tabloda bir executionLog girişinin şeması listelenmiştir:

Mülk Açıklama
requestId Benzersiz istek kimliği (ör. 5325511189174727525).
latencyMsec Yanıt alıncaya kadar geçen süre (ör. 6000).
executionType Entegrasyonunuza bağlı olarak istek için kullanılan aktarım (ör. CLOUD veya MATTER).
actionType Kullanıcının gerçekleştirdiği işlemin isteğe bağlı göstergesi (ör. QUERY veya EXECUTE). EXECUTE işlemleri için, desteklenen özelliklerle ilgili karşılama işlemine gönderilen komutu içerir (ör. ONOFF_OFF)
trait Bu kullanıcı işlemiyle ilişkili isteğe bağlı özellik.
deviceTypes Etkinlikten etkilenen cihaz türlerinin listesi (ör. LIGHT).
isSuccess İsteğin başarılı bir yanıt alıp almadığı.
fallbackToCloud İsteğin, yerel karşılamadaki bir hatadan sonra bulut karşılamaya yönlendirilip yönlendirilmediği.
statusType Intent yanıtının durumunu gösterir (ör. SUCCESS, PENDING veya OFFLINE). ERROR yanıtları için bu mülk, yerine getirme işlemi tarafından sağlanan errorCode değerini içerir.
externalDebugString Bu kullanıcı işlemiyle ilişkili isteğe bağlı ayrıntılı hata ayıklama mesajı.
locale İstekle ilişkili dil kodu.

Bildirim günlükleri

Aşağıdaki tabloda bir notificationLog girişinin şeması listelenmiştir:

Mülk Açıklama
requestId Bildirim isteği kimliği.
structName Bildirim yapısının adı (ör. "ObjectDetection").
status Bildirimin durumunu gösterir.

Günlük kaydı düzeyi ayarı

Cloud-to-cloud projeleri varsayılan olarak hata günlükleri alacak şekilde ayarlanmıştır. Geliştiricilerin başarı günlüklerini de etkinleştirmesi mümkündür. Bu, özellikle birkaç temsilciden gelen tüm günlükleri yakalamayı planladığınız geliştirme aşamasında yararlıdır. Günlük kaydı kotasını aşarsanız projeniz için ek ücretler uygulanabilir.

Projenizin günlük düzeyini şu şekilde kontrol edebilirsiniz:

  1. Actions on Google Console üzerinden Projeler sayfasına gidin.

    Actions on Google Konsolu'na gidin

  2. Akıllı ev projenizi seçin.

  3. Geliştir sekmesini seçin ve yan çubuktaki İşlemler'i tıklayın.

  4. Günlük kontrolü beslemesi açılır listesinde Tümü'nü seçin.

Günlükleri hariç tutma

Geliştiriciler, günlüklerini daha esnek bir şekilde özelleştirmek için günlük kaydı sorgu dilini kullanarak günlük hariç tutmaları oluşturabilir. Günlük kaydı sorgu dili, Günlük Gezgini tarafından da kullanılır. Bu nedenle, sorgu oluşturmak için Günlük Gezgini'ni kullanabilirsiniz.

Bu kılavuzda hariç tutma filtresi oluşturma adımlarını uygulayabilirsiniz (_Default havuzu için hariç tutma filtresini yapılandırın).

Günlük tabanlı metrikler

Geliştiriciler, günlüklerindeki kalıpları izlemek ve analiz etmek için günlüğe dayalı metrikleri kullanabilir. Günlük tabanlı metrikler için özel grafikler oluşturabilir ve uyarılar ayarlayabilirsiniz.

Akıllı ev için günlük tabanlı metrikleri kullanmaya başlamak istiyorsanız günlük tabanlı bir sayaç metriği oluşturma kılavuzuna göz atın.

Projenizde Cloud Logging'i kullanma hakkında daha fazla bilgi edinmek için aşağıdaki dokümanlara bakın:

  • Fiyatlandırma: Ayrılan kotalar ve aşma maliyetleri hakkında ayrıntılar.
  • Kotalar ve sınırlar: Günlük kaydı kullanımıyla ilgili sınırlar ve saklama politikaları hakkında ayrıntılı bilgi.
  • Gelişmiş günlük sorguları: Günlük verilerini sorgulamak ve analiz etmek için gelişmiş ifadeleri kullanma kılavuzu.