การกําหนดค่าให้ระยะหมดเวลาของตัวประมวลผลข้อความมีผลตลอดไป

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

เอกสารนี้จะอธิบายวิธีกำหนดค่าระยะหมดเวลาของ Keep Alive สำหรับตัวประมวลผลข้อความ Apigee Edge

ระยะหมดเวลาของ Keep Alive ในตัวประมวลผลข้อความจะช่วยให้การเชื่อมต่อ TCP รายการเดียวสามารถส่งและยอมรับคำขอ/การตอบกลับ HTTP หลายรายการจาก/ไปยังเซิร์ฟเวอร์แบ็กเอนด์ แทนที่จะเปิดการเชื่อมต่อใหม่สำหรับคู่คำขอ/คำตอบทุกคู่

ค่าเริ่มต้นของพร็อพเพอร์ตี้ระยะหมดเวลาของ Keep alive ในตัวประมวลผลข้อความคือ 60 วินาที ระยะหมดเวลานี้มีผลกับเซิร์ฟเวอร์แบ็กเอนด์ที่กำหนดค่าไว้ในการกำหนดค่าปลายทางเป้าหมายและในนโยบาย ServiceCallout ของพร็อกซี API

คุณสามารถเพิ่มหรือลดระยะหมดเวลาของ Keep alive สำหรับตัวประมวลผลข้อความได้จากค่าเริ่มต้นที่เท่ากับ 60 วินาทีตามความต้องการ โดยสามารถกำหนดค่าได้ด้วยวิธีต่อไปนี้

  • ในพร็อกซี API
    • ในปลายทางเป้าหมาย
    • ในนโยบายServiceCallout
  • ในตัวประมวลผลข้อความ

พร็อพเพอร์ตี้ต่อไปนี้จะควบคุมระยะหมดเวลาของ Keep alive ในระบบประมวลผลข้อความ

ชื่อพร็อพเพอร์ตี้ ตำแหน่ง คำอธิบาย
keepalive.timeout.millis พร็อกซี API
  • ปลายทางเป้าหมาย
  • นโยบาย ServiceCallout

นี่คือเวลาที่ไม่ได้ใช้งานสูงสุดที่ตัวประมวลผลข้อความอนุญาตให้การเชื่อมต่อ TCP รายการเดียวสามารถส่งและรับคำขอ/การตอบกลับ HTTP หลายรายการ แทนที่จะเปิดการเชื่อมต่อใหม่สำหรับคู่คำขอ/คำตอบทุกคู่

โดยค่าเริ่มต้น พร็อพเพอร์ตี้นี้จะใช้ค่าที่ตั้งไว้สำหรับพร็อพเพอร์ตี้ HTTPClient.keepalive.timeout.millis ในเครื่องมือประมวลผลข้อความ ซึ่งค่าเริ่มต้นคือ 60 วินาที

หากแก้ไขพร็อพเพอร์ตี้นี้ด้วยค่าระยะหมดเวลาใหม่สำหรับเซิร์ฟเวอร์เป้าหมายที่ใช้ในปลายทางเป้าหมาย หรือนโยบาย ServiceCallout ในพร็อกซี API ที่เฉพาะเจาะจง ระบบจะส่งผลกับเวลา Keep alive เฉพาะของเซิร์ฟเวอร์เป้าหมายที่ระบุเท่านั้น

HTTPClient.keepalive.timeout.millis Message Processor

นี่คือเวลาที่ไม่ได้ใช้งานสูงสุดที่ตัวประมวลผลข้อความอนุญาตให้การเชื่อมต่อ TCP รายการเดียวสามารถส่งและรับคำขอ/การตอบกลับ HTTP หลายรายการ แทนที่จะเปิดการเชื่อมต่อใหม่สำหรับคู่คำขอ/คำตอบทุกคู่

พร็อพเพอร์ตี้นี้ใช้สำหรับพร็อกซี API ทั้งหมดที่ทำงานบนเครื่องมือประมวลผลข้อความนี้

ค่าเริ่มต้นของพร็อพเพอร์ตี้นี้คือ 60 วินาที

