Cloud Logging untuk ekosistem Google Home

Cloud ke cloud Kasus

Anda dapat mengakses log aktivitas untuk integrasi dari Google Cloud Logging Gunakan Cloud Logging untuk menjelajahi log, membuat metrik dan pemberitahuan, atau mengekspor log ke aplikasi lain menggunakan Google Cloud Pub/Sub.

Pencatatan Akses

Untuk mengakses Cloud Logging dari Google Cloud Console, klik Lihat semua produk, lalu buka Operasi > Logging.

Buka Cloud Logging

Akses ke data logging dikelola melalui Identity and Access Management (IAM) untuk pengguna project Actions Anda. Untuk detail selengkapnya tentang peran dan izin untuk data logging, lihat Cloud Logging kontrol akses.

Entri log disimpan selama 30 hari sesuai Cloud Logging kebijakan retensi, kemudian dijadwalkan untuk dihapus. Anda juga dapat menghapus entri sesuai permintaan dengan menggunakan Antarmuka Logs Explorer.

Anda dapat mempelajari lebih lanjut cara menggunakan log secara efektif di bagian Log Penelusuran Panduan pemecahan masalah.

Cloud Logging menyediakan jenis resource berikut:

Jenis Resource Nama Tampilan Deskripsi Label
assistant_action_project Project Tindakan Asisten Google Container untuk Project Google Cloud yang terkait dengan Asisten {i>Action<i}.
  • project_id: ID project Anda saat ini yang dikaitkan dengan resource ini. Misalnya, my-project.

Log aktivitas

Cloud-to-cloud project mendukung peristiwa berikut di Cloud Pencatatan log:

Resource Cloud Logging Acara
Project Tindakan Asisten Google Error intent SYNC
Error intent QUERY
Error intent EXECUTE
Notifikasi kesalahan
Penautan akun kesalahan
Local Home SDK HandlerError

Sinkronkan log

Tabel di bawah mencantumkan skema entri syncLog:

Properti Deskripsi
requestId ID permintaan intent smart home.
httpLatencyMsec Waktu berlalu sebelum respons diterima.
status Menunjukkan status respons intent.

Log eksekusi

Tabel di bawah mencantumkan skema entri executionLog:

Properti Deskripsi
requestId ID permintaan unik, misalnya 5325511189174727525.
latencyMsec Waktu yang berlalu sebelum respons diterima, misalnya, 6000.
executionType Transport yang digunakan untuk permintaan, misalnya CLOUD atau MATTER, bergantung pada integrasi Anda.
actionType Indikator opsional untuk tindakan pengguna yang diambil, misalnya QUERY atau EXECUTE. Untuk tindakan EXECUTE, termasuk perintah yang dikeluarkan untuk fulfillment untuk karakteristik yang didukung, misalnya ONOFF_OFF
trait Sifat opsional yang terkait dengan tindakan pengguna ini.
deviceTypes Daftar jenis perangkat yang terpengaruh oleh peristiwa, misalnya LIGHT.
isSuccess Apakah permintaan menerima respons yang berhasil.
fallbackToCloud Apakah permintaan dirutekan ke fulfillment cloud setelah terjadi error dari fulfillment lokal.
statusType Menunjukkan status respons intent, seperti SUCCESS, PENDING, atau OFFLINE. Untuk ERROR respons, properti ini berisi errorCode yang disediakan oleh fulfillment.
externalDebugString Pesan proses debug mendetail opsional yang terkait dengan tindakan pengguna ini.
locale Kode bahasa yang terkait dengan permintaan.

Log notifikasi

Tabel di bawah mencantumkan skema entri notificationLog:

Properti Deskripsi
requestId ID permintaan notifikasi.
structName Nama struct notifikasi, seperti "ObjectDeteksi".
status Menunjukkan status notifikasi.

Setelan level log

Cloud-to-cloud project disetel untuk menerima log error secara default, dan developer dapat memilih untuk menerima log keberhasilan. Hal ini sangat berguna selama tahap pengembangan ketika Anda berencana untuk menangkap semua log dari beberapa agen. Biaya tambahan mungkin berlaku untuk proyek Anda melebihi kuota logging.

Anda dapat mengontrol level log untuk project dengan:

  1. Di Actions on Google Console, buka halaman Project.

    Buka konsol Actions on Google

  2. Pilih project smart home Anda.

  3. Pilih tab Kembangkan, lalu klik Tindakan di sidebar.

  4. Pilih Semua di daftar dropdown Penyerapan kontrol log.

Pengecualian log

Developer dapat membuat pengecualian log menggunakan kueri logging bahasa untuk menyesuaikan log mereka lebih lanjut dengan cara yang lebih fleksibel. Bahasa kueri logging juga digunakan oleh Logs Explorer sehingga Anda dapat menggunakan Logs Explorer untuk membantu membuat terhadap kueri.

Anda dapat mengikuti langkah-langkah untuk membuat filter pengecualian di panduan ini (konfigurasikan filter pengecualian untuk sink _Default).

Metrik berbasis log

Pengembang dapat menggunakan Metrik berbasis log untuk melacak dan menganalisis pola dalam log mereka. Dimungkinkan juga untuk membuat diagram kustom dan siapkan pemberitahuan metrik berbasis log.

Untuk mulai menggunakan metrik berbasis log untuk smart home, lihat membuat panduan metrik berbasis log penghitung.

Untuk mempelajari lebih lanjut cara menggunakan Cloud Logging di project Anda, lihat referensi berikut dokumentasi:

  • Harga: Detail tentang alokasi dan biaya kelebihan penggunaan.
  • Kuota dan batas: Detail tentang batas dan kebijakan retensi untuk logging penggunaan.
  • Kueri log lanjutan: Panduan penggunaan ekspresi lanjutan untuk mengkueri dan menganalisis data log.