Google Home ekosistemi için Cloud Logging

Buluttan buluta    Konu

Entegrasyonlarınızın olay günlüklerine Google Cloud Logging üzerinden erişebilirsiniz. Google Cloud Pub/Sub'ı kullanarak günlükleri keşfetmek, metrik ve uyarı oluşturmak veya günlükleri diğer uygulamalara aktarmak için Cloud Logging hizmetini kullanın.

Günlük Kaydına Erişim

Cloud Logging ürününe Google Cloud Console üzerinden erişmek için Tüm ürünleri göster'i tıklayın ve ardından İşlemler > Günlük Kaydı'na gidin.

Cloud Logging hizmetine gidin

Günlük kaydı verilerine erişim, Actions projenizin kullanıcıları için Identity and Access Management (IAM) üzerinden yönetilir. Günlüğe kaydetme verileriyle ilgili roller ve izinler hakkında daha fazla bilgi için Cloud Logging erişim denetimi bölümünü inceleyin.

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

Günlükleri etkili bir şekilde nasıl kullanacağınız hakkında daha fazla bilgiyi Sorun giderme kılavuzunun Arama Günlükleri 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 Bir Asistan İşlemi ile ilişkili Google Cloud Projesi'nin kapsayıcısıdır.
  • project_id: Bu kaynakla ilişkili mevcut projenizin tanımlayıcısıdır (ör. my-project).

Olay günlükleri

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

Cloud Logging Kaynağı Etkinlik
Google Asistan İşlem Projesi SENKRONİZE intent hataları
QUERY intent hataları
EXECUTE intent hataları
Bildirim hataları
Hesap bağlama hataları
Yerel Ana Sayfa SDK'sı HandlerError

Günlükleri senkronize et

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

Özellik Açıklama
requestId Akıllı ev amacı istek kimliği.
httpLatencyMsec Yanıt alınmadan önce geçen süre.
status Amaç yanıtının durumunu gösterir.

Yürütme günlükleri

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

Özellik Açıklama
requestId Benzersiz istek kimliği (ör. 5325511189174727525).
latencyMsec Yanıt alınmadan önce geçen süre (ör. 6000).
executionType İstek için kullanılan aktarım. Örneğin, entegrasyonunuza bağlı olarak CLOUD veya MATTER.
actionType Kullanıcının gerçekleştirdiği işlemin isteğe bağlı göstergesi. Örneğin, QUERY veya EXECUTE. EXECUTE işlemlerinde, desteklenen özellikler (ör. ONOFF_OFF) için karşılamaya verilen komutu içerir.
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 istek karşılamadaki bir hatanın ardından bulut karşılamaya yönlendirilip yönlendirilmediği.
statusType Amaç yanıtının durumunu belirtir (ör. SUCCESS, PENDING veya OFFLINE). Bu mülk, ERROR yanıtları için istek karşılama 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ı listelenmektedir:

Özellik Açıklama
requestId Bildirim isteği kimliği.
structName Bildirim yapısının adı (ör. "ObjectDetection").
status Bildirimin durumunu belirtir.

Günlük düzeyi ayarı

Cloud-to-cloud projeleri varsayılan olarak hata günlükleri alacak şekilde ayarlanmıştır. Geliştiriciler de başarı günlüklerini alma seçeneğini etkinleştirebilirler. Bu, özellikle birkaç aracıdan tüm günlükleri yakalamayı planladığınız geliştirme aşamasında faydalıdır. Günlük kaydı kotasını aşarsanız projenize ek ücretler uygulanabilir.

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

  1. Actions on Google Console sayfasında Projeler sayfasına gidin.

    Actions on Google konsoluna gidin

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

  3. Geliştir sekmesini seçin ve kenar çubuğunda İşlemler'i tıklayın.

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

Günlük hariç tutmaları

Geliştiriciler, günlüklerini daha esnek bir şekilde özelleştirmek için günlük kaydı sorgusu 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. Böylece, sorgu oluşturmanıza yardımcı olması için Günlük Gezgini'ni kullanabilirsiniz.

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

Günlük tabanlı metrikler

Geliştiriciler, günlüklerindeki kalıpları izleyip analiz etmek için Günlük tabanlı metrikleri kullanabilir. Özel grafikler oluşturmak ve günlük tabanlı metrikler için uyarı ayarlamak da mümkündür.

Akıllı ev için günlük tabanlı metrikleri kullanmaya başlamak üzere Sayaç günlüğü tabanlı metrik kılavuzu oluşturma makalesine göz atın.

Projenizde Cloud Logging'i kullanma hakkında daha fazla bilgi edinmek için aşağıdaki belgeleri inceleyin: