درحال پیکربندی زمان اتمام اتصال در «پردازشگرهای پیام»

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

این سند توضیح می‌دهد که چگونه زمان اتمام اتصال را برای «پردازشگرهای پیام Apigee Edge» پیکربندی کنید.

مهلت اتصال نشان‌دهنده مدت زمانی است که «پردازشگر پیام» برای ایجاد اتصال با سرور مقصد منتظر می‌ماند. مقدار پیش‌فرض دارایی مهلت زمانی اتصال در «پردازشگر پیام» 3 ثانیه است. این دوره زمان اتمام برای سرورهای زیرینه پیکربندی‌شده در پیکربندی نقطه پایان هدف و در خط‌مشی ServiceCallout کارگزار نیابتی API شما اعمال می‌شود.

براساس نیازهایتان، زمان اتمام اتصال «پردازشگرهای پیام» را می‌توانید از مقدار پیش‌فرض 3 ثانیه افزایش یا کاهش دهید. می‌تواند به روش‌های زیر پیکربندی شود:

• در پراکسی API
  • در نقطه پایان هدف
  • در خط‌مشی ServiceCallout
• در «پردازشگر پیام»

خصوصیت‌های زیر مهلت زمانی اتصال را در «پردازشگرهای پیام» کنترل می‌کنند:

نام دارایی	مکان	شرح
connect.timeout.millis	کارگزار میانای برنامه‌سازی کاربردی: نقطه پایانی هدف خط‌مشی ServiceCallout	این حداکثر زمانی است که «پردازشگر پیام» برای اتصال به سرور هدف منتظر می‌ماند. به‌طور پیش‌فرض، این دارایی مقدار تنظیم‌شده برای دارایی HTTPClient.connect.timeout.millis در «پردازشگر پیام» را می‌گیرد، که مقدار پیش‌فرض آن 3 ثانیه است. اگر این دارایی با مقدار مهلت زمانی جدیدی برای سرور هدف مرتبط با کارگزار API اصلاح شود، فقط زمان اتصال آن سرور هدف تحت تأثیر قرار می‌گیرد.
HTTPClient.connect.timeout.millis	پردازشگر پیام	این حداکثر زمانی است که «پردازشگر پیام» برای اتصال به سرور مقصد منتظر می‌ماند. این دارایی برای همه پراکسی‌های API که در این «پردازشگر پیام» اجرا می‌شوند استفاده می‌شود. مقدار پیش‌فرض این دارایی 3 ثانیه است. می‌توانید این دارایی را همان‌گونه که در پیکربندی کردن مهلت زمانی اتصال در «پردازشگرهای پیام» در زیر توضیح داده شده است تغییر دهید، یا می‌توانید این مقدار را با تنظیم دارایی connect.timeout.millis در سطح پراکسی API ملغی کنید.

قبل‌از شروع

قبل‌از استفاده از مراحل این سند، مطمئن شوید که موضوعات زیر را درک می‌کنید:

• اگر با مهلت زمانی اتصال آشنا نیستید، شرح دارایی connect.timeout.millis را در مشخصات دارایی انتقال «نقطه پایانی هدف» ببینید.
• اگر با پیکربندی دارایی‌ها برای Edge در «ابر خصوصی» آشنا نیستید، نحوه پیکربندی Edge را بخوانید.

پیکربندی زمان اتمام اتصال در پراکسی میانای برنامه‌سازی کاربردی

مهلت زمانی اتصال را می‌توانید در کارگزار نیابتی API در مکان‌های زیر پیکربندی کنید:

• نقطه پایانی هدف
• خط‌مشی ServiceCallout

پیکربندی درنگ اتصال در نقطه پایانی هدف میانای برنامه‌سازی کاربردی

این بخش توضیح می‌دهد که چگونه زمان اتمام اتصال را در نقطه پایانی هدف میانای برنامه‌سازی کاربردی خود پیکربندی کنید. درنگ اتصال را می‌توان ازطریق دارایی connect.timeout.millis پیکربندی کرد، که مقدار درنگ اتصال را به میلی‌ثانیه نشان می‌دهد.

1. در «واسط کاربر 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 را نشان می‌دهد:

   نمونه پیکربندی نقطه پایان هدف بااستفاده از نشانی وب برای سرور زیرینه

   <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 میانای برنامه‌سازی کاربردی

این بخش توضیح می‌دهد که چگونه مهلت زمانی اتصال را در خط‌مشی ServiceCallout کارگزار API خود پیکربندی کنید. درنگ اتصال را می‌توان ازطریق دارایی connect.timeout.millis پیکربندی کرد که مقدار زمان اتصال را به میلی‌ثانیه نشان می‌دهد.

برای پیکربندی کردن مهلت زمانی اتصال در خط‌مشی ServiceCallout بااستفاده از دارایی connect.timeout.millis:

1. در «واسط کاربر 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 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 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. اگر بیش‌از یک «پردازشگر پیام» دارید، مراحل بالا را در همه «پردازشگرهای پیام» تکرار کنید.

مهلت زمانی درستی‌سنجی اتصال در «پردازشگرهای پیام»

این بخش توضیح می‌دهد که چگونه تأیید کنید مهلت زمانی اتصال در «پردازشگرهای پیام» باموفقیت اصلاح شده است.

اگرچه از نشان 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 تماس بگیرید.