คุณสามารถแก้ไขพร็อพเพอร์ตี้นี้ตามที่อธิบายไว้ในการกำหนดค่าระยะหมดเวลาของ Keep Alive ในเครื่องมือประมวลผลข้อความด้านล่าง หรือเขียนทับค่านี้ได้โดยตั้งค่าพร็อพเพอร์ตี้ keepalive.timeout.millis ที่ระดับพร็อกซี API

ก่อนเริ่มต้น

ก่อนทําตามขั้นตอนในเอกสารฉบับนี้ โปรดทําความเข้าใจหัวข้อต่อไปนี้

การกำหนดค่าระยะหมดเวลาของ Keep Alive ในพร็อกซี API

คุณสามารถกำหนดค่าระยะหมดเวลาของ Keep Alive ในพร็อกซี API ได้ในที่ต่อไปนี้

  • ปลายทางเป้าหมาย
  • นโยบาย ServiceCallout

การกำหนดค่าระยะหมดเวลาของ Keep Alive ในปลายทางเป้าหมายของพร็อกซี API

หัวข้อนี้จะอธิบายวิธีกำหนดค่าระยะหมดเวลาของ Keep Alive ในปลายทางเป้าหมายของพร็อกซี API คุณกำหนดค่าระยะหมดเวลาของ Keep Alive ได้ผ่านพร็อพเพอร์ตี้ keepalive.timeout.millis ซึ่งแสดงค่าระยะหมดเวลาของ Keep Alive ในหน่วยมิลลิวินาที

  1. ใน Edge UI ให้เลือกพร็อกซี API เฉพาะที่คุณต้องการกำหนดค่าระยะหมดเวลาของ Keep alive ใหม่
  2. เลือกปลายทางเป้าหมายที่ต้องการแก้ไข

  3. เพิ่มพร็อพเพอร์ตี้ keepalive.timeout.millis ด้วยค่าที่เหมาะสมภายใต้องค์ประกอบ <HTTPTargetConnection> ในการกำหนดค่า TargetEndpoint

    เช่น หากต้องการเปลี่ยนระยะหมดเวลาของ Keep alive เป็น 30 วินาที ให้เพิ่มบล็อกโค้ดต่อไปนี้ 

    <Properties>
  <Property name="keepalive.timeout.millis">30000</Property>
</Properties>

    เนื่องจากพร็อพเพอร์ตี้ keepalive.timeout.millis อยู่ในหน่วยมิลลิวินาที ค่าสำหรับ 30 วินาทีจึงเป็น 30000

    ตัวอย่างต่อไปนี้แสดงวิธีกำหนดค่าระยะหมดเวลาของ Keep Alive ในการกำหนดค่าปลายทางเป้าหมายของพร็อกซี API

    ตัวอย่างการกำหนดค่าปลายทางเป้าหมายโดยใช้ URL สำหรับเซิร์ฟเวอร์แบ็กเอนด์ 

    <TargetEndpoint name="default">
  <HTTPTargetConnection>
    <URL>https://mocktarget.apigee.net/json</URL>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
  </HTTPTargetConnection>
</TargetEndpoint>

    ตัวอย่างการกำหนดค่าปลายทางเป้าหมายโดยใช้เซิร์ฟเวอร์เป้าหมาย 

    <TargetEndpoint name="default">
  <HTTPTargetConnection>
    <LoadBalancer>
      <Server name="target1" />
      <Server name="target2" />
    </LoadBalancer>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
    <Path>/test</Path>
  </HTTPTargetConnection>
</TargetEndpoint>
  4. บันทึกการเปลี่ยนแปลงพร็อกซี API

การกำหนดค่าระยะหมดเวลาของ Keep alive ในนโยบาย ServiceAPI ของพร็อกซี API

ส่วนนี้จะอธิบายวิธีกำหนดค่าระยะหมดเวลาของ Keep Alive ในนโยบาย ServiceCallout ของพร็อกซี API ระยะหมดเวลาของ Keep Alive สามารถกำหนดค่าผ่านพร็อพเพอร์ตี้ the keepalive.timeout.millis ได้ ซึ่งจะแสดงค่าระยะหมดเวลาของ Keep Alive ในหน่วยมิลลิวินาที

