پیکربندی وقفه اتصال در پردازشگرهای پیام

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

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

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

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

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

ویژگی های زیر مدت زمان اتصال را در پردازشگرهای پیام کنترل می کنند:

قبل از شروع

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

• اگر با مهلت زمانی اتصال آشنا نیستید، به توضیحات ویژگی connect.timeout.millis در TargetEndpoint Transport Property Specification مراجعه کنید.
• اگر با پیکربندی ویژگی‌های Edge در Private Cloud آشنایی ندارید، نحوه پیکربندی Edge را بخوانید.

پیکربندی وقفه اتصال در پراکسی API

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

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

پیکربندی وقفه اتصال در نقطه پایانی هدف پروکسی API

این بخش نحوه پیکربندی توقف اتصال در نقطه پایانی پروکسی API خود را توضیح می‌دهد. زمان پایان اتصال را می توان از طریق ویژگی 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 خود پیکربندی کرد:

   نمونه پیکربندی نقطه پایانی هدف با استفاده از 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. در رابط کاربری 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 خود را ذخیره کنید.

پیکربندی وقفه اتصال در پردازشگرهای پیام

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

برای پیکربندی زمان پایان اتصال در پردازشگرهای پیام، موارد زیر را انجام دهید:

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

   به عنوان مثال، برای تغییر مدت زمان اتصال در پردازشگر پیام به 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. در دستگاه 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 ثانیه در پردازشگر پیام پیکربندی شده است.

3. اگر هنوز مقدار قدیمی ویژگی HTTPClient.connect.timeout.millis را می بینید، سپس بررسی کنید که تمام مراحل ذکر شده در پیکربندی زمان اتصال در پردازشگرهای پیام را به درستی دنبال کرده اید. اگر هر مرحله ای را از دست داده اید، تمام مراحل را دوباره به درستی تکرار کنید.
4. اگر هنوز نمی‌توانید مهلت زمانی اتصال را تغییر دهید، با پشتیبانی Google Cloud Apigee Edge تماس بگیرید.