Contoh peringatan

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

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

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

Peringatan tanpa 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 untuk menggunakan interval waktu yang lebih lama yang biasanya Anda perkirakan akan mendapatkan traffic.

Untuk membuat pemberitahuan:

1. Buka dasbor Create alerts policy di Konsol Google Cloud.

2. Klik Select a Metric.
3. Batalkan pilihan tombol Active.

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

4. Pilih metrik sebagai berikut:
   1. Salin dan tempel teks 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 berikutnya di 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, lalu pilih response_code dari menu drop-down.
   3. Di Comparator, pilih =.
   4. Di kolom Nilai, ketik 200.
   5. Klik Terapkan.

Mengonfigurasi pemicu pemberitahuan

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

1. Di bagian Jenis kondisi, pilih Tidak ada metrik.
2. Di kolom Alert trigger, pilih Any time series violations.
3. Di kolom Ketidakhadiran metrik waktu, pilih 5 min.
4. Atau, di kolom Nama kondisi, masukkan nama untuk kondisi tersebut.

Dengan setelan ini, pemberitahuan akan dipicu saat proxy tidak menerima 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 notifikasi yang akan dikirim saat pemberitahuan dipicu. Untuk melakukannya:

1. Klik di kolom Notification Channels. Jika 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 Manage Notification Channels. Tindakan ini akan membuka panel Notification channels, tempat Anda dapat menambahkan satu atau beberapa saluran. Baca artikel Mengelola saluran notifikasi untuk mengetahui informasi lebih lanjut. Setelah selesai, kembali ke panel Configure notifications and finalize alert.

   Catatan: Anda mungkin perlu mengklik tombol muat ulang di samping Manage Notification Channels untuk menampilkan saluran baru setelah membuatnya.

   Setelah memilih satu atau beberapa saluran notifikasi, klik Oke.

2. Di kolom Documentation, Anda dapat menambahkan pesan yang akan dikirim bersama notifikasi. Misalnya, pesan tersebut mungkin menjelaskan alasan munculnya pemberitahuan, dan berisi link ke dokumentasi yang menjelaskan cara meresponsnya.
3. Klik Berikutnya untuk meninjau detail notifikasi. Jika Anda puas dengan perubahan tersebut, klik Create Policy untuk membuat kebijakan pemberitahuan.

Pemberitahuan lonjakan traffic

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

Untuk membuat pemberitahuan:

1. Buka dasbor Create alerts policy di Konsol Google Cloud.

2. Klik Select a Metric.
3. Batalkan pilihan tombol Active.

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

4. Pilih metrik sebagai berikut:
   1. Salin dan tempel teks 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 berikutnya di sebelah kanan, pilih Apigee proxy request count.
   5. Klik Terapkan.
5. Di panel Transform data:
   • Di bagian Dalam setiap deret waktu:
     • Di kolom Rolling window, pilih 1 min.
     • Di Fungsi rolling window, pilih rate.
   • Di bagian Across time series, di bagian Time series aggregation, pilih sum.

Mengonfigurasi pemicu pemberitahuan

Untuk mengonfigurasi peristiwa yang memicu pemberitahuan, klik Configure trigger terlebih dahulu 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 3600) adalah bahwa satuan Nilai minimum adalah per detik. Jadi, jika nilai minimum ini dipertahankan selama 1 menit, akan ada setidaknya 3.600 permintaan dalam jangka waktu tersebut.

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

Klik Next untuk membuka panel Configure notifications and finalize alert, lalu ikuti langkah-langkah yang tercantum dalam Set up notifikasi for the alert.

Pemberitahuan latensi

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

• Buat pemberitahuan menggunakan Apigee atau Apigee Hybrid v1.12
• Buat 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 dasbor Create alerts policy di Konsol Google Cloud.

2. Klik Select a Metric.
3. Batalkan pilihan tombol Active.

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

4. Pilih metrik sebagai berikut:
   1. Salin dan tempel teks 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. Pada panel berikutnya di sebelah kanan, pilih Apigee proxy latencies.
   5. Klik Terapkan.
5. Di panel Transform data, pada bagian Dalam setiap deret waktu:
   • Di kolom Rolling window, pilih 10 min.
   • Di kolom Rolling window function, masukkan persentil ke-95.

Lihat artikel 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 dasbor Create alerts policy di Konsol Google Cloud.

2. Klik Select a Metric.
3. Batalkan pilihan tombol Active.

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

4. Pilih metrik sebagai berikut:
   1. Salin dan tempel teks 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 Percentile of Apigee proxy response latencies.
   5. Klik Terapkan.

5. Tambahkan filter sebagai berikut:

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

Lihat artikel Membuat pemicu pemberitahuan untuk mengonfigurasi peristiwa yang memicu pemberitahuan.

Mengonfigurasi pemicu pemberitahuan

Untuk mengonfigurasi peristiwa yang memicu pemberitahuan, klik Configure trigger terlebih dahulu 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 setelan ini, pemberitahuan akan dipicu saat persentil ke-95 latensi berada di atas batas 600 milidetik.

Klik Next untuk membuka panel Configure notifications and finalize alert, lalu ikuti langkah-langkah yang tercantum dalam Set up notifikasi for the alert.

Saat Anda menerima notifikasi dan mengklik tombol View In Apigee di email notifikasi, dasbor Investigasi akan menampilkan grafik latensi dengan nilai minimum, mirip dengan contoh yang ditunjukkan: