پیکربندی بازه زمانی زنده نگه داشتن در پردازشگرهای پیام

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

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

بازه زمانی زنده نگه داشتن در پردازشگر پیام به یک اتصال TCP اجازه می‌دهد به جای باز کردن یک اتصال جدید برای هر جفت درخواست/پاسخ، چندین درخواست/پاسخ HTTP را از/به سرور پشتیبان ارسال و دریافت کند.

مقدار پیش فرض ویژگی keep alive timeout در پردازشگر پیام 60 ثانیه است. این بازه زمانی برای سرورهای پشتیبان پیکربندی شده در پیکربندی نقطه پایانی هدف و در خط مشی ServiceCallout پروکسی API شما قابل اجرا است.

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

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

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

قبل از شروع

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

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

در حال پیکربندی حفظ وقفه در پراکسی API

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

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

در حال پیکربندی زمان ماندن زنده در نقطه پایانی پراکسی API

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

1. در رابط کاربری Edge، پراکسی API خاصی را انتخاب کنید که می‌خواهید در آن مقدار بازدارنده جدید keep alive را پیکربندی کنید.
2. نقطه پایانی هدف خاصی را که می خواهید تغییر دهید انتخاب کنید.

3. ویژگی keepalive.timeout.millis را با یک مقدار مناسب در زیر عنصر <HTTPTargetConnection> در پیکربندی TargetEndpoint اضافه کنید.

   به عنوان مثال، برای تغییر زمان باز ماندن زنده به 30 ثانیه، بلوک کد زیر را اضافه کنید:

   <Properties>
     <Property name="keepalive.timeout.millis">30000</Property>
   </Properties>

   از آنجایی که ویژگی keepalive.timeout.millis بر حسب میلی ثانیه است، مقدار 30 ثانیه 30000 است.

   مثال‌های زیر نشان می‌دهند که چگونه می‌توان بازه زمانی نگه داشتن زنده را در پیکربندی نقطه پایانی پروکسی API خود پیکربندی کرد:

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

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

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

   <TargetEndpoint name="default">
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="target1" />
         <Server name="target2" />
       </LoadBalancer>
       <Properties>
         <Property name="keepalive.timeout.millis">30000</Property>
       </Properties>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>

4. تغییرات ایجاد شده در پروکسی API خود را ذخیره کنید.

در حال پیکربندی حفظ وقفه در خط مشی ServiceCallout پروکسی API

این بخش نحوه پیکربندی مهلت زمانی نگه داشتن زنده را در خط مشی ServiceCallout پروکسی API خود توضیح می دهد. بازه زمانی keep alive را می توان از طریق ویژگی the keepalive.timeout.millis پیکربندی کرد، که مقدار بازه زمانی keep alive را در میلی ثانیه نشان می دهد.

برای پیکربندی بازه زمانی keep alive در خط مشی ServiceCallout با استفاده از ویژگی keepalive.timeout.millis :

1. در رابط کاربری Edge، پراکسی API خاصی را انتخاب کنید که می‌خواهید در آن مقدار بازدارنده جدید keep alive برای خط‌مشی ServiceCallout پیکربندی شود.
2. خط مشی ServiceCallout خاصی را که می خواهید تغییر دهید انتخاب کنید.
3. ویژگی keepalive.timeout.millis را با یک مقدار مناسب در زیر عنصر <HTTPTargetConnection> در پیکربندی TargetEndpoint اضافه کنید.

   به عنوان مثال برای تغییر فاصله زمانی نگه داشتن زنده به 30 ثانیه، بلوک کد زیر را اضافه کنید:

   <Properties>
     <Property name="keepalive.timeout.millis">30000</Property>
   </Properties>

   از آنجایی که ویژگی keepalive.timeout.millis بر حسب میلی ثانیه است، مقدار 30 ثانیه 30000 است.

   مثال‌های زیر نحوه پیکربندی مهلت زمانی نگه داشتن زنده را در خط‌مشی ServiceCallout پروکسی API خود نشان می‌دهند:

   مثال پیکربندی خط مشی ServiceCallout با استفاده از URL برای سرور پشتیبان

   <ServiceCallout name="Service-Callout-1">
     <DisplayName>Service Callout-1</DisplayName>
     <HTTPTargetConnection>
       <Properties>
         <Property name="keepalive.timeout.millis">30000</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="keepalive.timeout.millis">30000</Property>
       </Properties>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </ServiceCallout>

4. تغییرات ایجاد شده در پروکسی API خود را ذخیره کنید.

پیکربندی بازه زمانی زنده نگه داشتن در پردازشگرهای پیام

این بخش نحوه پیکربندی بازه زمانی نگه داشتن زنده را در پردازشگرهای پیام توضیح می دهد. مهلت زمانی نگه داشتن زنده را می‌توان از طریق ویژگی HTTPClient.keepalive.timeout.millis پیکربندی کرد، که نشان‌دهنده مقدار وقفه ماندن زنده در میلی‌ثانیه در مؤلفه پردازشگر پیام است. از آنجایی که این ویژگی روی Message Processor توضیح داده شده است، باید از دستور ویژه conf/http.properties+HTTPClient.keepalive.timeout.millis همانطور که در بخش توضیح داده شده است ، استفاده کنید.

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

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.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS

   به عنوان مثال، برای تغییر زمان باز ماندن زنده در پردازشگر پیام به 30 ثانیه، خط زیر را اضافه کنید:

   conf/http.properties+HTTPClient.keepalive.timeout.millis=30000

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.properties+HTTPClient.keepalive.timeout.millis برای تنظیم بازه زمانی keep alive در پردازنده پیام استفاده می کنید، باید بررسی کنید که آیا ویژگی واقعی HTTPClient.keepalive.timeout.millis با تنظیم شده است یا خیر. ارزش جدید

1. در دستگاه پردازشگر پیام، ویژگی HTTPClient.keepalive.timeout.millis را در پوشه /opt/apigee/edge-message-processor/conf جستجو کنید و بررسی کنید که آیا مطابق شکل زیر با مقدار جدید تنظیم شده است یا خیر:

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

2. اگر مقدار new keep alive timeout با موفقیت روی Message Processor تنظیم شود، دستور بالا مقدار جدید را در فایل http.properties نشان می دهد.

   نتیجه نمونه دستور بالا پس از پیکربندی حفظ زنده ماندن تا 30 ثانیه به شرح زیر است:

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

   در خروجی مثال بالا، توجه کنید که ویژگی HTTPClient.keepalive.timeout.millis با مقدار جدید 30000 در http.properties تنظیم شده است. این نشان می دهد که مهلت زمانی زنده نگه داشتن با موفقیت به 30 ثانیه در پردازشگر پیام پیکربندی شده است.

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