Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.

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

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Entegrasyonlarınızla ilgili olay günlüklerine Google Cloud Logging üzerinden 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 uygulamasını kullanın.

Erişim Günlüğü

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

Cloud Logging adresine gidin

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 sayfasına göz atın.

Günlük girişleri, Cloud Logging saklama politikası uyarınca 30 gün boyunca saklanır, ardından silinmek üzere programlanır. Günlük Gezgini arayüzünü kullanarak isteğe bağlı girişleri de silebilirsiniz.

Günlükleri nasıl kullanacağınız hakkında daha fazla bilgi için Sorun Giderme kılavuzunun Arama Günlükleri bölümüne bakabilirsiniz.

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 için bir kapsayıcı.
  • project_id: Bu kaynakla ilişkili mevcut projenizin tanımlayıcısıdır (örneğin, my-project).

Olay günlükleri

Projeniz, Cloud Logging'de aşağıdaki etkinlikleri destekler:

Cloud Logging Kaynağı Etkinlik
Google Asistan İşlem Projesi SYNC amaç hataları
QUERY amaç hataları
Yürütme amaçlı hatalar
Bildirimler hataları
Hesap bağlama hataları
Yerel Ev SDK'sı HandlerError

Günlükleri senkronize et

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 belirtir.

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 Entegrasyona bağlı olarak istek için kullanılan taşıma yöntemi (ör. CLOUD veya MATTER).
actionType Kullanıcı işleminin isteğe bağlı göstergesi (ör. QUERY veya EXECUTE). EXECUTE işlemleri için desteklenen özelliklerle (ör. ONOFF_OFF) karşılamak üzere verilen komutu içerir.
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 Yerel karşılamadan gelen bir hatadan sonra isteğin bulut karşılama sistemine yönlendirilip yönlendirilmeyeceği.
statusType Niyet yanıtının durumunu (ör. SUCCESS, PENDING veya OFFLINE) belirtir. Bu özellik, ERROR yanıtları için sipariş 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ı

Projeler varsayılan olarak hata günlüklerini alacak şekilde ayarlanmıştır ve geliştiricilerin başarı günlüklerini almayı tercih etmesi de mümkündür. Bu, özellikle birkaç temsilcinin tüm günlüklerini yakalamayı planladığınız geliştirme aşaması sırasında yararlıdır. Günlük kaydı kotasını aşarsanız projenize ek ücretler uygulanabilir.

Projenizin günlük düzeyini aşağıdaki yöntemlerle kontrol edebilirsiniz:

  1. İşlemler konsolunda Projeler sayfasına gidin.

    Actions Console'u açma

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

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

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

Hariç tutulanları günlüğe kaydet

Geliştiriciler, günlüklerini daha esnek bir şekilde özelleştirmek için günlük kaydı sorgu dilini kullanarak günlük hariç tutma işlemi 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.

Bu kılavuzdaki hariç tutma filtresi oluşturma adımlarını uygulayabilirsiniz (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 amacıyla sayaç tabanlı bir metrik kılavuzu oluşturma sayfasına göz atın.

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

  • Fiyatlandırma: Ayrılan ücretler ve aşım maliyetleriyle ilgili ayrıntılar.
  • Kotalar ve sınırlar: Kullanımı günlüğe kaydetmeyle 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 rehberi.