تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ضبط مهلة I/O على معالجات الرسائل

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

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

تمثل مهلة I/O في معالج الرسائل الوقت الذي يستغرقه معالج الرسائل تنتظر إما تلقي استجابة من خادم الخلفية أو أن يكون المقبس جاهزًا للكتابة طلب إلى خادم الخلفية قبل أن تنتهي مهلته.

القيمة التلقائية لمهلة إدخال/إخراج معالج الرسائل هي 55 seconds. هذه المهلة تسري المدة إلى خوادم الخلفية التي تم ضبطها في إعدادات نقطة النهاية المستهدفة وفي ServiceCallout السياسة للخادم الوكيل لواجهة برمجة التطبيقات.

يمكن زيادة مهلة I/O لمعالجات الرسائل أو تقليلها من القيمة الافتراضية 55 seconds حسب احتياجاتك يمكن ضبطه في الأماكن التالية:

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

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

اسم الموقع الموقع الجغرافي الوصف

اسم الموقع	الموقع الجغرافي	الوصف
`io.timeout.millis`	الخادم الوكيل لواجهة برمجة التطبيقات: نقطة النهاية المستهدفة سياسة وسيلة شرح الخدمة	هذا هو الحد الأقصى للوقت الذي يقوم فيه معالج الرسائل بما يلي: ينتظر تلقي استجابة من خادم الخلفية، بعد إنشاء الاتصال وإرسال الطلب إلى خادم الخلفية الانتظار حتى يكون المقبس جاهزًا حتى يقوم معالج الرسائل بإرسال الطلب إلى خادم الخلفية. في حال عدم وجود استجابة من خادم الخلفية خلال فترة المهلة هذه، فعندئذ انتهت مهلة معالج الرسائل. بشكل افتراضي، تأخذ هذه الخاصية القيمة المعينة السمة `HTTPTransport.io.timeout.millis` في "معالج الرسائل". القيمة التلقائية هي `55 seconds`. إذا تم تعديل هذه السمة باستخدام قيمة مهلة جديدة لخادم وكيل محدد لواجهة برمجة التطبيقات، فلن يتأثر سوى الخادم الوكيل لواجهة برمجة التطبيقات هذا.
`HTTPTransport.io.timeout.millis`	معالج الرسائل	هذا هو الحد الأقصى للوقت الذي يقوم فيه معالج الرسائل بما يلي: ينتظر تلقي استجابة من خادم الخلفية بعد إنشاء الاتصال وإرسال الطلب إلى خادم الخلفية الانتظار حتى يكون المقبس جاهزًا حتى يقوم معالج الرسائل بإرسال الطلب إلى خادم الخلفية. في حال عدم وجود استجابة من خادم الخلفية خلال فترة المهلة هذه، فعندئذ انتهت مهلة معالج الرسائل. تُستخدم هذه السمة مع جميع الخوادم الوكيلة لواجهة برمجة التطبيقات التي تعمل على معالج الرسائل هذا. القيمة التلقائية لهذه السمة هي `55 seconds`. يمكنك تعديل هذه السمة كما هو موضّح في تهيئة مهلة I/O على معالِجات معالجة الرسائل، أو يمكنك استبدال هذه القيمة من خلال ضبط السمة `io.timeout.millis` في واجهة برمجة التطبيقات مستوى الخادم الوكيل.

io.timeout.millis

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

نقطة النهاية المستهدفة
سياسة وسيلة شرح الخدمة

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

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

في حال عدم وجود استجابة من خادم الخلفية خلال فترة المهلة هذه، فعندئذ انتهت مهلة معالج الرسائل.

بشكل افتراضي، تأخذ هذه الخاصية القيمة المعينة السمة HTTPTransport.io.timeout.millis في "معالج الرسائل". القيمة التلقائية هي 55 seconds.

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

HTTPTransport.io.timeout.millis

معالج الرسائل

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

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

في حال عدم وجود استجابة من خادم الخلفية خلال فترة المهلة هذه، فعندئذ انتهت مهلة معالج الرسائل.

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

القيمة التلقائية لهذه السمة هي 55 seconds.

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

قبل البدء

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

إذا لم تكن على دراية بمهلة وحدات الإدخال والإخراج، اطّلِع على السمة io.timeout.millis الوصف باللغة مواصفات موقع نقل نقطة النهاية المستهدف
إذا لم تكن على دراية بكيفية إعداد خصائص Edge for Private Cloud، يُرجى الاطّلاع على كيفية إعداد Edge
احرص على اتّباع التوصيات الواردة في أفضل الممارسات لضبط مهلة وحدات الإدخال والإخراج

