أفضل الممارسات لضبط مهلة I/O

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

تمر طلبات البيانات من واجهة برمجة التطبيقات التي تقدّمها تطبيقات العميل عبر مكوّنات مختلفة في Apigee Edge قبل أن تصل إلى خدمات الخلفية. تتوقع معظم تطبيقات العملاء تلقّي الردود على هذه الطلبات في الوقت المناسب.

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

أثناء ضبط المهلة، يجب ضبط القيم في كل مكوّن بعناية بالغة، وإلا قد يؤدي ذلك إلى أخطاء 504 مهلة العبور.

يصف هذا المستند أفضل الممارسات لضبط مهلة I/O على المكوّنات المختلفة التي يتم من خلالها توجيه طلبات واجهة برمجة التطبيقات في Apigee Edge.

أفضل الممارسات لضبط مهلة الإدخال/الإخراج

ننصحك باتّباع أفضل الممارسات التالية عند ضبط مهلة الإدخال/الإخراج:

  • المكوّن الأول: استخدِم دائمًا أعلى مهلة للمكوّن الأول في مسار طلب البيانات من واجهة برمجة التطبيقات، وهو تطبيق العميل في Apigee Edge.
  • المكوّن الأخير: استخدِم دائمًا أقل مهلة في المكوّن الأخير في مسار طلب واجهة برمجة التطبيقات ، وهو خدمة الخلفية في Apigee Edge.
  • بين المكوّنات: تأكّد من أنّ هناك فرقًا بين ثانيتين وثلاث ثوانٍ على الأقل في قيمة المهلة التي تم ضبطها في كل مكوّن بين المكوّن الأول والمكوّن الأخير في العملية.
  • الموجِّه: من الممارسات الجيدة دائمًا ضبط (تعديل) قيمة مهلة I/O لجهاز مضيف افتراضي معيّن بدلاً من ضبطها على الموجِّه. يضمن ذلك أنّ القيمة الجديدة لمهلة الاستجابة لا تؤثّر إلا في وكلاء واجهة برمجة التطبيقات الذين يستخدِمون المضيف الافتراضي المحدّد وليس كل وكلاء واجهة برمجة التطبيقات الذين يقدّمهم "الموجّه".

    لا تضبط (تعدِّل) مهلة الإدخال/الإخراج على جهاز التوجيه إلا عندما تكون متأكّدًا تمامًا من أنّ قيمة مهلة الإدخال/الإخراج الجديدة مطلوبة أو قابلة للتطبيق على جميع أدوات الربط بواجهة برمجة التطبيقات التي تعمل على جهاز التوجيه.

  • معالج الرسائل: من الممارسات الجيدة دائمًا ضبط (تعديل) قيمة مهلة I/O لمثيل محدد لواجهة برمجة التطبيقات بدلاً من ضبطها في معالج الرسائل. يضمن ذلك أنّ قيمة المهلة الجديدة لا تؤثّر إلا في وكيل واجهة برمجة التطبيقات المحدّد وليس في جميع وكلاء واجهات برمجة التطبيقات الذين يقدّمهم "معالج الرسائل".

    لا تضبط (تعدِّل) مهلة I/O في Message Processor إلا عندما تكون متأكّدًا تمامًا من أنّ قيمة مهلة I/O الجديدة مطلوبة أو قابلة للتطبيق على جميع تطبيقات خادم الوكيل لواجهة برمجة التطبيقات التي تعمل على "معالج الرسائل".

أمثلة على السيناريوهات

يمكن أن تساعدك السيناريوهات الواردة في هذا القسم في فهم كيفية ضبط قيم مهلة الإدخال/الإخراج بشكلٍ صحيح.

السيناريو 1: الطلبات إلى Apigee Edge من تطبيقات العميل مباشرةً

يصف هذا القسم أفضل الممارسات التي يجب اتّباعها أثناء إعداد قيم المهلة في عملية إعداد Apigee Edge التي لا تتضمّن أي مكوّنات وسيطة بين تطبيق العميل و Apigee Edge وبين Apigee Edge وخادم الخلفية.

