Cloud Logging ile olay günlüklerine erişme

Entegrasyonlarınızın etkinlik günlüklerine Google Cloud Logging adresinden erişebilirsiniz. Günlükleri keşfetmek, metrikler ve uyarılar oluşturmak ve Google Cloud Pub/Sub kullanarak günlükleri başka uygulamalara aktarmak için Cloud Logging kullanın.

Erişim Günlük Kaydı

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

Cloud Logging sitesine git

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

Günlük girişleri, Cloud Logging saklama politikasına göre 30 gün boyunca saklandıktan sonra silinmek üzere programlanır. Ayrıca, Günlük Gezgini arayüzünü kullanarak girişleri isteğe bağlı olarak silebilirsiniz.

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

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 İşlemiyle ilişkilendirilmiş 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 proje, Cloud Logging'de aşağıdaki etkinlikleri destekler:

Cloud Logging Kaynağı Etkinlik
Google Asistan İşlem Projesi SENKRONİZASYON amacı hataları
QUERY amaç hataları
EXECUTE intent hatası
Bildirim hataları
Hesap bağlama hataları
Yerel Home SDK'sı HandlerError

Senkronizasyon günlükleri

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 Niyet 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 (örneğin, 5325511189174727525).
latencyMsec Yanıt alınmadan önce geçen süre (örneğin, 6000).
executionType Entegrasyonunuza bağlı olarak, istek için kullanılan aktarım (ör. CLOUD veya MATTER).
actionType Yapılan kullanıcı işleminin isteğe bağlı göstergesi. Örneğin, QUERY veya EXECUTE. EXECUTE işlemleri için, desteklenen özelliklerin karşılanmasına yönelik verilen komutu içerir (ör. ONOFF_OFF)
trait Bu kullanıcı işlemiyle ilişkilendirilmiş 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 istek karşılamaya yönlendirilip yönlendirilmediği.
statusType Niyet yanıtının durumunu (ör. SUCCESS, PENDING veya OFFLINE) gösterir. Bu özellik, 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şkilendirilen 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 gösterir.

Günlük düzeyi ayarı

Cloud-to-cloud projeleri varsayılan olarak hata günlüklerini alacak şekilde ayarlanmıştır. Ayrıca geliştiriciler, başarı günlüklerini almayı etkinleştirebilir. 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 projeniz için ek ücret 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ü beslemesi açılır listesinde Tümü'nü seçin.

Günlük hariç tutmaları

Geliştiriciler, günlüklerini daha esnek bir şekilde daha da özelleştirmek için günlük kaydı sorgu dilini kullanarak günlük hariç tutma işlemleri oluşturabilir. Günlük kaydı sorgu dili Günlük Gezgini tarafından da kullanılır. Böylece sorgu oluşturmaya yardımcı olması için Günlük Gezgini'ni kullanabilirsiniz.

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

Günlük tabanlı metrikler

Geliştiriciler, günlüklerindeki kalıpları takip etmek ve analiz etmek için günlük tabanlı metrikleri kullanabilir. Ayrıca, günlük tabanlı metrikler için özel grafikler oluşturabilir ve uyarılar oluşturabilirsiniz.

Akıllı ev için günlük tabanlı metrikleri kullanmaya başlamak istiyorsanız Sayaç günlük tabanlı metrik kılavuzu oluşturma başlıklı makaleye göz atın.

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