ضبط مهلة انتهاء الصلاحية في "معالجات الرسائل"

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

يشرح هذا المستند طريقة ضبط مهلة الاحتفاظ بالآخر في Apigee Edge. معالِجات الرسائل.

تتيح مهلة البقاء حيًا على معالج الرسائل لاتصال TCP واحد إرسال تلقي طلبات/استجابات HTTP متعددة من/إلى خادم الخلفية، بدلاً من فتح صفحة جديدة اتصال لكل زوج طلب/استجابة.

إن القيمة الافتراضية لخاصية "الحفاظ على المهلة" في معالج الرسائل هي 60 ثانية تسري فترة المهلة هذه على خوادم الخلفية التي تم ضبطها. في إعداد نقطة النهاية المستهدفة وفي سياسة ServiceCallout على الخادم الوكيل لواجهة برمجة التطبيقات.

يمكن زيادة مهلة البقاء على قيد الحياة لمعالجات الرسائل أو خفضها من القيمة التلقائية من 60 ثانية حسب احتياجاتك. يمكن إعداده بالطرق التالية:

• في الخادم الوكيل لواجهة برمجة التطبيقات
  • في نقطة النهاية المستهدفة
  • في سياسة ServiceCallout
• في معالج الرسائل

تتحكم الخصائص التالية في مهلة البقاء حيًا على معالِجات معالجة الرسائل:

اسم الموقع	الموقع الجغرافي	الوصف
keepalive.timeout.millis	الخادم الوكيل لواجهة برمجة التطبيقات: نقطة النهاية المستهدفة سياسة واحدة (ServiceCallout)	هذا هو الحد الأقصى لمدة عدم النشاط التي يسمح فيها معالج الرسائل بمنفذ TCP واحدًا. إرسال واستقبال العديد من طلبات/استجابات HTTP، بدلاً من فتح علامة اتصال لكل زوج طلب/استجابة. بشكل افتراضي، تأخذ هذه الخاصية القيمة المعينة HTTPClient.keepalive.timeout.millis في معالج الرسائل، حيث تكون القيمة التلقائية 60 ثانية. إذا تم تعديل هذه السمة بقيمة مهلة جديدة للخادم المستهدف المستخدَم في نقطة النهاية المستهدفة أو سياسة ServiceCallout في الخادم الوكيل لواجهة برمجة التطبيقات المحدّد، ويتأثر وقت الاحتفاظ بالبيانات لهذا الخادم المستهدف فقط.
HTTPClient.keepalive.timeout.millis	معالج الرسائل	هذا هو الحد الأقصى لمدة عدم النشاط التي يسمح فيها معالج الرسائل بمنفذ TCP واحدًا. إرسال واستقبال العديد من طلبات/استجابات HTTP، بدلاً من فتح اتصال جديد لكل زوج طلب/استجابة. تُستخدم هذه السمة مع جميع الخوادم الوكيلة لواجهة برمجة التطبيقات التي تعمل على معالج الرسائل هذا. القيمة التلقائية لهذه السمة هي 60 ثانية. يمكنك تعديل هذه السمة كما هو موضّح في ضبط مهلة البقاء على قيد الحياة في معالِجات معالجة الرسائل أدناه، أو يمكنك استبدال هذه القيمة من خلال ضبط الموقع keepalive.timeout.millis على مستوى الخادم الوكيل لواجهة برمجة التطبيقات.

قبل البدء

قبل استخدام الخطوات الواردة في هذا المستند، احرص على فهم المواضيع التالية:

• إذا لم تكن معتادًا على المهلة المحدّدة، يُرجى الاطّلاع على keepalive.timeout.millis. وصف الموقع في مواصفات موقع نقل نقطة النهاية المستهدف
• إذا لم تكن على دراية بكيفية إعداد خصائص Edge على Private Cloud، يُرجى قراءة كيفية إعداد Edge

ضبط مهلة إبقاء البقاء حيًّا في الخادم الوكيل لواجهة برمجة التطبيقات

يمكن ضبط مهلة البقاء على قيد الحياة في الخادم الوكيل لواجهة برمجة التطبيقات في الأماكن التالية:

• نقطة النهاية المستهدفة
• سياسة واحدة (ServiceCallout)

