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

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

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

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

يمكن زيادة مهلة الاتصال لمعالجات الرسائل أو تقليلها من القيمة التلقائية التي تبلغ 3 ثانية بناءً على احتياجاتك. يمكن إعداده بالطرق التالية:

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

تتحكم الخصائص التالية في مهلة الاتصال في معالِجات معالجة الرسائل:

اسم الموقع الموقع الجغرافي الوصف
connect.timeout.millis الخادم الوكيل لواجهة برمجة التطبيقات:
  • نقطة النهاية المستهدفة
  • سياسة واحدة (ServiceCallout)

وهذا هو الحد الأقصى للوقت الذي ينتظره معالج الرسائل للاتصال بالخادم الهدف.

بشكل افتراضي، تأخذ هذه الخاصية القيمة المعينة سمة HTTPClient.connect.timeout.millis في "معالج الرسائل" حيث تكون القيمة التلقائية هي 3 ثانية.

في حال تم تعديل هذا الموقع باستخدام قيمة مهلة جديدة للخادم المستهدف المرتبط. خادم وكيل لواجهة برمجة التطبيقات، فسيتأثر وقت الاتصال بالخادم الهدف فقط.

HTTPClient.connect.timeout.millis معالج الرسائل

وهذا هو الحد الأقصى للوقت الذي ينتظره معالج الرسائل للاتصال بالخادم الهدف.

تُستخدم هذه السمة مع جميع الخوادم الوكيلة لواجهة برمجة التطبيقات التي تعمل على معالج الرسائل هذا.

القيمة التلقائية لهذه السمة هي 3 ثانية.

يمكنك تعديل هذه السمة كما هو موضّح في . ضبط مهلة الاتصال في معالِجات الرسائل أدناه، أو يمكنك استبدال هذه القيمة من خلال ضبط الموقع connect.timeout.millis على مستوى الخادم الوكيل لواجهة برمجة التطبيقات.

قبل البدء

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

ضبط مهلة الاتصال في الخادم الوكيل لواجهة برمجة التطبيقات

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

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

ضبط مهلة الاتصال في نقطة النهاية المستهدفة للخادم الوكيل لواجهة برمجة التطبيقات

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

  1. في واجهة مستخدم Edge، حدد الخادم الوكيل المحدد لواجهة برمجة التطبيقات الذي تريد تهيئة واجهة برمجة التطبيقات الجديدة فيه مهلة الاتصال.
  2. اختَر نقطة النهاية المستهدَفة المحدّدة التي تريد تعديلها.
  3. أضِف السمة connect.timeout.millis باستخدام قيمة مناسبة ضمن العنصر <HTTPTargetConnection> في الإعدادات TargetEndpoint.

    على سبيل المثال، لتغيير مهلة الاتصال إلى 5 ثانية، أضف مجموعة الرموز التالية: 

    <Properties>
  <Property name="connect.timeout.millis">5000</Property>
</Properties>

    ولأنّ السمة connect.timeout.millis يتم استغراقها بالمللي ثانية، تكون قيمة مدة 5 ثانية هي 5000.

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

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

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

يشرح هذا القسم كيفية ضبط مهلة الاتصال في ServiceCallout. السياسة للخادم الوكيل لواجهة برمجة التطبيقات. يمكن ضبط مهلة الاتصال من خلال الموقع الإلكتروني connect.timeout.millis، الذي يمثّل قيمة وقت الربط في مللي ثانية.

لضبط مهلة الاتصال في سياسة ServiceCallout باستخدام السمة connect.timeout.millis:

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

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

تهيئة مهلة الاتصال في معالِجات معالجة الرسائل

يوضح هذا القسم كيفية تهيئة مهلة الاتصال في معالِجات معالجة الرسائل. يمكن ضبط مهلة الاتصال من خلال الموقع. 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.