Cara kerja deteksi anomali

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Deteksi anomali terdiri dari tiga fase utama:

Melatih model

Deteksi anomali bekerja dengan melatih model perilaku proxy API Anda dari data deret waktu historis. Anda tidak perlu melakukan tindakan apa pun untuk melatih model ini. Edge secara otomatis membuat dan melatih model untuk Anda dari data traffic selama enam jam sebelumnya. Oleh karena itu, Edge memerlukan data minimum enam jam pada proxy API untuk melatih model sebelum dapat mencatat anomali.

Mencatat peristiwa anomali ke dalam log

Saat runtime, deteksi anomali Edge membandingkan perilaku proxy API Anda saat ini dengan perilaku yang diprediksi oleh model. Deteksi anomali kemudian dapat menentukan, dengan nilai minimum keyakinan tertentu, kapan metrik operasional melebihi nilai yang diprediksi. Misalnya, saat tingkat error 5xx melebihi tingkat yang diprediksi oleh model.

Saat Edge mendeteksi kondisi anomali, Edge akan otomatis mencatat kondisi tersebut ke dasbor Peristiwa di UI Edge. Untuk setiap anomali yang terdeteksi, Edge akan mencatat batas keyakinan sedikit, sedang, atau berat. Misalnya, anomali yang parah adalah anomali yang dianggap tidak wajar dengan tingkat keyakinan yang sangat tinggi.

Daftar peristiwa yang ditampilkan di dasbor Peristiwa mencakup semua anomali yang terdeteksi oleh Edge dan semua pemberitahuan yang dipicu. Notifikasi tersebut dapat berupa notifikasi tetap atau anomali.

Untuk melihat anomali:

  1. Klik Analyze > Events di UI Edge. Dasbor Peristiwa baru akan muncul: Melihat peristiwa anomali di dasbor Peristiwa
  2. Filter dasbor Peristiwa menurut:
    • Lingkungan
    • Region
    • Jenis peristiwa sebagai Pemberitahuan (tetap dan anomali) atau Anomali
    • Ambang batas anomali (khusus anomali)
    • Jangka waktu

Untuk melihat perincian anomali:

  1. Pilih baris untuk anomali di dasbor Peristiwa untuk membuka anomali di dasbor API Monitoring Investigasi. Pada contoh di bawah, Anda menyelidiki anomali untuk sedikit peningkatan pada latensi p90. Bilah kuning vertikal menunjukkan tempat anomali terjadi:

    Menyelidiki peristiwa anomali
  2. Pilih blok di layar untuk melihat detail anomali:

    Lihat detail anomali
  3. Pilih Masukan: Seberapa akurat anomali ini untuk memberikan masukan ke Apigee guna membantu meningkatkan deteksi anomali. Gunakan link ini untuk menentukan apakah pola traffic merupakan anomali yang sebenarnya, seberapa berguna deteksi tersebut bagi Anda, dan untuk memberikan komentar opsional:

    Mengirim masukan anomali

Membuat pemberitahuan

Secara default, Edge menghasilkan peristiwa anomali, tetapi tidak memunculkan pemberitahuan anomali. Anda dapat memeriksa dasbor Peristiwa untuk menentukan apakah anomali yang terdeteksi, pada nilai minimum yang dihitung, adalah masalah yang sebenarnya. Jika demikian, Anda dapat membuat pemberitahuan untuk kondisi anomali tersebut pada tingkat ambang batas saat ini atau yang berbeda. Saat anomali berikutnya terjadi, Edge akan memunculkan pemberitahuan, dan kemudian dapat mengirimi Anda email atau jenis notifikasi lainnya.

Catatan: Setelah memunculkan pemberitahuan, Edge tidak menampilkan lagi pemberitahuan yang sama hingga 10 menit berlalu dan kondisi pemberitahuan masih ada. Interval ini mencegah Edge memunculkan pemberitahuan duplikat untuk kondisi yang sama.

Untuk membuat pemberitahuan anomali:

  1. Pilih anomali di dasbor Peristiwa untuk melihat detail anomali seperti yang ditunjukkan di atas.
  2. Pilih tombol Buat Notifikasi di detail anomali. Panel buat pemberitahuan akan terbuka.
  3. Konfigurasikan pemberitahuan. Dalam contoh berikut, Anda mengonfigurasi pemberitahuan untuk sedikit peningkatan latensi p90 untuk lingkungan prod di region mana pun:

    Mengonfigurasi pemberitahuan anomali

  4. Klik + Notifikasi untuk menambahkan notifikasi.

    Detail Notifikasi Deskripsi
    Channel Pilih saluran notifikasi yang ingin Anda gunakan dan tentukan tujuannya: Email, Slack, PagerDuty, atau Webhook.
    Destination

    Tentukan tujuan berdasarkan jenis saluran yang dipilih:

    • Email - Alamat email, seperti joe@company.com
    • Slack - URL saluran Slack, seperti https://hooks.slack.com/services/T00000000/B00000000/XXXXX
    • PagerDuty - Kode PagerDuty, seperti abcd1234efgh56789
    • Webhook - URL Webhook, seperti https://apigee.com/test-webhook

    Catatan: Anda hanya dapat menentukan satu tujuan per notifikasi. Guna menentukan beberapa tujuan untuk jenis saluran yang sama, tambahkan notifikasi lainnya.

  5. Untuk menambahkan notifikasi lainnya, ulangi langkah 4.
  6. Jika Anda menambahkan notifikasi, tetapkan kolom berikut:
    Kolom Deskripsi
    Gas Frekuensi yang digunakan untuk mengirimkan notifikasi. Pilih nilai dari menu drop-down.
  7. Klik Simpan.

    Anda akan menerima notifikasi saat anomali terjadi lagi.