1. Sebelum memulai
Seperti yang telah dibahas dalam codelab Men-debug Smart Home, kami memublikasikan metrik dan log ke project Smart Home Anda. Metrik membantu Anda menentukan tempat Action Smart Home Anda mengalami masalah, dan log berguna saat melakukan pembahasan mendalam untuk mengatasi masalah tersebut.
Anda dapat menyiapkan pemberitahuan menggunakan metrik yang disediakan ke project untuk memantau gangguan secara otomatis dan mendapatkan notifikasi selama gangguan layanan. Kami memublikasikan metrik keyakinan untuk menyoroti gangguan pada project Anda, yang akan kita bahas dalam codelab ini bersama dengan semua alat pemberitahuan lain yang tersedia untuk Anda di Google Cloud Platform.
Prasyarat
- Memiliki Integrasi Kompatibel dengan Smart Home.
- Menyelesaikan codelab Men-debug Smart Home.
Yang akan Anda pelajari
- Cara memantau masalah performa dan gangguan layanan di project Anda.
- Cara membuat pemberitahuan berbasis nilai minimum dan menerima notifikasi selama gangguan.
- Cara memanfaatkan metrik keyakinan yang diberikan ke project Anda untuk mendeteksi gangguan layanan.
2. Memantau Kinerja
Pemantauan performa sangat penting untuk keberhasilan integrasi dengan Ekosistem Google Smart Home. Kami menyediakan serangkaian alat pemantauan untuk developer smart home di Google Cloud Platform. Anda dapat menggunakan alat ini untuk mendapatkan gambaran tentang performa project Anda.
Mengakses Dasbor
Langkah pertama untuk mengakses data Anda adalah memeriksa dasbor Google Home, dengan login ke Google Cloud Console dan membuka Operasi > Pemantauan > Dasbor. Anda akan melihat bahwa ada sejumlah dasbor yang tersedia, dan dasbor untuk smart home dilengkapi dengan awalan Google Home Analytics.
Kami membuat dasbor individual untuk mewakili setiap jenis integrasi. Integrasi Cloud, Lokal, dan Matter memiliki dasbornya sendiri dan data untuk protokol streaming kamera disediakan di dasbor Kualitas Kamera. Dasbor ini hanya akan berisi data jika Anda memiliki integrasi jenis yang sesuai, beserta project yang berfungsi yang memenuhi permintaan.
Saat Anda membuka salah satu dasbor ini, tampilan yang Anda dapatkan akan terlihat seperti berikut:
Dasbor berisi berbagai diagram yang menunjukkan detail permintaan yang ditangani oleh project Anda. Dengan setiap dasbor integrasi, Anda akan melihat diagram yang menunjukkan jumlah total permintaan yang ditangani oleh project Anda, diagram yang menunjukkan tingkat keberhasilan untuk jenis integrasi tersebut, serta beberapa diagram yang menunjukkan jenis dan karakteristik perangkat yang terlibat.
Ada tiga diagram yang penting untuk menilai performa tindakan Smart Home Anda:
Selama pemadaman, Anda biasanya akan melihat tren penurunan dalam persentase keberhasilan dan tren naik dalam diagram perincian error. Memantau persentase keberhasilan eksekusi akan membantu mengetahui gangguan, sementara melihat error teratas dalam perincian error dapat membantu proses debug. Anda mungkin juga mengamati peningkatan latensi selama pemadaman, yang dapat dilihat di diagram latensi permintaan.
Perhatikan bahwa tampilan default dengan diagram yang Anda lihat di dasbor Google Home Analytics hanyalah tampilan yang kami buat untuk project Anda menggunakan data metrik smart home. Anda juga dapat menggunakan Metrics Explorer untuk membuat diagram sendiri dari metrik pokok yang sama dan menyimpannya di dasbor kustom.
Penjelajah Metrik
Metrics Explorer adalah alat untuk memvisualisasikan berbagai bagian set data project Anda. Alat ini dapat diakses di Google Cloud Console dengan membuka Operations > Monitoring > Metrics Explorer.
Google Cloud menyediakan berbagai metrik siap pakai, termasuk beberapa yang tidak terkait dengan smart home. Metrik yang kami sediakan untuk smart home tercantum di bagian resource "actions.googleapis.com/smarthome_action/...", dan mudah dicari dengan mengetik "smarthome" di kotak pilihan metrik.
Mencari "smarthome" akan menampilkan semua metrik smart home yang kami berikan ke project Anda. Anda bisa mendapatkan informasi mendetail tentang setiap metrik di halaman Pemantauan dan Logging dalam dokumentasi kami.
Dalam hal pemantauan project, metrik yang paling sederhana untuk dirujuk adalah metrik Jumlah permintaan (yang merupakan metrik delta). Metrik ini mencatat entri untuk setiap eksekusi smart home yang dimulai oleh pengguna Anda dan mencatat kolom seperti jenis perangkat, karakteristik, jenis eksekusi yang terkait dengan eksekusi, dan kolom status yang menampilkan hasilnya.
Memilih metrik ini akan menampilkan layar yang menampilkan setiap bucket data yang mirip dengan berikut ini:
Pada dasarnya, untuk setiap kombinasi label data yang ada dalam metrik ini, akan ada bucket yang mencatat perubahan (delta) antara interval waktu sebelumnya dan saat ini. Anda dapat mengelompokkan, atau memfilter bucket ini untuk mendapatkan bagian data tampilan yang diinginkan. Selain itu, data diselaraskan ke interval waktu yang dipilih dengan fungsi penyelarasan (DELTA, MEAN, MEDIAN, SUM). Kecuali jika diperlukan, Anda biasanya akan menggunakan perataan Delta dengan metrik delta.
Anda dapat membuat sebagian besar diagram yang tersedia di dasbor Google Home Analytics menggunakan Metrics Explorer dan menyimpan diagram untuk diakses nanti di dasbor kustom. Untuk mencapai tampilan yang lebih kompleks, seperti diagram rasio, Anda perlu menggunakan MQL - Monitoring Bahasa Kueri.
3. Metrik Keberhasilan
Jika berkaitan dengan pelacakan keberhasilan integrasi, Anda dapat menggunakan tingkat keberhasilan yang kami hitung dari metrik jumlah permintaan sebagai indikator dasar, atau tingkat keberhasilan untuk pendekatan yang lebih khusus.
Tingkat Berhasil
Tingkat keberhasilan dihitung untuk semua integrasi Anda dengan membagi jumlah permintaan yang berhasil dengan semua permintaan. Anda dapat mengaksesnya dari diagram Tingkat Keberhasilan Pemenuhan di Dasbor Analytics Google Home.
Diagram Tingkat Fulfillment Success sangat berguna untuk memantau performa pada project Anda, namun tidak banyak hal yang dapat berguna saat mem-build dasbor kustom atau menyiapkan pemberitahuan. Karena rasio keberhasilan berasal dari metrik jumlah permintaan Anda, dan bukan metrik itu sendiri, Anda harus membuatnya kembali menggunakan MQL (Monitoring Query Language) di Metrics Explorer untuk dapat menggunakannya dengan salah satu fitur.
Selain itu, untuk melacak gangguan performa pada project Anda, kami pikir pendekatan yang jauh lebih khusus diperlukan. Itulah sebabnya kami membuat metrik keyakinan yang berubah berdasarkan seberapa besar tingkat keberhasilan pemenuhan Anda saat ini menyimpang dari standar historis.
Metrik Keyakinan
Gangguan dapat terjadi dalam berbagai bentuk dan ukuran untuk project. Proses ini dapat berlangsung selama beberapa jam hingga beberapa menit, yang dapat menjadikan proses identifikasi sebagai tantangan. Untuk alasan ini, kami telah membuat Metrik Keyakinan dalam project Anda, yang memberikan nilai yang dinormalisasi untuk memprediksi keandalan berdasarkan performa sebelumnya. Anda dapat mengakses metrik keyakinan dengan menelusuri smarthome di penjelajah metrik, lalu memilih Keyakinan keberhasilan eksekusi.
Saat integrasi smart home Anda berperforma pada atau di atas histori performa (rata-rata 7 hari), metrik ini akan menghasilkan nilai maksimum (1,0). Jika persentase keberhasilan Anda menyimpang lebih dari 4 faktor deviasi standar (juga dihitung selama 7 hari), metrik ini akan menghasilkan nilai minimum (0,0). Untuk kasus dengan simpangan baku terlalu kecil (kurang dari 2,5%), metrik dapat didasarkan pada nilai 0,0 pada penurunan 10% pada persentase keberhasilan.
Untuk semua kasus di antaranya, metrik ini memberikan nilai antara 1,0 (sangat yakin bahwa tidak ada pemadaman layanan) dan 0,0 (keyakinan maksimum bahwa terdapat pemadaman).
Oleh karena itu, saat menyetel pemberitahuan (akan dibahas di bagian berikutnya), sebaiknya gunakan nilai 0,5 sebagai nilai minimum. Ini akan sesuai dengan 2 deviasi standar, atau penurunan 5%, mana saja yang lebih tinggi.
4. Menyiapkan Pemberitahuan
Langkah berikutnya adalah menggunakan semua yang telah Anda pelajari di bagian sebelumnya untuk menyiapkan pemberitahuan di project Anda.
Membuat Kebijakan Pemberitahuan
Pemberitahuan otomatis di Google Cloud Platform ditetapkan melalui Kebijakan Pemberitahuan. Anda dapat mengakses Kebijakan Pemberitahuan melalui menu samping, Operasi > Pemantauan > Pemberitahuan. Anda dapat membuat kebijakan pemberitahuan baru dengan memilih opsi +CREATE POLICY, yang akan mengarahkan Anda ke layar pembuatan kebijakan pemberitahuan:
Ada tiga bagian untuk membuat kebijakan pemberitahuan. Pertama, Anda harus menentukan apa yang ingin dilacak dengan menambahkan kondisi. Menekan tombol ADD CONDITION akan memunculkan jendela yang mirip dengan Metrics Explorer, dengan beberapa kontrol tambahan untuk mengonfigurasi kondisi:
Untuk target, pilih metrik keyakinan yang telah kita bahas di bagian sebelumnya. Pastikan aligner ditetapkan ke delta menggunakan metrik ini (Show Advanced Options > Aligner). Langkah berikutnya adalah mengonfigurasi kondisi pemberitahuan dan menggunakan setelan berikut:
Kondisi dipicu jika - Ini adalah konfigurasi utama untuk menentukan kapan akan memicu notifikasi. Memilih Setiap deret waktu yang melanggar akan berfungsi karena kita akan menetapkan nilai minimum pada metrik dan memantau apakah nilainya terlampaui.
Kondisi - Kita ingin pemberitahuan dipicu saat nilai turun di bawah nilai minimum sehingga kita akan menetapkannya ke di bawah. Dengan metrik kami, 1.0 berarti integrasi berfungsi dengan baik dan 0.0 menunjukkan pemadaman yang pasti.
Nilai Minimum - Kami telah membuat metrik keyakinan untuk memberikan hasil terbaik jika nilai ini ditetapkan ke 0,5. Jika Anda ingin mendapatkan peringatan yang lebih sering dan mendapatkan notifikasi untuk insiden yang lebih sedikit, Anda dapat mencoba meningkatkan nilai ini (maks 1,0). Selanjutnya jika Anda ingin berkurang pemberitahuannya, hanya untuk masalah yang lebih serius, Anda dapat mencoba mengurangi nilai ini (min 0,0).
Untuk - Ini adalah setelan untuk mengidentifikasi berapa lama gangguan dapat terjadi sebelum Anda menerima notifikasi. Sebaiknya pertahankan setelan ini pada nilai terbaru untuk mendapatkan notifikasi jika ada poin yang melintasi nilai minimum. Metrik keyakinan kami dipublikasikan setiap 15 menit, dengan melihat keberhasilan rata-rata pada periode tersebut.
Setelah selesai menambahkan kondisi, langkah berikutnya adalah memilih saluran notifikasi. Metode notifikasi yang paling sederhana adalah notifikasi email. Anda dapat memilih email yang tercantum di dropdown Saluran Notifikasi:
Jika Anda mencentang opsi Beri tahu saat penutupan, akan ada notifikasi lain yang dikirim setelah insiden ditandai sebagai ditutup. Dalam hal ini, Anda juga harus memilih Durasi penutupan otomatis insiden, yang ditetapkan secara default 7 hari.
Langkah terakhir adalah memberi pemberitahuan pada pemberitahuan, dan menambahkan dokumentasi yang ingin disertakan dalam notifikasi.
Sebaiknya berikan dokumentasi, terutama jika bukan Anda yang akan menerima notifikasi tersebut. Menambahkan langkah-langkah seperti tempat memeriksa selama insiden berlangsung dan cara melakukan triase serta debug dapat membantu selama pemadaman. Anda dapat membaca Panduan Pemecahan Masalah kami jika diperlukan.
Setelah disimpan, kebijakan pemberitahuan Anda akan dicantumkan di bagian Kebijakan di halaman Pemberitahuan.
5. Mengurangi Gangguan
Setelah menyiapkan pemberitahuan, Anda akan menerima notifikasi selama pemadaman dari saluran notifikasi yang Anda berikan, serta entri insiden akan dibuat di halaman Pemberitahuan.
Menerima Pemberitahuan
Saluran pemberitahuan yang kami berikan dalam codelab ini adalah email. Setelah menetapkannya, semoga Anda tidak menerima pemberitahuan apa pun (tidak mengalami gangguan), tetapi jika Anda melakukannya, notifikasi akan terlihat seperti berikut:
Perhatikan bahwa notifikasi pemberitahuan memberikan nilai yang diamati melampaui batas yang Anda tentukan, serta stempel waktu yang menguraikan kapan insiden pertama kali dimulai.
Memantau Insiden
Saat insiden terjadi, insiden tersebut juga akan dihitung di bagian insiden di halaman Pemberitahuan.
Anda dapat mengklik insiden tertentu untuk melihat detail tentang pemadaman layanan, seperti berapa lama durasinya atau seberapa parah gangguan terjadi.
Ingat, saat Anda menerima notifikasi, langkah pertama yang terbaik adalah melihat metrik, lalu menelusuri error yang menyebabkan pemadaman layanan di log Anda. Anda dapat mengingat kembali cara melakukannya di codelab Men-debug Smart Home kami.
6. Selamat
Selamat! Anda telah berhasil mempelajari cara menyiapkan pemberitahuan menggunakan metrik yang disediakan untuk project Anda untuk memantau gangguan secara otomatis dan mendapatkan notifikasi selama gangguan layanan.
Langkah berikutnya
Dari Codelab ini, coba latihan berikut dan jelajahi resource tambahan:
- Anda dapat menggabungkan hal yang telah dipelajari dalam codelab ini dengan metrik lain yang disediakan untuk project Anda. Anda dapat melihat daftar lengkap metrik yang tersedia di bagian Metrik yang Didukung di halaman Pemantauan.
- Pelajari jenis saluran notifikasi lainnya untuk pemberitahuan yang dijelaskan di halaman Opsi Notifikasi pada dokumentasi Google Cloud Platform.