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 menampilkan contoh pemberitahuan:

Notifikasi untuk kode respons 200 yang tidak ada selama 5 menit

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

Untuk membuat pemberitahuan:

  1. Buka dasbor Create alerting 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 jika opsi ini tidak dipilih.

  4. Pilih metrik sebagai berikut:
    1. Salin dan tempel 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 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 Konfigurasikan pemicu di panel kiri terlebih dahulu. Kemudian, lakukan langkah-langkah berikut:

  1. Di bagian Condition type, pilih Metric absence.
  2. Di kolom Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
  3. Di kolom Metric absence time, pilih 5 min.
  4. Atau, di kolom Condition name, 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 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 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 membuatnya.

    Setelah memilih satu atau beberapa saluran notifikasi, klik OK.

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

Notifikasi 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 alerting 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 jika opsi ini tidak dipilih.

  4. Pilih metrik sebagai berikut:
    1. Salin dan tempel 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 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 di panel sebelah kiri terlebih dahulu. Kemudian, lakukan langkah-langkah berikut:

  1. Di bagian Jenis kondisi, pilih Batas.
  2. Di kolom Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
  3. Di kolom Threshold position, pilih Above threshold.
  4. Di kolom Nilai minimum, masukkan 60.

Alasan Anda menetapkan Threshold value ke 60 (bukan 3600) adalah karena unit Threshold value adalah per detik. Jadi, jika nilai minimum ini dipertahankan selama 1 menit, akan ada minimal 3.600 permintaan dalam periode 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 mengikuti langkah-langkah di Menetapkan notifikasi untuk pemberitahuan.

Notifikasi latensi

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

Membuat pemberitahuan menggunakan Apigee atau Apigee hybrid v1.12

Untuk membuat pemberitahuan menggunakan Apigee:

  1. Buka dasbor Create alerting 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 jika opsi ini tidak dipilih.

  4. Pilih metrik sebagai berikut:
    1. Salin dan tempel 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, pada bagian Within each time series:
    • Di kolom Rolling window, pilih 10 min.
    • Di kolom Rolling window function, masukkan 95th percentile.

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. Buka dasbor Create alerting 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 jika opsi ini tidak dipilih.

  4. Pilih metrik sebagai berikut:
    1. Salin dan tempel kode berikut di kolom Select a metric: 
      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 Nilai, ketik 95.
    5. Klik Terapkan.
  6. Di panel Transform data, pada 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 Batas.
  2. Di kolom Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
  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 nilai minimum 600 md.

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

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