การแก้ปัญหาข้อผิดพลาดเกี่ยวกับรันไทม์ของนโยบาย Spike Arrest

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล

InvalidMessageWeight

รหัสข้อผิดพลาด

policies.ratelimit.InvalidMessageWeight

เนื้อหาการตอบกลับข้อผิดพลาด

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

ตัวอย่างข้อความแสดงข้อผิดพลาด

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

สาเหตุ

ข้อผิดพลาดนี้เกิดขึ้นหากค่าที่ระบุสำหรับองค์ประกอบ <MessageWeight> ผ่านตัวแปรโฟลว์ไม่ถูกต้อง (ค่าที่ไม่ใช่จำนวนเต็ม)

เช่น หากค่าของตัวแปรโฟลว์ที่ระบุสำหรับองค์ประกอบ <MessageWeight> คือ 1.5 (ค่าที่ไม่ใช่จำนวนเต็ม) ก็จะเกิดข้อผิดพลาด

การวินิจฉัย

1. ระบุค่าที่ไม่ถูกต้องที่ใช้สำหรับองค์ประกอบ <MessageWeight> ในนโยบาย Arrrest ของ Spike คุณดูข้อมูลนี้ได้ในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ในข้อผิดพลาดต่อไปนี้ ค่าที่ไม่ถูกต้องที่ใช้สำหรับองค์ประกอบ <MessageWeight> คือ 1.5

   "faultstring": "Invalid message weight value 1.5"
   

2. ตรวจสอบนโยบาย Spike Arrest ทั้งหมดในพร็อกซี API ที่เกิดข้อผิดพลาด โดยอาจมีนโยบาย Spike Arrest อย่างน้อย 1 รายการที่ระบุองค์ประกอบ <MessageWeight>

   ตัวอย่างเช่น นโยบายต่อไปนี้ระบุค่าของ <MessageWeight> ผ่านตัวแปรโฟลว์ชื่อ 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. ระบุค่าของตัวแปรที่ใช้ในองค์ประกอบ <MessageWeight> ของนโยบายการจับกุมที่เพิ่มขึ้นที่ระบุ คุณจะดึงค่าของตัวแปรโฟลว์ออกจากส่วนหัว HTTP, พารามิเตอร์การค้นหา, เพย์โหลดคำขอ XML หรือ JSON หรือกำหนดไว้ในนโยบายอื่นได้

   1. ค้นหาโค้ดภายในพร็อกซี API ที่มีการระบุตัวแปรไว้ก่อน
   2. เมื่อคุณทราบถึงนโยบายที่กำหนดและเติมค่าตัวแปรก่อนแล้ว ให้ตรวจสอบว่ามีการตั้งค่าตัวแปรอย่างไร
   3. หากค่าของตัวแปรโฟลว์ตรงกับค่าที่ระบุไว้ในขั้นตอนที่ 1 ด้านบน นั่นเป็นสาเหตุของข้อผิดพลาด

   ตัวอย่างเช่น สมมติว่ามีการใช้นโยบาย JavaScript ก่อนนโยบาย Spike Arrest เพื่อตั้งค่าตัวแปร message_weight ตามเมธอดคำขอดังที่แสดงด้านล่าง

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

   โปรดสังเกตว่าค่าของตัวแปร message_weight คือ 1.5 ซึ่งไม่ถูกต้อง (ไม่ใช่จำนวนเต็ม)

ความละเอียด

ตรวจสอบว่าค่าขององค์ประกอบ MessageWeight เป็นค่าที่ถูกต้อง (ค่าจำนวนเต็ม)

หากต้องการแก้ไขตัวอย่างที่แสดงข้างต้น ให้แก้ไขค่าของตัวแปร message_weight ใน JavaScript เป็นจำนวนเต็ม

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

FailedToResolveSpikeArrestRate

รหัสข้อผิดพลาด

policies.ratelimit.FailedToResolveSpikeArrestRate

เนื้อหาการตอบกลับข้อผิดพลาด

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

ตัวอย่างข้อความแสดงข้อผิดพลาด

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

สาเหตุ

