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

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

เอกสารนี้อธิบายวิธีกำหนดค่าระยะหมดเวลาการเชื่อมต่อสำหรับ Message Processor ของ Apigee Edge

ระยะหมดเวลาการเชื่อมต่อแสดงถึงระยะเวลาที่ Message Processor รอสร้าง การเชื่อมต่อกับเซิร์ฟเวอร์เป้าหมาย ค่าเริ่มต้นของพร็อพเพอร์ตี้ระยะหมดเวลาการเชื่อมต่อใน Message Processor คือ 3 วินาที ระยะหมดเวลานี้ใช้ได้กับเซิร์ฟเวอร์แบ็กเอนด์ที่กำหนดค่าในการกำหนดค่าปลายทางเป้าหมายและในนโยบาย ServiceCallout ของพร็อกซี API

คุณสามารถเพิ่มหรือลดระยะหมดเวลาการเชื่อมต่อสำหรับ Message Processor จากค่าเริ่มต้น 3 วินาทีได้ตามความต้องการ โดยกำหนดค่าได้ด้วยวิธีต่อไปนี้

  • ในพร็อกซี API
    • ในปลายทางเป้าหมาย
    • ในนโยบาย ServiceCallout
  • ใน Message Processor

พร็อพเพอร์ตี้ต่อไปนี้จะควบคุมระยะหมดเวลาการเชื่อมต่อใน Message Processor

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

นี่คือระยะเวลาสูงสุดที่ Message Processor รอเชื่อมต่อกับเซิร์ฟเวอร์เป้าหมาย

โดยค่าเริ่มต้น พร็อพเพอร์ตี้นี้จะใช้ค่าที่ตั้งไว้สำหรับ HTTPClient.connect.timeout.millis พร็อพเพอร์ตี้ใน Message Processor ซึ่งค่าเริ่มต้นคือ 3 วินาที

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

HTTPClient.connect.timeout.millis Message Processor

นี่คือระยะเวลาสูงสุดที่ Message Processor รอเชื่อมต่อกับเซิร์ฟเวอร์เป้าหมาย

พร็อพเพอร์ตี้นี้ใช้สำหรับพร็อกซี API ทั้งหมดที่ทำงานใน Message Processor นี้

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

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

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

โปรดตรวจสอบว่าคุณเข้าใจหัวข้อต่อไปนี้ก่อนที่จะใช้ขั้นตอนในเอกสารนี้

การกำหนดค่าระยะหมดเวลาการเชื่อมต่อในพร็อกซี API

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

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

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

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

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

    ตัวอย่างเช่น หากต้องการเปลี่ยนระยะหมดเวลาการเชื่อมต่อเป็น 5 วินาที ให้เพิ่ม บล็อกโค้ดต่อไปนี้: 

    <Properties>
  <Property name="connect.timeout.millis">5000</Property>
</Properties>

    เนื่องจากพร็อพเพอร์ตี้ connect.timeout.millis เป็นมิลลิวินาที ค่าสำหรับ 5 วินาทีจึงเป็น 5000

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

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

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

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

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

การกำหนดค่าระยะหมดเวลาการเชื่อมต่อในนโยบาย ServiceCallout ของพร็อกซี API

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

วิธีกำหนดค่าระยะหมดเวลาการเชื่อมต่อในนโยบาย ServiceCallout โดยใช้พร็อพเพอร์ตี้ connect.timeout.millis

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

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

    <Properties>
  <Property name="connect.timeout.millis">5000</Property>
</Properties>

    เนื่องจากพร็อพเพอร์ตี้ connect.timeout.millis เป็นมิลลิวินาที ค่าสำหรับ 5 วินาทีจึงเป็น 5000

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

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

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

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

    <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="connect.timeout.millis">5000</Property>
    </Properties>
  <Path>/test</Path>
  </HTTPTargetConnection>
</ServiceCallout>
  4. บันทึกการเปลี่ยนแปลงที่ทำกับพร็อกซี API

การกำหนดค่าระยะหมดเวลาการเชื่อมต่อใน Message Processor

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

วิธีกำหนดค่าระยะหมดเวลาการเชื่อมต่อใน Message Processor

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

    ตัวอย่างเช่น หากต้องการเปิดไฟล์โดยใช้ vi, ให้ป้อนคำสั่งต่อไปนี้ 

    vi /opt/apigee/customer/application/message-processor.properties
  2. เพิ่มบรรทัดในรูปแบบต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้ โดยแทนที่ TIME_IN_MILLISECONDS ด้วยค่า 
    conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS

    ตัวอย่างเช่น หากต้องการเปลี่ยนระยะหมดเวลาการเชื่อมต่อใน Message Processor เป็น 5 วินาที ให้เพิ่มบรรทัดต่อไปนี้ 

    conf_http_HTTPClient.connect.timeout.millis=5000
  3. บันทึกการเปลี่ยนแปลง
  4. ตรวจสอบว่าไฟล์พร็อพเพอร์ตี้เป็นของผู้ใช้ apigee ดังที่แสดงด้านล่าง 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. รีสตาร์ท Message Processor ดังที่แสดงด้านล่าง 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. หากมี Message Processor มากกว่า 1 รายการ ให้ทำซ้ำขั้นตอนข้างต้นใน Message Processors ทั้งหมด

การยืนยันระยะหมดเวลาการเชื่อมต่อใน Message Processor

ส่วนนี้อธิบายวิธียืนยันว่ามีการแก้ไขระยะหมดเวลาการเชื่อมต่อใน Message Processor เรียบร้อยแล้ว

แม้ว่าคุณจะใช้โทเค็น conf_http_HTTPClient.connect.timeout.millis เพื่อตั้งค่า ระยะหมดเวลาการเชื่อมต่อใน Message Processor แต่คุณต้องยืนยันว่ามีการตั้งค่าพร็อพเพอร์ตี้จริง HTTPClient.connect.timeout.millis ด้วยค่าใหม่

  1. ในเครื่อง Message Processor ให้ค้นหาพร็อพเพอร์ตี้ HTTPTransport.connect.timeout.millis ในไดเรกทอรี /opt/apigee/edge-message-processor/conf และตรวจสอบว่ามีการ ตั้งค่าด้วยค่าใหม่ดังที่แสดงด้านล่างหรือไม่ 
    grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
  2. หากตั้งค่าระยะหมดเวลาการเชื่อมต่อใหม่ใน Message Processor สำเร็จ คำสั่งด้านบนจะแสดงค่าใหม่ในไฟล์ http.properties

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

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

    ในเอาต์พุตตัวอย่างด้านบน โปรดสังเกตว่ามีการตั้งค่าพร็อพเพอร์ตี้ HTTPClient.connect.timeout.millis ด้วยค่าใหม่ 5000 ใน http.properties ซึ่งบ่งชี้ว่ามีการกำหนดค่าระยะหมดเวลาการเชื่อมต่อเป็น 5 วินาทีใน Message Processor สำเร็จ

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