Contoh pemberitahuan

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

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

Peringatan jika tidak ada kode respons 200 selama 5 menit

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

Untuk membuat pemberitahuan:

  1. Di konsol Google Cloud , buka halaman Monitoring > Alerting > Policies.

    Buka Buat kebijakan pemberitahuan

  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 tempelkan kode berikut di kolom Select a metric: 
      apigee.googleapis.com/proxy/response_count
    2. Pilih Apigee Proxy.
    3. Di panel yang terbuka di sebelah kanan, pilih Proxy.
    4. Di panel berikutnya di sebelah kanan, pilih Jumlah respons proxy Apigee.
    5. Klik Terapkan.
  5. Tambahkan filter untuk kode respons sebagai berikut:
    1. Klik Tambahkan 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, pertama-tama klik Konfigurasi pemicu di panel sebelah kiri. Kemudian, lakukan langkah-langkah berikut:

  1. Di bagian Jenis kondisi, pilih Tidak ada metrik.
  2. Di kolom Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
  3. Di kolom Waktu tidak adanya metrik, pilih 5 menit.
  4. Atau, di kolom Nama kondisi, masukkan nama untuk kondisi.

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 Konfigurasi notifikasi dan finalisasi pemberitahuan, Anda dapat menyiapkan notifikasi yang akan dikirim saat pemberitahuan dipicu. Untuk melakukannya:

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

    Jika tidak, Anda harus menambahkan saluran dengan memilih Kelola Saluran Notifikasi. Tindakan ini akan membuka panel Notification channels, tempat Anda dapat menambahkan satu atau beberapa saluran. Lihat Mengelola saluran notifikasi untuk mengetahui informasi selengkapnya. Setelah selesai, kembali ke panel Configure notifications and finalize alert.

    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 dapat menjelaskan alasan peringatan, dan berisi link ke dokumentasi yang menjelaskan cara meresponsnya.
  3. Klik Berikutnya untuk meninjau detail peringatan. Jika Anda puas dengan setelan tersebut, klik Buat Kebijakan untuk membuat kebijakan pemberitahuan.

Peringatan 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. Di konsol Google Cloud , buka halaman Monitoring > Alerting > Policies.

    Buka Buat kebijakan pemberitahuan

  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 tempelkan kode berikut di kolom Select a metric: 
      apigee.googleapis.com/proxy/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 Transformasi 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 di panel sebelah kiri terlebih dahulu. Kemudian, lakukan langkah-langkah berikut:

  1. Di bagian Jenis kondisi, pilih Nilai minimum.
  2. Di kolom Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
  3. Di kolom Posisi nilai minimum, pilih Di atas nilai minimum.
  4. Di kolom Nilai minimum, masukkan 60.

Alasan Anda menetapkan Threshold value ke 60 (bukan 3600) adalah karena satuan Threshold value 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 dan ikuti langkah-langkah di Menyiapkan notifikasi untuk pemberitahuan.

Pemberitahuan latensi

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

Buat pemberitahuan menggunakan Apigee atau Apigee Hybrid v1.12

Untuk membuat pemberitahuan menggunakan Apigee:

  1. Di konsol Google Cloud , buka halaman Monitoring > Alerting > Policies.

    Buka Buat kebijakan pemberitahuan

  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 tempelkan kode berikut di kolom Select a metric: 
      apigee.googleapis.com/proxy/latencies
    2. Pilih Apigee Proxy.
    3. Di panel yang terbuka di sebelah kanan, pilih Proxy.
    4. Di panel berikutnya di sebelah kanan, pilih Apigee proxy latencies.
    5. Klik Terapkan.
  5. Di panel Transform data, di bagian Within each time series:
    • Di kolom Rolling window, pilih 10 min.
    • Di kolom Rolling window function, masukkan persentil ke-95.

Lihat Membuat pemicu pemberitahuan untuk mengonfigurasi peristiwa yang memicu pemberitahuan.

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

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

  1. Di konsol Google Cloud , buka halaman Monitoring > Alerting > Policies.

    Buka Buat kebijakan pemberitahuan

  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 tempelkan kode berikut di kolom Select a metric: 
      apigee.googleapis.com/proxyv2/latencies_percentile
    2. Pilih Apigee proxy (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 Nilai, ketik 95.
    5. Klik Terapkan.
  6. Di panel Transform data, di bagian Within each time series:
    • 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 di panel sebelah kiri terlebih dahulu. Kemudian, lakukan langkah-langkah berikut:

  1. Di bagian Jenis kondisi, pilih Nilai minimum.
  2. Di kolom Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
  3. Di kolom Posisi nilai minimum, pilih Di atas nilai minimum.
  4. Di kolom Nilai minimum, masukkan 600.

Dengan setelan ini, pemberitahuan akan dipicu saat latensi persentil ke-95 berada di atas nilai minimum 600 md.

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

Saat Anda menerima notifikasi dan mengklik tombol Lihat di Apigee di email notifikasi, dasbor Selidiki akan menampilkan grafik latensi dengan nilai minimum, mirip dengan contoh yang ditampilkan: Pilih metrik.