Contoh peringatan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Apigee memungkinkan Anda membuat pemberitahuan kompleks berdasarkan beberapa kondisi. Bagian berikut menampilkan contoh pemberitahuan:

• Peringatan 5 menit untuk tidak ada kode respons 200
• Notifikasi lonjakan traffic
• Notifikasi latensi

Notifikasi jika tidak ada kode respons 200 selama 5 menit

Contoh berikutnya akan membuat pemberitahuan saat tidak ada kode respons 200 (permintaan yang berhasil) selama 5 menit.

Catatan: Notifikasi ini akan dipicu jika tidak ada traffic API sama sekali selama 5 menit, yang mungkin tidak diinginkan. Jika demikian, pertimbangkan menggunakan interval waktu yang lebih lama yang biasanya akan menampilkan sejumlah traffic.

Untuk membuat pemberitahuan:

1. Buka Buat dasbor kebijakan pemberitahuan di Konsol Google Cloud.

2. Klik Pilih Metrik.
3. Batalkan pilihan tombol Active.

   Catatan: Jika tidak ada data traffic API terbaru di organisasi Anda, metrik pada langkah berikutnya tidak akan ditampilkan kecuali jika opsi ini tidak dipilih.

4. Pilih metrik sebagai berikut:
   1. Salin dan tempel nilai berikut di kolom Pilih metrik:

      apigee.googleapis.com/proxy/response_count

      Catatan: Jika Anda menggunakan Apigee hybrid v1.10 atau v1.11, gunakan metrik berikut:

      apigee.googleapis.com/proxyv2/response_count

   2. Pilih Apigee Proxy.
   3. Di panel yang terbuka di sebelah kanan, pilih Proxy.
   4. Di panel sebelah kanan, pilih Apigee proxy response count.
   5. Klik Terapkan.
5. Tambahkan filter untuk kode respons sebagai berikut:
   1. Klik Add filter.
   2. Klik kolom Filter dan pilih response_code dari menu drop-down.
   3. Di Comparator, pilih =.
   4. Di kolom Value, ketik 200.
   5. Klik Terapkan.

Mengonfigurasi pemicu pemberitahuan

Untuk mengonfigurasi peristiwa yang memicu pemberitahuan, pertama-tama klik Konfigurasi pemicu di panel sebelah kiri. Kemudian, lakukan langkah-langkah berikut:

1. Di bagian Jenis kondisi, pilih Ketidakhadiran metrik.
2. Di kolom Alert trigger, pilih Any time series violations.
3. Di kolom Metrik waktu tidak ada, pilih 5 min.
4. Anda juga dapat memasukkan nama untuk kondisi tersebut di kolom Nama kondisi.

Dengan setelan ini, notifikasi akan dipicu saat proxy tidak terima kode respons 200 selama 5 menit.

Klik Next untuk membuka panel Configure notifications and finalize alert.

Menyiapkan notifikasi untuk pemberitahuan

Di panel Configure notifications and finalize alert, Anda dapat menyiapkan sebuah notifikasi yang akan dikirim saat peringatan dipicu. Untuk melakukannya:

1. Klik di Notification Channels. Jika Anda sudah membuat saluran untuk notifikasi, seperti alamat email atau nomor SMS, Anda dapat memilihnya di bagian Notification Channels.

   Jika tidak, Anda perlu menambahkan saluran dengan memilih Kelola Saluran Notifikasi. Tindakan ini akan membuka panel Notification channels, tempat Anda dapat menambahkan satu atau beberapa channel. Lihat Kelola saluran notifikasi untuk informasi selengkapnya. Setelah selesai, kembali ke Konfigurasikan notifikasi dan selesaikan panel pemberitahuan.

   Catatan: Anda mungkin perlu mengklik tombol muat ulang di samping Kelola Saluran Notifikasi untuk menampilkan saluran baru setelah Anda membuatnya.

   Setelah memilih satu atau beberapa saluran notifikasi, klik Oke.

2. Di kolom Dokumentasi, Anda dapat menambahkan pesan yang akan dikirim dengan notifikasi. Misalnya, pesan mungkin menjelaskan alasan pemberitahuan, dan berisi tautan ke dokumentasi yang menjelaskan cara menanggapinya.
3. Klik Berikutnya untuk meninjau detail pemberitahuan. Jika Anda puas dengannya, Klik Create Policy untuk membuat kebijakan pemberitahuan.

Peringatan lonjakan traffic

Bagian berikut menunjukkan cara membuat pemberitahuan yang dipicu saat jumlah permintaan API selama jangka waktu 1 menit melebihi 3.600.

Untuk membuat pemberitahuan:

1. Buka Buat dasbor kebijakan pemberitahuan di Konsol Google Cloud.

2. Klik Pilih Metrik.
3. Batalkan pilihan tombol Active.

   Catatan: Jika tidak ada data traffic API terbaru di organisasi Anda, metrik pada langkah berikutnya tidak akan ditampilkan kecuali jika opsi ini tidak dipilih.

4. Pilih metrik sebagai berikut:
   1. Salin dan tempel nilai berikut di kolom Pilih metrik:

      apigee.googleapis.com/proxy/request_count

      Catatan: Jika Anda menggunakan Apigee hybrid v1.10 atau v1.11, gunakan metrik berikut:

      apigee.googleapis.com/proxyv2/request_count

   2. Pilih Apigee Proxy.
   3. Di panel yang terbuka di sebelah kanan, pilih Proxy.
   4. Di panel sebelah kanan, pilih Jumlah permintaan proxy Apigee.
   5. Klik Terapkan.