نموذج إعداد Apigee بدون مكوّنات وسيطة

مسار يبدأ من العميل وينتقل إلى التوجيه ثم إلى معالِج الرسائل ثم إلى خادم الخلفية

في حال إعداد Apigee Edge كما هو موضّح في المخطّط البياني أعلاه، بدون أيّ مكوّنات وسيطة، اتّبِع أفضل الممارسات التالية:

  1. تطبيق العميل هو المكوّن الأول في العملية. يجب ضبط قيمة أعلى مهلة على العميل.
  2. خادم الخلفية هو المكوّن الأخير في العملية. يجب ضبط قيمة أدنى مهلة على خادم الخلفية.
  3. اضبط قيم المهلة في كل مكوّن بالترتيب التالي:

    ضبط مهلة على العميل، ثمّ على جهاز التوجيه، ثمّ على معالِج الرسائل، ثمّ على خادم الخلفية

    يعرض المثال التالي قيم المهلة التي تم ضبطها على المكوّنات المختلفة وفقًا للإرشادات المذكورة أعلاه لتجنُّب أي مشاكل:

    اضبط المهلة على العميل على 60 ثانية، ثم على جهاز التوجيه على 57 ثانية، ثم على "معالج الرسائل" على 55 ثانية، ثم على "الخادم الخلفي" على 52 ثانية.

السيناريو 2: الطلبات إلى Apigee Edge من تطبيقات العميل من خلال المكوّنات الوسيطة

يصف هذا القسم أفضل الممارسات التي يجب اتّباعها أثناء إعداد قيم مهلة الانتظار في عملية إعداد Apigee Edge التي تتضمّن مكوّنًا وسيطًا واحدًا أو أكثر بين تطبيق العميل وApigee Edge، وكذلك بين Apigee Edge وخادم الخلفية.

يمكن أن تكون المكوّنات الوسيطة عبارة عن أداة موازنة الأحمال وشبكة توصيل محتوى (CDN) وNGINX وما إلى ذلك.

نموذج إعداد Apigee باستخدام مكوّن وسيط واحد بين العميل وApigee Edge وبين Apigee Edge وخادم الخلفية

تدفّق يبدأ من العميل وينتقل إلى المكوّن الوسيط 1 ثم إلى جهاز التوجيه ثم إلى معالِج الرسائل ثم إلى المكوّن الوسيط 2 ثم إلى خادم الخلفية

في حال إعداد Apigee Edge كما هو موضّح في المخطّط البياني أعلاه، باستخدام مكوّن واحد أو أكثر من المكونات الوسيطة، اتّبِع أفضل الممارسات التالية:

  1. تطبيق العميل هو المكوّن الأول في العملية. يجب ضبط قيمة أعلى مهلة على العميل.
  2. خادم الخلفية هو المكوّن الأخير في العملية. يجب ضبط قيمة أدنى مهلة على خادم الخلفية.
  3. اضبط قيم المهلة لكل مكوّن، بما في ذلك المكوّنات الوسيطة، بالترتيب التالي:

    ضبط مهلة في العميل، ثم المكوّن الوسيط 1، ثم جهاز التوجيه، ثم معالِج الرسائل، ثم المكوّن الوسيط 2، ثم خادم الخلفية

    يعرض المثال التالي قيم المهلة التي تم ضبطها على المكوّنات المختلفة وفقًا للإرشادات المذكورة أعلاه لتجنُّب أي مشاكل:

    اضبط المهلة على العميل عند 63 ثانية، ثم على المكوّن الوسيط 1 عند 60 ثانية، ثم على جهاز التوجيه عند 57 ثانية، ثم على معالِج الرسائل عند 55 ثانية، ثم على المكوّن الوسيط 2 عند 52 ثانية، ثم على خادم الخلفية عند 59 ثانية.