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

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

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

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

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

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

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

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

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

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

• หากไม่คุ้นเคยกับระยะหมดเวลาของการเชื่อมต่อ โปรดดูคำอธิบายพร็อพเพอร์ตี้ connect.timeout.millis ใน ข้อกำหนดพร็อพเพอร์ตี้การนำส่งของ TargetEndpoint
• หากไม่คุ้นเคยกับการกำหนดค่าพร็อพเพอร์ตี้สำหรับ Edge บน Private Cloud โปรดอ่านวิธีกำหนดค่า Edge

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

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

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

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

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

1. ใน Edge UI ให้เลือกพร็อกซี 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

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

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

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

1. ใน Edge UI ให้เลือกพร็อกซี 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

   ตัวอย่างการกำหนดค่านโยบาย ServiceAPI ที่ใช้ 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>
   

   ตัวอย่างการกำหนดค่านโยบาย 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="connect.timeout.millis">5000</Property>
       </Properties>
     <Path>/test</Path>
     </HTTPTargetConnection>
   </ServiceCallout>
   

4. บันทึกการเปลี่ยนแปลงพร็อกซี API

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

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

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

1. ในเครื่องเครื่องมือประมวลผลข้อความ ให้เปิดไฟล์ต่อไปนี้ในตัวแก้ไข หากยังไม่มี ให้สร้างขึ้นมา

   /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
   

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

   conf_http_HTTPClient.connect.timeout.millis=5000
   

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 เครื่อง ให้ทำตามขั้นตอนข้างต้นซ้ำในตัวประมวลผลข้อความทั้งหมด

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

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

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

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

   grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
   

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

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

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

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

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