Pemecahan masalah error runtime kebijakan Penahanan Lonjakan

Anda sedang melihat dokumentasi Apigee dan Apigee hybrid.
Lihat dokumentasi Apigee Edge.

InvalidMessageWeight

Kode error

policies.ratelimit.InvalidMessageWeight

Isi respons error

{
    "fault": {jdoe
        "faultstring": "Invalid message weight value [invalid_value]",
        "detail": {
            "errorcode": "policies.ratelimit.InvalidMessageWeight"
        }
    }
}

Contoh Pesan Error

{
    "fault": {
        "faultstring": "Invalid message weight value 1.5",
        "detail": {
            "errorcode": "policies.ratelimit.InvalidMessageWeight"
        }
    }
}

Penyebab

Error ini terjadi jika nilai yang ditentukan untuk elemen <MessageWeight> melalui variabel alur tidak valid (nilai non-bilangan bulat).

Misalnya, jika nilai variabel flow yang ditentukan untuk elemen <MessageWeight> adalah 1,5 (nilai non-bilangan bulat), error akan terjadi.

Diagnosis

  1. Identifikasi nilai yang tidak valid yang digunakan untuk elemen <MessageWeight> dalam kebijakan Spike Arrest. Anda dapat menemukan informasi ini di elemen faultstring dari respons error. Misalnya, dalam error berikut, nilai yang tidak valid yang digunakan untuk elemen <MessageWeight> adalah 1.5:

    "faultstring": "Invalid message weight value 1.5"

  2. Periksa semua kebijakan Spike Arrest di Proxy API tertentu tempat kegagalan terjadi. Mungkin ada satu atau beberapa kebijakan Spike Arrest yang menentukan elemen <MessageWeight>.

    Misalnya, kebijakan berikut menentukan nilai <MessageWeight> melalui variabel alur yang disebut message_weight:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <SpikeArrest async="false" continueOnError="false" enabled="true" name="SpikeArrest_AuthProxy">
    <DisplayName>SpikeArrest_AuthProxy</DisplayName>
    <Properties/>
    <Identifier ref="request.header.some-header-name"/>
    <Rate>100ps</Rate>
    <MessageWeight ref="message_weight"/>
</SpikeArrest>

  3. Tentukan nilai variabel yang digunakan dalam elemen <MessageWeight> dari Kebijakan Penghentian Lonjakan yang diidentifikasi. Nilai variabel alur dapat diekstrak dari header HTTP, parameter kueri, payload permintaan XML atau JSON, atau ditentukan dalam kebijakan lain.

    1. Temukan kode dalam proxy API, tempat variabel ditentukan terlebih dahulu.
    2. Setelah Anda mengetahui kebijakan tempat variabel ditentukan dan diisi terlebih dahulu, periksa cara penetapan nilai untuk variabel tersebut.
    3. Jika nilai variabel flow cocok dengan nilai yang diidentifikasi pada Langkah #1 di atas, berarti itulah penyebab error.

    Misalnya, asumsikan bahwa kebijakan JavaScript digunakan sebelum Kebijakan Penangkapan Lonjakan untuk menetapkan variabel message_weight berdasarkan metode permintaan seperti yang ditunjukkan di bawah:

    var verb = context.getVariable("request.verb");
context.setVariable("message_weight", "1.5");
if (verb == 'POST') {
  context.setVariable("message_weight", "2");
}

    Perhatikan bahwa nilai variabel message_weight adalah 1.5 yang merupakan nilai tidak valid (bukan bilangan bulat).

Resolusi

Pastikan nilai elemen MessageWeight adalah nilai yang valid (nilai bilangan bulat).

Untuk memperbaiki contoh yang ditampilkan di atas, Anda dapat mengubah nilai variabel message_weight dalam JavaScript menjadi bilangan bulat:

var verb = context.getVariable("request.verb");
context.setVariable("message_weight", "1");
if (verb == 'POST') {
  context.setVariable("message_weight", "2");
}

FailedToResolveSpikeArrestRate

Kode error

policies.ratelimit.FailedToResolveSpikeArrestRate

Isi respons error

{
    "fault": {
        "faultstring": "Failed to resolve Spike Arrest Rate reference [reference] in SpikeArrest policy [api_policy]",
        "detail": {
            "errorcode": "policies.ratelimit.FailedToResolveSpikeArrestRate"
        }
    }
}