ข้อผิดพลาดนี้เกิดขึ้นหากไม่สามารถแก้ไขการอ้างอิงไปยังตัวแปรที่มีการตั้งค่าอัตราภายในองค์ประกอบ <Rate> เป็นค่าภายในนโยบาย Spike Arrest ได้ องค์ประกอบนี้จำเป็นและใช้เพื่อระบุอัตราการจับกุมอย่างฉับพลันในรูปแบบ {int}pm หรือ {int}ps ตัวอย่างเช่น {int}pm อาจเป็น 500pm ซึ่งหมายความว่า มีการโทร 500 สายต่อนาที ในทำนองเดียวกัน ค่า 10ps หมายถึง 10 การโทรต่อวินาที

การวินิจฉัย

1. ระบุนโยบายการจับกุม Spike Arrest ที่เกิดข้อผิดพลาดและชื่อข้อมูลอ้างอิงที่ไม่สามารถแก้ไขได้อย่างเหมาะสม คุณจะพบทั้ง 2 รายการนี้ในองค์ประกอบ faultstring ของการตอบสนองข้อผิดพลาด

   ตัวอย่างเช่น ในสตริงข้อผิดพลาดต่อไปนี้ ชื่อนโยบายคือ SpikeArrest_AuthProxy และการอ้างอิงคือ request.header.rate

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

2. ใน XML ของนโยบาย Spike Arrest ที่ล้มเหลว ให้ตรวจสอบว่าชื่อของข้อมูลอ้างอิงที่ใช้ตรงกับชื่อข้อมูลอ้างอิงที่ระบุในสตริงข้อผิดพลาด (ขั้นตอนที่ 1 ด้านบน) ** **

   ตัวอย่างเช่น นโยบายต่อไปนี้จะกำหนดองค์ประกอบ ที่มีการอ้างอิงชื่อ request.header.rate ซึ่งตรงกับสิ่งที่อยู่ในสตริงข้อผิดพลาด

   <?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. ระบุว่าตัวแปรจะได้รับการกำหนดและพร้อมใช้งานในโฟลว์ที่มีการดำเนินการนโยบายการจับกุมที่เพิ่มขึ้นหรือไม่

4. กรณีที่ตัวแปรเป็นอย่างใดอย่างหนึ่งต่อไปนี้

   • อยู่นอกขอบเขต (ใช้ไม่ได้ในขั้นตอนเฉพาะเจาะจงที่มีการใช้นโยบาย) หรือ
   • แก้ไขไม่ได้ (ไม่ได้กำหนด)

   ก็จะเป็นสาเหตุของข้อผิดพลาด

   ในตัวอย่างที่แสดงข้างต้น ค่าของอัตราการจับกุมอย่างฉับพลันในองค์ประกอบ <Rate> ควรดึงมาจากส่วนหัวของคำขอที่ชื่อว่า rate แต่ Edge จะแปลค่า request.header.rate ไม่ได้ กรณีนี้จะเกิดขึ้นเมื่อระบบไม่ส่งผ่าน rate ของส่วนหัวเป็นส่วนหนึ่งของคำขอ API

   ต่อไปนี้คือตัวอย่างคำขอ API ที่ไม่ส่งอัตราส่วนหัวเป็นส่วนหนึ่งของคำขอ

       curl -v http://jdoe-eval-test.apigee.net/check_spikearrest -H "Content-Type: application/json"
   

   เนื่องจากไม่ได้ส่ง rate ของส่วนหัวเป็นส่วนหนึ่งของคำขอ การอ้างอิง request.header.rate ที่ใช้ในองค์ประกอบ <Rate> ในนโยบาย Arrest ข้างต้นจึงไม่มีการกำหนด จึงแก้ไขไม่ได้ ดังนั้นคุณจะได้รับ รหัสข้อผิดพลาด

   policies.ratelimit.FailedToResolveSpikeArrestRate
   

ความละเอียด

ตรวจสอบว่าตัวแปรที่อ้างอิงในองค์ประกอบ <Rate> มีอยู่/มีการกำหนดไว้และพร้อมใช้งานในขั้นตอนเฉพาะ ซึ่งเป็นที่ที่จะมีการใช้นโยบาย Spike Arrest อยู่

หากต้องการแก้ไขตัวอย่างที่แสดงข้างต้น ให้แก้ไขคำขอให้รวมส่วนหัว rate ดังที่แสดงด้านล่าง

curl -v  http://jdoe-eval-test.apigee.net/check_spikearrest -H "Content-Type: application/json" -H "rate:30ps"