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

يتم الآن عرض مستندات 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.