Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.

Mengakses log peristiwa dengan Cloud Logging

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Anda dapat mengakses log peristiwa 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.

Logging Akses

Untuk mengakses Cloud Logging dari Google Cloud Platform Console , klik View all products, lalu buka Operations > Logging.

Buka Cloud Logging

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

Entri log dipertahankan selama 30 hari sesuai dengan kebijakan retensi Cloud Logging, lalu 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 Menelusuri Log pada 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 Action Asisten.
  • project_id: ID project Anda saat ini yang terkait dengan resource ini, misalnya my-project.

Log aktivitas

Project Anda mendukung peristiwa berikut di Cloud Logging:

Resource Cloud Logging Peristiwa
Project Tindakan Asisten Google Error intent SYNC
Error intent QUERY
Error intent EXECUTE
Error Notifications
Error Penautan akun
Local Home SDK HandlerError

Menyinkronkan log

Tabel di bawah mencantumkan skema entri syncLog:

Properti Deskripsi
requestId ID permintaan intent smart home.
httpLatencyMsec Waktu yang 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 berlalu sebelum respons diterima, misalnya 6000.
executionType Transportasi yang digunakan untuk permintaan, misalnya CLOUD atau MATTER, bergantung pada integrasi Anda.
actionType Indikator opsional tindakan pengguna yang diambil, misalnya QUERY atau EXECUTE. Untuk tindakan EXECUTE, termasuk perintah yang dikeluarkan untuk memenuhi guna karakteristik yang didukung, misalnya ONOFF_OFF
trait Sifat opsional yang terkait dengan tindakan pengguna ini.
deviceTypes Daftar jenis perangkat yang terpengaruh oleh peristiwa tersebut, misalnya LIGHT.
isSuccess Apakah permintaan menerima respons yang berhasil.
fallbackToCloud Apakah permintaan dirutekan ke fulfillment cloud mengikuti error dari fulfillment lokal.
statusType Menunjukkan status respons intent, seperti SUCCESS, PENDING, atau OFFLINE. Untuk respons ERROR, properti ini berisi errorCode yang disediakan oleh fulfillment.
externalDebugString Pesan proses debug opsional 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 "ObjectDetection".
status Menunjukkan status notifikasi.

Setelan level log

Project ditetapkan untuk menerima log error secara default, dan developer juga dapat memilih untuk menerima log keberhasilan. Hal ini sangat berguna selama fase pengembangan saat Anda berencana untuk merekam semua log dari beberapa agen. Biaya tambahan dapat berlaku untuk project jika Anda melebihi kuota logging.

Anda dapat mengontrol level log untuk project dengan:

  1. Di Konsol Actions, buka halaman Project.

    Buka konsol Actions

  2. Pilih project smart home Anda.

  3. Pilih tab Develop, lalu klik Actions pada sidebar.

  4. Pilih All di menu dropdown Penyerapan kontrol log.

Pengecualian log

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

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

Metrik berbasis log

Developer dapat menggunakan Metrik berbasis log untuk melacak dan menganalisis pola dalam log mereka. Anda juga dapat membuat diagram kustom dan menyiapkan notifikasi pada 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 dokumentasi berikut:

  • Harga: Detail mengenai alokasi dan biaya kelebihan penggunaan.
  • Kuota dan batas: Detail tentang batas dan kebijakan retensi untuk penggunaan log.
  • Kueri log lanjutan: Panduan untuk menggunakan ekspresi lanjutan guna membuat kueri dan menganalisis data log.