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 Console, klik View all products, lalu buka Observability > Logging.
Akses ke data logging dikelola melalui Identity and Access Management (IAM) untuk pengguna project Action Anda. Untuk mengetahui detail selengkapnya tentang peran dan izin untuk data logging, lihat kontrol akses Cloud Logging.
Entri log disimpan selama 30 hari sesuai dengan kebijakan retensi Cloud Logging, lalu dijadwalkan untuk dihapus. Anda juga dapat menghapus entri sesuai permintaan 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 | Penampung untuk Project Google Cloud yang terkait dengan Action Asisten. |
|
Log peristiwa
Project Cloud-to-cloud mendukung peristiwa berikut di Cloud Logging:
| Resource Cloud Logging | Acara |
|---|---|
| Project Tindakan Asisten Google | Error intent SYNC |
| Error intent QUERY | |
| Error intent EXECUTE | |
| Notifikasi error | |
| Error penautan akun | |
| HandlerError Local Home SDK |
Log sinkronisasi
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 yang berlalu sebelum respons diterima, misalnya,
6000. |
executionType |
Transport yang digunakan untuk permintaan, misalnya CLOUD atau
MATTER, bergantung pada integrasi Anda. |
actionType |
Indikator opsional tindakan pengguna yang dilakukan, misalnya
QUERY atau EXECUTE.
Untuk tindakan EXECUTE, menyertakan perintah yang dikeluarkan ke fulfillment untuk karakteristik yang didukung, misalnya ONOFF_OFF
|
trait |
Karakteristik 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 respons ERROR, 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 "ObjectDetection". |
status |
Menunjukkan status notifikasi. |
Setelan level log
Project Cloud-to-cloud ditetapkan untuk menerima log error secara default, dan developer dapat memilih untuk menerima log keberhasilan juga. Hal ini sangat berguna selama fase pengembangan saat Anda berencana untuk menangkap semua log dari beberapa agen. Biaya tambahan mungkin berlaku untuk project Anda jika Anda melebihi kuota logging.
Anda dapat mengontrol level log untuk project Anda dengan:
Di Actions on Google Console, buka halaman Project.
Pilih project smart home Anda.
Pilih tab Develop, lalu klik Actions di sidebar.
Pilih All di menu dropdown Log control ingestion.
Pengecualian log
Developer dapat membuat pengecualian log menggunakan bahasa kueri logging 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 kueri.
Anda dapat mengikuti langkah-langkah untuk membuat filter pengecualian di
panduan ini
(konfigurasikan 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 pemberitahuan pada metrik berbasis log.
Untuk mulai menggunakan metrik berbasis log untuk smart home, lihat panduan membuat metrik berbasis log penghitung.
Referensi terkait
Untuk mempelajari lebih lanjut cara menggunakan Cloud Logging dalam project Anda, lihat dokumentasi berikut:
- Harga: Detail tentang alokasi dan biaya kelebihan penggunaan.
- Kuota dan batas: Detail tentang batas dan kebijakan retensi untuk penggunaan logging.
- Kueri log lanjutan: Panduan untuk menggunakan ekspresi lanjutan guna mengkueri dan menganalisis data log.