ملاحظة:

زيادة مهلة الإدخال/الإخراج للخادم الوكيل لواجهة برمجة التطبيقات:

إذا كنت ترغب في زيادة قيمة مهلة الإدخال/الإخراج أعلى من القيمة التلقائية لخادم وكيل واجهة برمجة تطبيقات محدد، فستحتاج إلى زيادته في الخادم الوكيل لواجهة برمجة التطبيقات (كما هو موضح في ضبط مهلة وحدات الإدخال والإخراج في الخادم الوكيل لواجهة برمجة التطبيقات). بالإضافة إلى ذلك، يجب زيادة قيم مهلة وحدات الإدخال والإخراج على جهاز التوجيه والعميل وخادم الخلفية. بشكل مناسب كما هو موثق في أفضل الممارسات لضبط مهلة وحدات الإدخال والإخراج
زيادة قيمة مهلة الإدخال/الإخراج على معالج الرسائل فقط، أو ضبط قيمة غير ملائمة يمكن أن تؤدي قيم مهلة الإدخال/الإخراج على مكونات Edge إلى أخطاء 504 في مهلة المدخل.

تقليل مهلة الإدخال/الإخراج للخادم الوكيل لواجهة برمجة التطبيقات:

إذا كنت ترغب في تقليل قيمة مهلة الإدخال/الإخراج لخادم وكيل واجهة برمجة تطبيقات معين، فأنت بحاجة إلى تقليل في خادم وكيل واجهة برمجة التطبيقات (كما هو موضح في ضبط مهلة وحدات الإدخال والإخراج في الخادم الوكيل لواجهة برمجة التطبيقات إذا انتهت المهلة على المكونات الأخرى (أجهزة التوجيه والعميل والخلفية) بشكل مناسب وفقًا للتوصيات الواردة في أفضل الممارسات لضبط مهلة وحدات الإدخال والإخراج، وبذلك لا تكون مضطرًا لإجراء أي تغييرات في المكونات الأخرى. وإلا، يمكنك إجراء التغييرات بشكل مناسب.

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

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

نقطة النهاية المستهدفة
سياسة ميزات المكالمة

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

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

ملاحظة: يؤدي ضبط مهلة وحدات الإدخال والإخراج في نقطة النهاية المستهدفة للخادم الوكيل لواجهة برمجة التطبيقات إلى إلغاء القيمة التلقائية (55 seconds) بالقيمة الجديدة ولا تؤثر إلا في القيمة الخادم الوكيل لواجهة برمجة التطبيقات حيث تم إعداده تستمر بقية الخوادم الوكيلة لواجهة برمجة التطبيقات في استخدام الإعداد التلقائي قيمة مهلة الإدخال/الإخراج 55 seconds

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

على سبيل المثال، لتغيير مهلة الإدخال/الإخراج إلى 120 ثانية، يمكنك إضافة مجموعة الرموز التالية:

    <Properties>
      <Property name="io.timeout.millis">120000</Property>
    </Properties>

ونظرًا لأن السمة io.timeout.millis يتم استغراقها بالمللي ثانية، فإن قيمة 120 ثانية هي 120000.

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

مثال على ضبط نقطة النهاية المستهدفة باستخدام عنوان URL لخادم الخلفية

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

مثال على ضبط نقطة النهاية المستهدفة باستخدام الخادم الهدف

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

احفظ التغييرات التي تم إجراؤها على الخادم الوكيل لواجهة برمجة التطبيقات.

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

يشرح هذا القسم كيفية ضبط مهلة إدخال/إخراج في سياسة ServiceCallout في الخادم الوكيل لواجهة برمجة التطبيقات. يمكن ضبط مهلة وحدات الإدخال والإخراج من خلال عنصر <Timeout>. أو السمة io.timeout.millis. كل من العنصر <Timeout> تمثِّل السمة io.timeout.millis قيم مهلة وحدات الإدخال والإخراج بالمللي ثانية.

ملاحظة: ضبط مهلة الإدخال/الإخراج في سياسة ServiceCallout لعمليات إلغاء الخادم الوكيل لواجهة برمجة التطبيقات القيمة التلقائية (55 seconds) بالقيمة الجديدة ولا تؤثر سوى في سياسة ServiceCallout محددة في حال ضبطها. بقية ميزات ServiceCallout والخوادم الوكيلة لواجهة برمجة التطبيقات في استخدام القيمة التلقائية لمهلة وحدات الإدخال والإخراج 55 seconds

يمكنك ضبط مهلة وحدات الإدخال والإخراج في سياسة ServiceCallout باستخدام إحدى الطرق التالية:

العنصر <Timeout>.
الموقع: io.timeout.millis.

عنصر المُهل

لضبط مهلة وحدات الإدخال والإخراج في سياسة ServiceCallout باستخدام <Timeout> قم بما يلي:

في واجهة مستخدم Edge، حدد الخادم الوكيل المحدد لواجهة برمجة التطبيقات الذي تريد تهيئة قيمة مهلة إدخال/إخراج جديدة لسياسة ServiceCallout.
اختَر سياسة ServiceCallout المحدّدة التي تريد تعديلها.
أضف العنصر <Timeout> مع قيمة مناسبة تحت إعداد <ServiceCallout>.
على سبيل المثال، لتغيير مهلة الإدخال/الإخراج إلى 120 ثانية، يمكنك إضافة سطر الرمز التالي:
```
    <Timeout>120000</Timeout>
```
ونظرًا لأن العنصر <Timeout> يتم بالمللي ثانية، فإن قيمة 120 ثانية هي 120000.

يوضح المثال التالي كيفية ضبط مهلة وحدات الإدخال والإخراج في ServiceCallout باستخدام العنصر <Timeout>:

مثال على ضبط سياسة ServiceCallout باستخدام عنوان URL لخادم الخلفية
```
<ServiceCallout name="Service-Callout-1">
    <DisplayName>ServiceCallout-1</DisplayName>
    <Timeout>120000</Timeout>
    <HTTPTargetConnection>
        <Properties/>
        <URL>https://mocktarget.apigee.net/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>
```
احفظ التغييرات التي تم إجراؤها على الخادم الوكيل لواجهة برمجة التطبيقات.

سمة io.timeout.millis

لضبط مهلة وحدات الإدخال والإخراج في سياسة ServiceCallout باستخدام io.timeout.millis، يمكنك تنفيذ ما يلي:

في واجهة مستخدم Edge، اختَر الخادم الوكيل المحدد لواجهة برمجة التطبيقات الذي تريد إعداد واجهة المستخدم عليه. قيمة مهلة الإدخال/الإخراج الجديدة لسياسة ServiceCallout.
اختَر سياسة ServiceCallout المحدّدة التي تريد تعديلها.
أضِف السمة io.timeout.millis مع إدخال قيمة مناسبة ضمن السمة العنصر <HTTPTargetConnection> في إعدادات TargetEndpoint
على سبيل المثال، لتغيير مهلة الإدخال/الإخراج إلى 120 ثانية، يمكنك إضافة المجموعة التالية الرمز:
```
    <Properties>
      <Property name="io.timeout.millis">120000</Property>
    </Properties>
```
ولأنّ السمة io.timeout.millis يتم استغراقها بالمللي ثانية، تكون قيمة 120 ثانية هي 120000.

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

مثال على ضبط سياسة ServiceCallout باستخدام عنوان URL لخادم الخلفية
```
<ServiceCallout name="Service-Callout-1">
    <DisplayName>ServiceCallout-1</DisplayName>
    <HTTPTargetConnection>
      <Properties>
        <Property name="io.timeout.millis">120000</Property>
      </Properties>
      <URL>https://mocktarget.apigee.net/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>
```
مثال على ضبط سياسة ServiceCallout باستخدام الخادم الهدف
```
<ServiceCallout enabled="true" name="Service-Callout-1">
    <DisplayName>ServiceCallout-1</DisplayName>
    <Response>calloutResponse</Response>
    <HTTPTargetConnection>
        <LoadBalancer>
            <Server name="target1" />
            <Server name="target2" />
        </LoadBalancer>
        <Properties>
            <Property name="io.timeout.millis">120000</Property>
        </Properties>
        <Path>/test</Path>
    </HTTPTargetConnection>
</ServiceCallout>
```
ملاحظة: يمكن أن تكون قيم المواقع قيمًا حرفية فقط. لا يمكنك ضبط القيم باستخدام المتغيرات.
احفظ التغييرات التي تم إجراؤها على الخادم الوكيل لواجهة برمجة التطبيقات.

تكوين مهلة وحدات الإدخال والإخراج في معالِجات معالجة الرسائل

يوضح هذا القسم كيفية ضبط مهلة وحدات الإدخال والإخراج في معالجات الرسائل. يمكن ضبط مهلة وحدات الإدخال والإخراج من خلال الموقع الإلكتروني HTTPTransport.io.timeout.millis. والذي يمثل قيمة مهلة الإدخال/الإخراج بالمللي ثانية في مكون معالج الرسائل، باستخدام الرمز المميز وفقًا للبنية الموضحة في كيفية التهيئة Edge

لضبط مهلة وحدات الإدخال والإخراج على معالِجات معالجة الرسائل، يمكنك اتّباع الخطوات التالية:

في جهاز معالج الرسائل، افتح الملف التالي في محرر. وإذا لم يحدث ذلك موجودة بالفعل، ثم قم بإنشائه.
```
/opt/apigee/customer/application/message-processor.properties
```
على سبيل المثال، لفتح الملف باستخدام vi، أدخِل الأمر التالي:
```
vi /opt/apigee/customer/application/message-processor.properties
```
أضف سطرًا بالتنسيق التالي إلى ملف الخصائص، مع استبدال قيمة TIME_IN_MILLISECONDS:
```
conf_http_HTTPTransport.io.timeout.millis=TIME_IN_MILLISECONDS
```
على سبيل المثال، لتغيير مهلة الإدخال/الإخراج في معالج الرسائل إلى 120 ثانية، أضف السطر التالي:
```
conf_http_HTTPTransport.io.timeout.millis=120000
```
احفظ التغييرات.
تأكَّد من أنّ ملف الخصائص ملك لمستخدم apigee كما هو موضّح أدناه:
```
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
```

أعد تشغيل معالج الرسائل كما هو موضح أدناه:

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

إذا كان لديك أكثر من معالج رسائل واحد، فكرر الخطوات المذكورة أعلاه في جميع عمليات المعالِجات:

التحقق من انتهاء مهلة الإدخال/الإخراج على معالِجات معالجة الرسائل

يوضح هذا القسم كيفية التحقق من أن مهلة I/O قد تم تعديلها بنجاح على معالِجات الرسائل.

وعلى الرغم من استخدامك للرمز المميز conf_http_HTTPTransport.io.timeout.millis لإعداد لانتهاء مهلة الإدخال/الإخراج في معالج الرسائل، يلزمك التحقق مما إذا كانت الخاصية تم ضبط HTTPTransport.io.timeout.millis على القيمة الجديدة.

في جهاز "معالج الرسائل"، ابحث عن السمة HTTPTransport.io.timeout.millis في دليل /opt/apigee/edge-message-processor/conf وتحقَّق مما إذا كانت تم ضبط القيمة الجديدة على النحو الموضّح أدناه:
```
grep -ri "HTTPTransport.io.timeout.millis" /opt/apigee/edge-message-processor/conf
```
إذا تم تعيين قيمة مهلة I/O الجديدة بنجاح على معالج الرسائل، فعندئذٍ القيمة الجديدة في ملف http.properties.

نموذج النتيجة من الأمر أعلاه بعد ضبط مهلة وحدات الإدخال والإخراج على 120 ثانية هي كما يلي:

/opt/apigee/edge-message-processor/conf/http.properties:HTTPTransport.io.timeout.millis=120000

في مثال الإخراج أعلاه، لاحظ أن الخاصية تم ضبط HTTPTransport.io.timeout.millis باستخدام القيمة الجديدة 120000 في http.properties يشير ذلك إلى أنّه قد تم ضبط مهلة وحدات الإدخال والإخراج بنجاح. إلى 120 ثانية في معالج الرسائل.

إذا استمر ظهور القيمة القديمة للسمة HTTPTransport.io.timeout.millis، ثم التحقق من اتباع جميع الخطوات الموضحة في ضبط مهلة وحدات الإدخال والإخراج على معالِجات الرسائل بشكل صحيح. إذا كان لديك أي خطوة فائتة، فقم بتكرار جميع الخطوات مرة أخرى بشكل صحيح.
إذا لم تتمكن بعد من تعديل مهلة وحدات الإدخال والإخراج، يُرجى التواصل مع دعم Apigee Edge

ما هي الخطوة التالية؟

معلومات عن ضبط مهلة الإدخال/الإخراج على أجهزة التوجيه