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 veya 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 simgesinden Cloud Logging'a erişmek için Tüm ürünleri göster'i tıklayın, ardından İşlemler > Günlük kaydı'na gidin.

Cloud Logging adresine gidin.

Günlük verilerine erişim, İşlemler projenizin kullanıcıları için Kimlik ve Erişim Yönetimi (IAM) aracılığıyla yönetilir. Günlük verileriyle ilgili 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. Girişleri, Logs Explorer arayüzünü kullanarak da isteğe bağlı olarak silebilirsiniz.

Günlükleri etkili bir şekilde kullanma hakkında daha fazla bilgiyi Sorun giderme kılavuzunun Günlüklerde 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 Asistan İşlemi ile ilişkili Google Cloud projesi için kapsayıcı.
  • project_id: Bu kaynakla ilişkili 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 amaç hataları
QUERY amaç hataları
EXECUTE amaç hataları
Bildirimler hatalar
Hesap bağlama hataları
Local Home SDK HandlerError

Senkronizasyon günlükleri

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

Mülk Açıklama
requestId Akıllı ev amaçlı istek kimliği.
httpLatencyMsec Yanıt alınana kadar 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ı listelenmiştir:

Mülk Açıklama
requestId Benzersiz istek kimliği (örneğin, 5325511189174727525).
latencyMsec Yanıt alınmadan geçen süre (ör. 6000).
executionType İsteğin gönderilmesi için kullanılan aktarım (ör. entegrasyonunuza bağlı olarak CLOUD veya MATTER).
actionType Gerçekleştirilen kullanıcı işleminin isteğe bağlı göstergesi (ör. QUERY veya EXECUTE). EXECUTE işlemleri için, desteklenen özellikler için karşılama hizmetine verilen komutu içerir. Örneğin: 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 Yerel karşılamadan kaynaklanan bir hatanın ardından isteğin bulut karşılamaya yönlendirilip yönlendirilmediği.
statusType Niyet yanıtının durumunu gösterir (ör. SUCCESS, PENDING veya OFFLINE). ERROR yanıtları için bu özellik, 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, 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üklerini alacak şekilde ayarlanır ve geliştiriciler başarı günlüklerini de almayı etkinleştirebilir. Bu özellik, özellikle birkaç aracıdan tüm günlükleri almayı 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 Console'a 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ü alımı 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 Gezgini de günlük kaydı sorgu dilini kullandığından sorgu oluşturmanıza yardımcı olması için Günlük Gezgini'ni kullanabilirsiniz.

Hariç tutma filtreleri 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. Günlük tabanlı metriklerde özel grafikler oluşturmak ve uyarılar ayarlamak da mümkündür.

Akıllı ev için günlük tabanlı metrikleri kullanmaya başlamak üzere sayaç günlük tabanlı 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 belgelere bakın:

  • Fiyatlandırma: Tahsisler ve fazla kullanım maliyetleriyle ilgili ayrıntılar.
  • Kotalar ve sınırlar: Günlük 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.