Contoh Pesan Error

{
    "fault": {
        "faultstring": "Failed to resolve Spike Arrest Rate reference request.header.rate in SpikeArrest policy SpikeArrest_AuthProxy",
        "detail": {
            "errorcode": "policies.ratelimit.FailedToResolveSpikeArrestRate"
        }
    }
}

Penyebab

Error ini terjadi jika referensi ke variabel yang berisi setelan tarif dalam elemen <Rate> tidak dapat di-resolve ke nilai dalam kebijakan Penghentian Lonjakan. Elemen ini bersifat wajib dan digunakan untuk menentukan tingkat penangkapan lonjakan dalam bentuk {int}pm atau {int}ps. Misalnya, {int}pm mungkin 500pm, yang berarti 500 panggilan per menit. Demikian pula, nilai 10ps berarti 10 panggilan per detik.

Diagnosis

  1. Identifikasi kebijakan Spike Arrest tempat error terjadi dan nama referensi yang tidak dapat di-resolve dengan benar. Anda dapat menemukan kedua item ini di elemen faultstring respons error.

    Misalnya, dalam faultstring berikut, nama kebijakan adalah SpikeArrest_AuthProxy dan referensinya adalah request.header.rate:

    "faultstring": "Failed to resolve Spike Arrest Rate reference request.header.rate in SpikeArrest policy SpikeArrest_AuthProxy"

  2. Dalam XML kebijakan Spike Arrest yang gagal, pastikan nama referensi yang digunakan cocok dengan nama referensi yang diidentifikasi dalam string error (langkah #1 di atas). ** **

    Misalnya, kebijakan berikut menetapkan elemen dengan referensi bernama request.header.rate, yang cocok dengan yang ada dalam faultstring:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <SpikeArrest async="false" continueOnError="false" enabled="true" name="SpikeArrest_AuthProxy">
    <DisplayName>SpikeArrest_AuthProxy</DisplayName>
    <Properties/>
    <Identifier ref="request.header.some-header-name"/>
    <Rate ref="request.header.rate"/>
</SpikeArrest>

  3. Tentukan apakah variabel ditentukan dan tersedia dalam alur tempat kebijakan Spike Arrest dijalankan.

  4. Jika variabel adalah:

    • di luar cakupan (tidak tersedia dalam alur tertentu tempat kebijakan dijalankan) atau
    • tidak dapat diselesaikan (tidak ditentukan)

    maka itulah penyebab error.

    Pada contoh yang ditampilkan di atas, nilai rasio penangkapan lonjakan di elemen <Rate> seharusnya diambil dari header permintaan bernama rate. Namun, Apigee tidak dapat me-resolve request.header.rate. Hal ini terjadi jika header rate tidak diteruskan sebagai bagian dari permintaan API.

    Berikut adalah contoh permintaan API yang tidak meneruskan header rate sebagai bagian dari permintaan:

      curl -v http://your_host_alias/check_spikearrest -H "Content-Type: application/json"

    Dengan your_host_alias adalah domain yang ditampilkan secara publik yang digunakan untuk mengakses API Anda, seperti yang dikonfigurasi dalam properti virtualhosts.hostAliases di file penggantian Anda. Lihat Menentukan penggantian konfigurasi.

    Karena header rate tidak diteruskan sebagai bagian dari permintaan, referensi request.header.rate yang digunakan dalam elemen <Rate> dalam kebijakan Spike Arrest di atas tidak ditentukan sehingga tidak dapat di-resolve. Jadi, Anda akan menerima kode error:

    policies.ratelimit.FailedToResolveSpikeArrestRate

Resolusi

Pastikan variabel yang dirujuk dalam elemen <Rate> ada/ditentukan dan tersedia dalam alur tertentu, tempat kebijakan Spike Arrest dijalankan.

Untuk memperbaiki contoh yang ditampilkan di atas, Anda dapat mengubah permintaan untuk menyertakan header rate seperti yang ditunjukkan di bawah:

curl -v  http://your_host_alias/check_spikearrest -H "Content-Type: application/json" -H "rate:30ps"

Dengan your_host_alias adalah domain yang ditampilkan secara publik yang digunakan untuk mengakses API Anda, seperti yang dikonfigurasi dalam properti virtualhosts.hostAliases di file penggantian Anda. Lihat Menentukan penggantian konfigurasi.