Membuat pemberitahuan anomali

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Apigee memungkinkan Anda membuat pemberitahuan yang dipicu oleh pola traffic API tertentu— misalnya, saat rasio error API mencapai nilai minimum yang telah ditentukan. AAPI Ops memperluas kemampuan ini dengan notifikasi anomali, yang dipicu setiap kali Apigee mendeteksi data traffic API yang tidak biasa. Keuntungan pemberitahuan anomali adalah Anda tidak perlu menentukan kondisi yang tepat untuk setiap anomali sendiri. AAPI Ops menentukan kondisi anomali yang tepat menggunakan metode statistik, dan terus memperbaruinya berdasarkan data traffic terbaru. Dengan menggunakan deteksi anomali, Anda mengizinkan Apigee mendeteksi masalah traffic dan performa, bukan menentukan kondisi pemberitahuan sendiri.

Penting: "Anomaly Detection" menjelaskan fungsi Advanced API Operations Anomaly Detection, yang tersedia di UI Apigee Klasik. Fungsi ini sebanding dengan fungsi "Anomali Operasi" di UI Apigee di Cloud Console. Keduanya tersedia saat ini. Lihat Ringkasan Anomali Operasi untuk mengetahui informasi tentang fungsi Anomali Operasi.

Saat mendeteksi anomali, AAPI-Ops akan menampilkan peristiwa di dasbor Peristiwa Anomali. Namun, tindakan ini tidak otomatis memunculkan pemberitahuan untuk anomali. Jika Anda memeriksa anomali di dasbor dan memutuskan bahwa Anda ingin mendapatkan pemberitahuan tentang peristiwa serupa di masa mendatang, Anda dapat membuat pemberitahuan anomali dan menyiapkan notifikasi, yang akan mengirimkan pesan kepada Anda setiap kali anomali terdeteksi.

Sebelum membuat pemberitahuan anomali, pastikan Anda telah diberi peran yang diperlukan untuk AAPI Ops.

Untuk membuat pemberitahuan anomali di dasbor Kebijakan pemberitahuan, lakukan tindakan berikut:

1. Buka dasbor Create alerting policy di konsol Google Cloud.

   Catatan: Buka dasbor Buat kebijakan pemberitahuan di tab baru jika Anda ingin mengikuti langkah-langkah di bawah.

2. Klik TAMBAHKAN KONDISI. Tindakan ini akan membuka jendela baru tempat Anda dapat menambahkan kondisi pemberitahuan.

   

3. Opsional: Tambahkan judul untuk kondisi di kolom Untitled Condition. Kita akan membiarkannya kosong untuk contoh ini, dengan demikian kondisi akan diberi judul default.

4. Di kolom Find resource type and metric, ketik

   anomaly

   lalu pilih Jumlah peristiwa anomali Apigee.

   

5. Klik TAMPILKAN SETELAN LANJUTAN dan di panel Advanced Aggregation, pilih delta di kolom Aligner. Ini menentukan cara data digabungkan selama setiap jangka waktu, yang dapat Anda tetapkan di kolom Period. Dengan setelan delta, nilai gabungan sama dengan nilai data akhir dalam jangka waktu dikurangi nilai data awal.

   

6. Di panel Configuration, tetapkan Threshold ke 0.5. (Angka apa pun antara 0 dan 1 akan berfungsi untuk nilai minimum.) Dengan nilai ini, satu anomali akan melebihi nilai minimum dan memicu pemberitahuan.

   

7. Klik Tambahkan. Tindakan ini akan mengarahkan Anda kembali ke halaman Buat kebijakan pemberitahuan tempat Anda dapat melihat kondisi yang baru saja dibuat.

   

Pada tahap ini, Anda dapat memilih untuk:

• Klik TAMBAHKAN Kondisi untuk membuat kondisi lain untuk pemberitahuan, atau
• Klik BERIKUTNYA untuk melanjutkan ke langkah berikutnya, tempat Anda akan memiliki opsi untuk membuat notifikasi untuk pemberitahuan, seperti yang dijelaskan di bagian berikutnya.

Jika Anda tidak ingin membuat notifikasi, klik BERIKUTNYA dua kali tanpa memasukkan apa pun untuk melewati Langkah 2 dan 3.

Klik SIMPAN untuk menyimpan pemberitahuan.

Membuat notifikasi untuk pemberitahuan

Jika ingin segera diberi tahu saat terjadi insiden, Anda dapat membuat notifikasi untuk pemberitahuan. Saat pemberitahuan dipicu, Apigee akan mengirim notifikasi kepada Anda. Anda dapat memilih salah satu saluran berikut untuk menerima notifikasi:

• Email
• PagerDuty
• Slack
• Webhook

Catatan: Saat ini, untuk menerima notifikasi, Anda harus menambahkan org ke kolom Kelompokkan menurut di pemberitahuan. Persyaratan ini akan dihapus dalam rilis mendatang.

Untuk membuat notifikasi pemberitahuan:

1. Jika Anda baru saja membuat pemberitahuan (seperti yang ditunjukkan dalam contoh sebelumnya) dan saat ini melihat dasbor Create alerting policy, lanjutkan ke langkah berikutnya.

   Jika tidak, buka panel Kebijakan di dasbor Pemberitahuan konsol Cloud, dan di baris untuk pemberitahuan yang Anda buat, klik ikon tiga titik di akhir baris, lalu pilih Edit.

   

   Tindakan ini akan membuka dasbor Edit kebijakan pemberitahuan:

   

2. Di bagian Apa yang ingin Anda lacak?, klik BERIKUTNYA.

   

3. Di bagian Who should be notified, pilih Notification Channels, tempat Anda dapat memilih dari saluran yang ada untuk menerima notifikasi.

   Jika Anda ingin membuat saluran notifikasi baru, pilih KELOLA SALURAN NOTIFIKASI. Tindakan ini akan membuka dasbor Saluran notifikasi di Cloud Console, tempat Anda dapat menambahkan saluran. Lihat Membuat dan mengelola saluran notifikasi untuk mengetahui detail selengkapnya.

4. Klik NEXT. Tindakan ini akan menampilkan opsi yang ditampilkan di bawah.

   
5. Di kolom Nama pemberitahuan, masukkan nama untuk pemberitahuan.
6. Di kolom Dokumentasi, masukkan URL untuk halaman web yang memberikan informasi tentang cara memperbaiki masalah yang menyebabkan pemberitahuan. URL akan disertakan dalam notifikasi.
7. Klik Simpan untuk membuat pemberitahuan.

Saat pemberitahuan dipicu, Anda akan menerima notifikasi yang memberikan ringkasan insiden dan waktu terjadinya. Notifikasi ini juga berisi dua link untuk membantu Anda menyelidiki insiden:

• LIHAT INSIDEN: Melihat insiden di Cloud Console.
• LIHAT DI APIGEE: Lihat grafik linimasa traffic API dan tabel data terkait di dasbor Investigasi Pemantauan API.