روال‌های مطلوب برای پیکربندی کردن مهلت زمانی ورودی/خروجی

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

درخواست‌های API که برنامه‌های مشتری ایجاد می‌کنند قبل‌از رسیدن به سرویس‌های زیرینه، ازطریق عناصر مختلف در Apigee Edge جریان می‌یابند. اکثر برنامه‌های مشتری انتظار دارند پاسخ‌های این درخواست‌ها به‌موقع دریافت شوند.

برای دستیابی به پاسخ‌های به‌موقع، مقادیر درنگ ورودی/خروجی در هریک از مؤلفه‌هایی که درخواست‌های میانای برنامه‌سازی کاربردی ازطریق آن‌ها جریان می‌یابد تنظیم می‌شود. اگر هریک از عناصر در جریان کاری بیشتر از عنصر قبلی زمان ببرد، عنصر قبلی مهلت زمانی‌اش به‌پایان می‌رسد و با خطاهای «۵۰۴ پایان مهلت زمانی دروازه» پاسخ می‌دهد.

هنگام پیکربندی درنگ، مقادیر باید با نهایت دقت در هریک از مؤلفه‌ها پیکربندی شود، درغیراین‌صورت می‌تواند منجر به خطاهای «۵۰۴ پایان مهلت زمانی دروازه» شود.

این سند روال‌های مطلوب را برای پیکربندی زمان اتمام I/O در اجزای مختلفی که درخواست‌های API در Apigee Edge ازطریق آن‌ها جریان می‌یابد شرح می‌دهد.

روال‌های مطلوب برای پیکربندی کردن مهلت زمانی ورودی/خروجی

هنگام پیکربندی زمان اتمام I/O، روال‌های مطلوب زیر را درنظر بگیرید:

  • اولین عنصر: همیشه از بالاترین زمان انتظار در اولین عنصر در جریان درخواست API استفاده کنید، که «برنامه کارخواه» در Apigee Edge است.
  • آخرین عنصر: همیشه از کمترین زمان انتظار در آخرین عنصر در جریان درخواست API استفاده کنید، که «سرویس زیرینه» در Apigee Edge است.
  • بین عناصر: مطمئن شوید که بین مقدار مهلت زمانی پیکربندی‌شده در هر عنصر بین اولین عنصر و آخرین عنصر در جریان، حداقل ۲ تا ۳ ثانیه تفاوت وجود داشته باشد.
  • رهیاب: همیشه بهتر است مقدار مهلت زمانی ورودی/خروجی را برای میزبان مجازی خاصی پیکربندی (اصلاح) کنید تا اینکه آن را در «رهیاب» پیکربندی کنید. این کار تضمین می‌کند که مقدار مهلت زمانی جدید فقط بر آن «پراکسی‌های API» که از میزبان مجازی خاصی استفاده می‌کنند تأثیر بگذارد و نه بر همه «پراکسی‌های API» که «مسیریاب» ارائه می‌کند.

    فقط زمانی که کاملاً مطمئن هستید مقدار جدید مهلت زمانی I/O برای همه «پراکسی‌های API» که در «مسیریاب» اجرا می‌شوند لازم یا قابل‌اعمال است، مهلت زمانی I/O را در «مسیریاب» پیکربندی (اصلاح) کنید.

  • پردازشگر پیام: همیشه بهتر است مقدار زمان انتظار ورودی/خروجی را برای یک پراکسی API خاص پیکربندی (اصلاح) کنید تا اینکه آن را در «پردازشگر پیام» پیکربندی کنید. این کار تضمین می‌کند که مقدار زمان انتظار جدید فقط بر پراکسی API خاص تأثیر می‌گذارد و نه بر همه پراکسی‌های API که «پردازشگر پیام» ارائه می‌دهد.

    مهلت I/O را در «پردازشگر پیام» فقط زمانی پیکربندی (اصلاح) کنید که کاملاً مطمئن باشید مقدار مهلت I/O جدید برای همه «پراکسی‌های API» که در «پردازشگر پیام» اجرا می‌شوند لازم یا قابل‌اعمال است.

سناریوهای نمونه

سناریوهای این بخش می‌تواند به شما کمک کند نحوه تنظیم صحیح مقادیر زمان انتظار ورودی/خروجی را درک کنید.

سناریو ۱: درخواست‌های مستقیم از برنامه‌های مشتری به Apigee Edge