หากต้องการกำหนดค่าระยะหมดเวลาของ Keep Alive ในนโยบาย ServiceCallout โดยใช้พร็อพเพอร์ตี้ keepalive.timeout.millis ให้ทำดังนี้

  1. ใน Edge UI ให้เลือกพร็อกซี API เฉพาะที่คุณต้องการกำหนดค่าระยะหมดเวลาของ Keep alive ใหม่สำหรับนโยบาย ServiceCallout
  2. เลือกนโยบาย ServiceCallout ที่ต้องการแก้ไข
  3. เพิ่มพร็อพเพอร์ตี้ keepalive.timeout.millis ด้วยค่าที่เหมาะสมภายใต้องค์ประกอบ <HTTPTargetConnection> ในการกำหนดค่า TargetEndpoint

    เช่น หากต้องการเปลี่ยนระยะหมดเวลาของ Keep Alive เป็น 30 วินาที ให้เพิ่มบล็อกโค้ดต่อไปนี้ 

    <Properties>
  <Property name="keepalive.timeout.millis">30000</Property>
</Properties>

    เนื่องจากพร็อพเพอร์ตี้ keepalive.timeout.millis อยู่ในหน่วยมิลลิวินาที ค่าสำหรับ 30 วินาทีจึงเป็น 30000

    ตัวอย่างต่อไปนี้แสดงวิธีกำหนดค่าระยะหมดเวลาของ Keep Alive ในนโยบาย ServiceCallout ของพร็อกซี API

    ตัวอย่างการกำหนดค่านโยบาย ServiceAPI ที่ใช้ URL สำหรับเซิร์ฟเวอร์แบ็กเอนด์ 

    <ServiceCallout name="Service-Callout-1">
  <DisplayName>Service Callout-1</DisplayName>
  <HTTPTargetConnection>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
    <URL>https://mocktarget.apigee.net/json</URL>
  </HTTPTargetConnection>
</ServiceCallout>

    ตัวอย่างการกำหนดค่านโยบาย ServiceAPI โดยใช้เซิร์ฟเวอร์เป้าหมาย

    <ServiceCallout enabled="true" name="Service-Callout-1">
  <DisplayName>Service Callout-1</DisplayName>
  <Response>calloutResponse</Response>
  <HTTPTargetConnection>
    <LoadBalancer>
      <Server name="target1" />
      <Server name="target2" />
    </LoadBalancer>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
    <Path>/test</Path>
  </HTTPTargetConnection>
</ServiceCallout>
  4. บันทึกการเปลี่ยนแปลงพร็อกซี API

การกำหนดค่าระยะหมดเวลาของ Keep Alive ในตัวประมวลผลข้อความ

ส่วนนี้จะอธิบายวิธีกำหนดค่าระยะหมดเวลาของ Keep Alive ในระบบประมวลผลข้อความ คุณกำหนดค่าระยะหมดเวลาของ Keep Alive ได้ผ่านพร็อพเพอร์ตี้ HTTPClient.keepalive.timeout.millis ซึ่งแสดงค่าระยะหมดเวลาของ Keep Alive เป็นมิลลิวินาทีในคอมโพเนนต์เครื่องมือประมวลผลข้อความ เนื่องจากพร็อพเพอร์ตี้นี้มีการแสดงความคิดเห็นในตัวประมวลผลข้อความ คุณจึงต้องใช้ไวยากรณ์พิเศษ conf/http.properties+HTTPClient.keepalive.timeout.millis ตามที่อธิบายไว้ในส่วน ตั้งค่าโทเค็นที่มีการแสดงความคิดเห็นอยู่ในขณะนี้ใน วิธีกำหนดค่า Edge

