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

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

Erişim Günlüğü

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

Cloud Logging sayfasına git

Günlük kaydı verilerine erişim, Actions projenizin kullanıcıları için Kimlik ve Erişim Yönetimi (IAM) üzerinden yönetilir. Veri günlük kaydı rolleri ve izinleri 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 olarak 30 gün boyunca saklanır, ardından silinmek üzere programlanır. Ayrıca, Günlük Gezgini arayüzünü kullanarak isteğe bağlı girişleri silebilirsiniz.

Günlükleri etkili bir şekilde kullanma hakkında daha fazla bilgiyi Sorun Giderme kılavuzunun Günlük 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 Bir Google Asistan projesiyle ilişkili Google Cloud projesinin kapsayıcısıdır.
  • project_id: Bu kaynakla ilişkilendirilmiş mevcut projenizin tanımlayıcısı. Örneğin, 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 SYNC intent hataları
QUERY intent hataları
EXECUTE intent hatası
Bildirimler hataları
Hesap bağlama hataları
Yerel Ev SDK HandlerError

Günlükleri senkronize etme

Aşağıdaki tabloda bir syncLog girişinin şeması gösterilmektedir:

Ö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ı gösterilmektedir:

Özellik Açıklama
requestId Benzersiz istek kimliği (ör. 5325511189174727525).
latencyMsec Yanıt alınmadan önce geçen süre (örneğin, 6000).
executionType Entegrasyonunuza bağlı olarak CLOUD veya MATTER gibi bir istek için kullanılan taşıma işlemi.
actionType Kullanıcının yaptığı işleme ilişkin isteğe bağlı bir gösterge (örneğin, QUERY veya EXECUTE). EXECUTE işlemleri için desteklenen özelliklerle ilgili karşılama komutuna verilen komutu içerir. Örneğin, ONOFF_OFF
trait Bu kullanıcı işlemiyle ilişkilendirilen 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 sipariş karşılamadaki bir hatadan sonra bulut karşılamaya yönlendirilip yönlendirilmeyeceği.
statusType Amaç yanıtının durumunu (ör. SUCCESS, PENDING veya OFFLINE) belirtir. ERROR yanıtları için bu özellik, istek karşılama tarafından sağlanan errorCode öğesini 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ı gösterilmektedir:

Ö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üklerini alacak şekilde ayarlanmıştır. Geliştiriciler de başarı günlüklerini almayı tercih edebilir. Bu, birkaç aracıdan tüm günlükleri yakalamayı planladığınız geliştirme aşamasında özellikle faydalıdır. Günlük kaydı kotasını aşarsanız projeniz için ek ücretler uygulanabilir.

Projenizin günlük düzeyini şu yöntemlerle kontrol edebilirsiniz:

  1. Actions on Google Console bölümünden Projeler sayfasına gidin.

    Actions on Google konsoluna gidin

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

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

  4. Günlük kontrolü besleme açılır listesinde 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ı sorgu dilini kullanarak günlükten hariç tutma oluşturabilir. Günlük kaydı sorgu dili Günlük Gezgini tarafından da kullanıldığından, sorgu oluşturmak için Günlük Gezgini'ni kullanabilirsiniz.

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

Günlük tabanlı metrikler

Geliştiriciler, günlüklerindeki kalıpları izlemek ve analiz etmek için günlük tabanlı metrikleri kullanabilir. Ayrıca, günlük tabanlı metriklerde ö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üğüne dayalı metrik kılavuzu oluşturma sayfasını inceleyin.

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

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