این بخش بهترین روش‌ها را برای دنبال کردن درحین تنظیم مقادیر مهلت زمانی در راه‌اندازی Apigee Edge که در آن هیچ عنصر واسطه‌ای بین برنامه مشتری و Apigee Edge و بین Apigee Edge و سرور پشتیبان شما وجود ندارد، توضیح می‌دهد.

راه‌اندازی نمونه Apigee بدون عناصر واسطه

جریان از «مشتری» شروع می‌شود و به «رهیاب» و سپس به «پردازشگر پیام» و سپس به «سرور زیرینه» می‌رود

اگر Apigee Edge همان‌طور که در نمودار بالا نشان داده شده است، بدون هیچ مؤلفه واسطه‌ای راه‌اندازی شده است، از روال‌های مطلوب زیر استفاده کنید:

  1. برنامه کلاینت اولین عنصر در جریان است. مقدار بالاترین زمان انتظار باید در مشتری تنظیم شود.
  2. سرور زیرینه آخرین عنصر در جریان است. مقدار کمترین زمان انتظار باید در کارساز زیرینه تنظیم شود.
  3. مقادیر درنگ را در هریک از عناصر به ترتیب زیر پیکربندی کنید:

    پیکربندی کردن زمان اتمام در کارخواه، سپس «مسیریاب»، سپس «پردازشگر پیام»، سپس «سرور زیرینه»

    مثال زیر مقادیر مهلت زمانی تنظیم‌شده در عناصر مختلف را طبق رهنمودهای ارائه‌شده در بالا برای جلوگیری از بروز هرگونه مشکل نشان می‌دهد:

    مهلت زمانی را در کارخواه روی ۶۰ ثانیه، سپس در «مسیریاب» روی ۵۷ ثانیه، سپس در «پردازشگر پیام» روی ۵۵ ثانیه، سپس در «سرور زیرینه» روی ۵۲ ثانیه پیکربندی کنید

سناریو ۲: درخواست‌ها به Apigee Edge از برنامه‌های مشتری ازطریق عناصر واسطه

این بخش بهترین روش‌ها را برای دنبال کردن هنگام تنظیم مقادیر مهلت زمانی در راه‌اندازی Apigee Edge که در آن یک یا چند عنصر واسطه بین برنامه مشتری و Apigee Edge و همچنین بین Apigee Edge و سرور زیرینه شما وجود دارد، توضیح می‌دهد.

عناصر واسطه می‌تواند ترازکننده بار، شبکه توزیع محتوا (CDN)، NGINX، و غیره باشد.

راه‌اندازی نمونه Apigee با یک عنصر واسطه بین «کارخواه» و Apigee Edge و بین Apigee Edge و سرور زیرینه

جریان از «کارخواه» شروع می‌شود و به «عنصر واسطه ۱» و سپس به «مسیریاب» و سپس به «پردازشگر پیام» و سپس به «عنصر واسطه ۲» و سپس به «سرور زیرینه» می‌رود

اگر Apigee Edge همان‌طور که در نمودار بالا نشان داده شده است، با یک یا چند عنصر واسطه راه‌اندازی شده است، از روش‌های مطلوب زیر استفاده کنید:

  1. برنامه کلاینت اولین عنصر در جریان است. بالاترین مقدار مهلت باید در مشتری تنظیم شود.
  2. سرور زیرینه آخرین عنصر در جریان است. پایین‌ترین مقدار مهلت باید در سرور زیرینه تنظیم شود.
  3. مقادیر مهلت زمانی را در هریک از عناصر، ازجمله عناصر واسطه، به ترتیب زیر پیکربندی کنید:

    مهلت زمانی را در مشتری، سپس «عنصر واسط ۱»، سپس «رهیاب»، سپس «پردازشگر پیام»، سپس «عنصر واسط ۲»، سپس «سرور زیرینه» پیکربندی کنید

    مثال زیر مقادیر مهلت زمانی تنظیم‌شده در عناصر مختلف را طبق رهنمودهای ارائه‌شده در بالا برای جلوگیری از بروز هرگونه مشکل نشان می‌دهد:

    پیکربندی مهلت زمانی در مشتری در ۶۳ ثانیه، سپس «مؤلفه واسطه ۱» در ۶۰ ثانیه، سپس «مسیریاب» در ۵۷ ثانیه، سپس «پردازشگر پیام» در ۵۵ ثانیه، سپس «مؤلفه واسطه ۲» در ۵۲ ثانیه، سپس «سرور زیرینه» در ۵۹ ثانیه