5. Di panel Transform data:
   • Di bagian Dalam setiap deret waktu:
     • Di kolom Rolling window, pilih 1 min.
     • Di Rolling window function, pilih rate.
   • Di bagian Di seluruh deret waktu, di bagian Agregasi deret waktu, pilih sum.

Mengonfigurasi pemicu pemberitahuan

Untuk mengonfigurasi peristiwa yang memicu pemberitahuan, klik Konfigurasi pemicu terlebih dahulu di di panel sebelah kiri. Kemudian, lakukan langkah-langkah berikut:

1. Di bagian Jenis kondisi, pilih Nilai minimum.
2. Di kolom Alert trigger, pilih Any time series violations.
3. Di kolom Threshold position, pilih Above threshold.
4. Di kolom Nilai minimum, masukkan 60.

Alasan Anda menetapkan Nilai minimum ke 60 (bukan 3.600) adalah karena satuan Nilai minimum adalah per detik. Jadi, jika nilai minimum ini dipertahankan selama 1 menit, akan ada setidaknya 3.600 permintaan dalam waktu tersebut titik.

Dengan setelan ini, peringatan akan dipicu saat jumlah total permintaan selama periode 1 menit melebihi 3.600.

Klik Next untuk membuka panel Configure notifications and finalize alert dan mengikuti langkah-langkah di Siapkan notifikasi untuk pemberitahuan.

Notifikasi latensi

Contoh berikut menunjukkan cara membuat pemberitahuan yang dipicu saat persentil ke-95 latensi rata-rata respons, selama interval 10 menit, lebih besar dari 600 md.

• Buat pemberitahuan menggunakan Apigee atau Apigee Hybrid v1.12
• Membuat pemberitahuan menggunakan Apigee Hybrid v1.10 atau v1.11

Buat pemberitahuan menggunakan Apigee atau Apigee hybrid v1.12

Untuk membuat pemberitahuan menggunakan Apigee:

1. Buka Buat dasbor kebijakan pemberitahuan di Konsol Google Cloud.

2. Klik Pilih Metrik.
3. Batalkan pilihan tombol Active.

   Catatan: Jika tidak ada data traffic API terbaru di organisasi Anda, metrik di langkah berikutnya tidak akan ditampilkan kecuali jika opsi ini tidak dipilih.

4. Pilih metrik sebagai berikut:
   1. Salin dan tempel nilai berikut di kolom Pilih metrik:

      apigee.googleapis.com/proxy/latencies

   2. Pilih Apigee Proxy.
   3. Di panel yang terbuka di sebelah kanan, pilih Proxy.
   4. Di panel sebelah kanan, pilih Apigee proxy latencies.
   5. Klik Terapkan.
5. Di panel Transform data, di bagian Dalam setiap deret waktu:
   • Di kolom Rolling window, pilih 10 min.
   • Di kolom Fungsi jendela berkelanjutan, masukkan persentil ke-95.

Lihat Membuat pemicu pemberitahuan untuk mengonfigurasi peristiwa yang memicu pemberitahuan.

Buat pemberitahuan menggunakan Apigee hybrid v1.10 atau v1.11

Untuk membuat pemberitahuan menggunakan Apigee hybrid v1.10 atau v1.11:

1. Buka Buat dasbor kebijakan pemberitahuan di Konsol Google Cloud.

2. Klik Pilih Metrik.
3. Batalkan pilihan tombol Active.

   Catatan: Jika tidak ada data traffic API terbaru di organisasi Anda, metrik di langkah berikutnya tidak akan ditampilkan kecuali jika opsi ini tidak dipilih.

4. Pilih metrik sebagai berikut:
   1. Salin dan tempel nilai berikut di kolom Pilih metrik:

      apigee.googleapis.com/proxyv2/latencies_percentile

   2. Pilih Proxy Apigee (v2).
   3. Di panel yang terbuka di sebelah kanan, pilih Proxyv2.
   4. Di panel berikutnya di sebelah kanan, pilih Persentil respons proxy Apigee.
   5. Klik Terapkan.

5. Tambahkan filter sebagai berikut:

   1. Klik Tambahkan Filter.
   2. Klik kolom Filter dan pilih persentil dari menu drop-down.
   3. Di Comparator, pilih =.
   4. Di kolom Value, ketik 95.
   5. Klik Terapkan.
6. Di panel Transform data, di bagian Dalam setiap deret waktu:
   • Di kolom Rolling window, pilih 10 min.
   • Di kolom Rolling window function, masukkan mean.

Lihat Membuat pemicu pemberitahuan untuk mengonfigurasi peristiwa yang memicu pemberitahuan.

Mengonfigurasi pemicu pemberitahuan

Untuk mengonfigurasi peristiwa yang memicu pemberitahuan, klik Konfigurasi pemicu terlebih dahulu di di panel sebelah kiri. Kemudian, lakukan langkah-langkah berikut:

1. Di bagian Jenis kondisi, pilih Nilai minimum.
2. Di kolom Alert trigger, pilih Any time series violations.
3. Di kolom Threshold position, pilih Above threshold.
4. Di kolom Nilai minimum, masukkan 600.

Dengan pengaturan ini, pemberitahuan akan dipicu saat latensi persentil ke-95 berada di atas batas 600 md.

Klik Next untuk membuka panel Configure notifications and finalize alert dan mengikuti langkah-langkah di Siapkan notifikasi untuk pemberitahuan.

Saat Anda menerima notifikasi dan klik tombol Lihat di Apigee dalam email notifikasi, dasbor Investigasi akan menampilkan grafik latensi dengan ambang batas, mirip dengan contoh yang ditunjukkan: