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

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

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

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

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

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

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

قبل از اینکه شروع کنی

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

• اگر با زمان اتصال (connection timeout) آشنا نیستید، به توضیحات ویژگی 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 برای سرور backend

   <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 برای سرور backend

   <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 پیکربندی کرد، که نشان دهنده مقدار زمان پایان اتصال بر حسب میلی ثانیه در مؤلفه پردازنده پیام است، با استفاده از توکن مطابق با نحو شرح داده شده در نحوه پیکربندی 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. مطمئن شوید که فایل properties متعلق به کاربر 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. در دستگاه پردازشگر پیام، در دایرکتوری /opt/apigee/edge-message-processor/conf به دنبال ویژگی HTTPTransport.connect.timeout.millis بگردید و بررسی کنید که آیا مطابق شکل زیر با مقدار جدید تنظیم شده است یا خیر:

   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. اگر هنوز قادر به تغییر زمان اتصال نیستید، با پشتیبانی Google Cloud Apigee Edge تماس بگیرید.