ضبط مهلة إبقاء البقاء حيًّا في نقطة النهاية المستهدفة للخادم الوكيل لواجهة برمجة التطبيقات

يشرح هذا القسم كيفية ضبط مهلة عدم البقاء في نقطة النهاية المستهدفة. الخادم الوكيل لواجهة برمجة التطبيقات. يمكن ضبط مهلة البقاء على قيد الحياة من خلال الموقع. keepalive.timeout.millis، الذي يمثل قيمة مهلة بقاء مهلة بقاء في مللي ثانية.

1. في واجهة مستخدم Edge، حدد الخادم الوكيل المحدد لواجهة برمجة التطبيقات الذي تريد تهيئة واجهة برمجة التطبيقات الجديدة فيه الحفاظ على قيمة المهلة الثابتة.
2. اختَر نقطة النهاية المستهدَفة المحدّدة التي تريد تعديلها.

3. أضِف السمة keepalive.timeout.millis باستخدام قيمة مناسبة ضمن العنصر <HTTPTargetConnection> في الإعدادات TargetEndpoint.

   على سبيل المثال، لتغيير "مهلة البقاء حي" إلى 30 ثانية، أضف السمة مجموعة الرموز التالية:

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

   ونظرًا لأن السمة keepalive.timeout.millis يتم استغراقها بالمللي ثانية، فإن قيمة مدة 30 ثانية هي 30000.

   توضِّح الأمثلة التالية طريقة ضبط مهلة إبقاء الحياة نشطة في نقطة النهاية المستهدَفة. تهيئة الخادم الوكيل لواجهة برمجة التطبيقات:

   مثال على ضبط نقطة النهاية المستهدفة باستخدام عنوان 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. احفظ التغييرات التي تم إجراؤها على الخادم الوكيل لواجهة برمجة التطبيقات.

إعداد سياسة "مهلة البقاء حي" في سياسة ServiceCallout لخادم وكيل واجهة برمجة التطبيقات

يشرح هذا القسم كيفية ضبط مهلة بقاء الحياة نشطة في سياسة ServiceCallout للخادم الوكيل لواجهة برمجة التطبيقات. يمكن أن تكون مهلة البقاء حيًا تم إعداده من خلال الموقع the keepalive.timeout.millis، والذي يمثّل قيمة مهلة المحافظة على الحياة بالمللي ثانية.

لضبط مهلة البقاء على قيد الحياة في سياسة ServiceCallout باستخدام السمة keepalive.timeout.millis:

1. في واجهة مستخدم Edge، حدد الخادم الوكيل المحدد لواجهة برمجة التطبيقات الذي تريد تهيئة واجهة برمجة التطبيقات الجديدة فيه الحفاظ على قيمة المهلة المحددة في سياسة 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 للخادم الوكيل لواجهة برمجة التطبيقات:

   مثال على ضبط سياسة 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. احفظ التغييرات التي تم إجراؤها على الخادم الوكيل لواجهة برمجة التطبيقات.

تكوين مهلة البقاء حيًا في معالِجات معالجة الرسائل

يوضح هذا القسم كيفية تهيئة مهلة البقاء حيًا في معالِجات معالجة الرسائل. تشير رسالة الأشكال البيانية يمكن ضبط مهلة البقاء حيًا من خلال الموقع HTTPClient.keepalive.timeout.millis، الذي يشير إلى مهلة إبقاء الحياة نشطة بالملي ثانية في مكون معالج الرسائل. بما أنّه تمّ التعليق على هذا الموقع معالج الرسائل، فستحتاج إلى استخدام بناء جملة خاص conf/http.properties+HTTPClient.keepalive.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.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 للحفاظ على النشاط. في معالج الرسائل، فإنك تحتاج إلى التحقق مما إذا كانت الخاصية تم ضبط 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. وإذا تم تعيين القيمة الجديدة لمهلة الاحتفاظ المحددة بنجاح في معالج الرسائل، فعندئذ سيعرض الأمر أعلاه القيمة الجديدة في ملف 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. إذا لم تتمكن من تعديل مهلة إبقاء البقاء حيًّا، يُرجى التواصل مع فريق دعم Apigee Edge في Google Cloud.