Antipola: Mengonfigurasi kuota yang tidak terdistribusi

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

Apigee Edge menyediakan kemampuan untuk mengonfigurasi jumlah permintaan yang diizinkan ke Proxy API untuk jangka waktu tertentu menggunakan kebijakan Kuota.

Antipola

Permintaan proxy API dapat ditayangkan oleh satu atau beberapa komponen Edge terdistribusi yang disebut Pemroses Pesan. Jika ada beberapa Pemroses Pesan yang dikonfigurasi untuk menayangkan permintaan API, kuota kemungkinan akan terlampaui karena setiap Pemroses Pesan menyimpan "jumlah" permintaan yang diprosesnya sendiri.

Mari kita jelaskan hal ini dengan bantuan contoh. Pertimbangkan kebijakan Kuota berikut untuk proxy API:

<!-- /antipatterns/examples/1-6.xml -->
<Quota name="CheckTrafficQuota">
  <Interval>1</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="100"/>
</Quota>

Konfigurasi di atas akan mengizinkan total 100 permintaan per jam.

Namun, dalam praktiknya, saat beberapa pemroses pesan menayangkan permintaan API, hal berikut akan terjadi:

Dalam ilustrasi di atas:

  • Kebijakan kuota dikonfigurasi untuk mengizinkan 100 permintaan per jam.
  • Permintaan ke Proxy API ditayangkan oleh dua Pemroses Pesan.
  • Setiap Pemroses Pesan mempertahankan variabel jumlah kuotanya sendiri, quota_count_mp1 dan quota_count_mp2, untuk melacak jumlah permintaan yang diprosesnya.
  • Oleh karena itu, setiap Pemroses Pesan akan mengizinkan 100 permintaan API secara terpisah. Efek bersihnya adalah total 200 permintaan diproses, bukan 100 permintaan.

Dampak

Situasi ini mengalahkan tujuan konfigurasi kuota dan dapat berdampak buruk pada server backend yang menayangkan permintaan.

Server backend dapat:

  • Mengalami tekanan karena traffic masuk yang lebih tinggi dari yang diperkirakan
  • Menjadi tidak responsif terhadap permintaan API baru yang menyebabkan error 503

Praktik Terbaik

Pertimbangkan untuk menetapkan elemen <Distributed> ke true dalam kebijakan Kuota untuk memastikan bahwa penghitung umum digunakan untuk melacak permintaan API di semua Pemroses Pesan. Elemen <Distributed> dapat ditetapkan seperti yang ditunjukkan dalam cuplikan kode di bawah:

<!-- /antipatterns/examples/1-7.xml -->
<Quota name="CheckTrafficQuota">
  <Interval>1</Interval>
  <TimeUnit>hour</TimeUnit>
  <Distributed>true</Distributed>
  <Allow count="100"/>
</Quota>