หากต้องการกำหนดค่าระยะหมดเวลาของ Keep Alive ในตัวประมวลผลข้อความ ให้ทำดังนี้

  1. ในเครื่องเครื่องมือประมวลผลข้อความ ให้เปิดไฟล์ต่อไปนี้ในตัวแก้ไข หากยังไม่มี ให้สร้างขึ้นมา 
    /opt/apigee/customer/application/message-processor.properties

    ตัวอย่างเช่น หากต้องการเปิดไฟล์โดยใช้ vi ให้ป้อนข้อมูลดังนี้

    vi /opt/apigee/customer/application/message-processor.properties
  2. เพิ่มบรรทัดในรูปแบบต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้ โดยแทนที่ค่าสำหรับ TIME_IN_MILLISECONDS: 
    conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS

    เช่น หากต้องการเปลี่ยนระยะหมดเวลา Keep alive ในตัวประมวลผลข้อความเป็น 30 วินาที ให้เพิ่มบรรทัดต่อไปนี้ 

    conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
  3. บันทึกการเปลี่ยนแปลง
  4. ตรวจสอบว่าไฟล์พร็อพเพอร์ตี้เป็นของผู้ใช้ apigee ดังที่แสดงด้านล่าง 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. รีสตาร์ทโปรแกรมประมวลผลข้อความดังที่แสดงด้านล่าง 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. หากมีเครื่องมือประมวลผลข้อความมากกว่า 1 เครื่อง ให้ทำตามขั้นตอนข้างต้นซ้ำกับตัวประมวลผลข้อความทั้งหมด

กำลังยืนยันระยะหมดเวลาของ Keep Alive ในตัวประมวลผลข้อความ

หัวข้อนี้จะอธิบายวิธียืนยันว่ามีการแก้ไขระยะหมดเวลาของ Keep Alive สำเร็จแล้วในโปรแกรมประมวลผลข้อความ

แม้ว่าคุณจะใช้ไวยากรณ์พิเศษ conf/http.properties+HTTPClient.keepalive.timeout.millis เพื่อตั้งค่าระยะหมดเวลาของ Keep alive ในตัวประมวลผลข้อความ แต่คุณต้องยืนยันว่าได้ตั้งค่าพร็อพเพอร์ตี้จริง HTTPClient.keepalive.timeout.millis ด้วยค่าใหม่แล้ว

  1. ในเครื่องเครื่องมือประมวลผลข้อความ ให้ค้นหาพร็อพเพอร์ตี้ HTTPClient.keepalive.timeout.millis ในไดเรกทอรี /opt/apigee/edge-message-processor/conf และตรวจสอบว่ามีการตั้งค่าด้วยค่าใหม่ดังที่แสดงด้านล่าง 
    grep -ri "HTTPClient.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf

  2. หากกำหนดค่าระยะหมดเวลาใหม่ Keep alive ในตัวประมวลผลข้อความเรียบร้อยแล้ว คำสั่งด้านบนจะแสดงค่าใหม่ในไฟล์ http.properties

    ผลลัพธ์ตัวอย่างจากคำสั่งข้างต้นหลังจากที่คุณกำหนดค่า Keep alive ระยะหมดเวลาเป็น 30 วินาทีจะเป็นดังนี้ 

    /opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000

    ในตัวอย่างเอาต์พุตด้านบน ให้สังเกตว่ามีการตั้งค่าพร็อพเพอร์ตี้ HTTPClient.keepalive.timeout.millis ด้วยค่าใหม่ 30000 ใน http.properties ซึ่งบ่งบอกว่ากำหนดค่าระยะหมดเวลาของ Keep alive เป็น 30 วินาทีในระบบประมวลผลข้อความเรียบร้อยแล้ว

  3. หากยังเห็นค่าเดิมของพร็อพเพอร์ตี้ HTTPClient.keepalive.timeout.millis ให้ตรวจสอบว่าคุณได้ทำตามขั้นตอนทั้งหมดที่ระบุไว้ในการกำหนดค่าระยะหมดเวลาของ Keep Alive ในโปรแกรมประมวลผลข้อความอย่างถูกต้อง หากคุณพลาดขั้นตอนใด ให้ทำซ้ำขั้นตอนทั้งหมดอย่างถูกต้อง
  4. หากยังแก้ไขระยะหมดเวลาของ Keep Alive ไม่ได้ โปรดติดต่อทีมสนับสนุนของ Apigee Edge ของ Google Cloud