درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
این سند نحوه پیکربندی کردن مهلت زمانی ورودی/خروجی در «مسیریابهای Apigee Edge» را توضیح میدهد.
مهلت زمانی ورودی/خروجی در «مسیریاب» نشاندهنده مدت زمانی است که «مسیریاب» پساز ایجاد اتصال و ارسال درخواست به «پردازشگر پیام»، منتظر دریافت پاسخ از «پردازشگر پیام» میماند. مقدار پیشفرض زمان اتمام I/O در «مسیریاب» ۵۷ ثانیه است.
براساس نیازهایتان، زمان اتمام I/O برای «مسیریابها» میتواند از مقدار پیشفرض ۵۷ ثانیه افزایش یا کاهش یابد. میتواند به روشهای زیر پیکربندی شود:
- در میزبان مجازی
- در رهیاب
داراییهای زیر مهلت زمانی ورودی/خروجی را در «مسیریابها» کنترل میکنند:
| نام دارایی | مکان | شرح |
|---|---|---|
proxy_read_timeout
|
میزبان مجازی |
حداکثر زمانی را که «مسیریاب» پساز ایجاد اتصال و ارسال درخواست به «پردازشگر پیام» منتظر دریافت پاسخ از «پردازشگر پیام» میماند مشخص میکند. اگر «پردازشگر پیام» در این دوره زماندار پاسخی ارائه نکند، «مسیریاب» زماندار میشود. بهطور پیشفرض، این دارایی مقدار تنظیمشده برای دارایی
اگر این دارایی با مقدار زمان انتظار جدیدی برای میزبان مجازی خاصی اصلاح شود، فقط پراکسیهای API که از آن میزبان مجازی خاص استفاده میکنند تحتتأثیر قرار میگیرند. |
conf_load_balancing_load.balancing.driver.proxy.read.timeout
|
رهیاب |
حداکثر زمانی را که «مسیریاب» پساز ایجاد اتصال و ارسال درخواست به «پردازشگر پیام» منتظر دریافت پاسخ از «پردازشگر پیام» میماند مشخص میکند. اگر «پردازشگر پیام» در این دوره زماندار پاسخی ارائه نکند، «مسیریاب» زماندار میشود. این دارایی برای همه میزبانهای مجازی در این «مسیریاب» استفاده میشود. مقدار پیشفرض این دارایی ۵۷ ثانیه است. میتوانید این دارایی را همانگونه که در
پیکربندی کردن مهلت زمانی ورودی/خروجی در مسیریابها در زیر توضیح داده شده است اصلاح کنید، یا میتوانید
این مقدار را با تنظیم دارایی میتوانید فاصله زمانی این دارایی را بااستفاده از نماد زیر بهصورت غیر از ثانیه تنظیم کنید: ms: milliseconds s: seconds (default) m: minutes h: hours d: days w: weeks M: months (length of 30 days) y: years (length of 365 days) |
conf_load_balancing_load.balancing.driver.nginx.upstream_next_timeout
|
رهیاب |
مشخص میکند که «مسیریاب» پساز ایجاد اتصال و ارسال درخواست به هریک از «پردازشگرهای پیام»، چه مدت منتظر دریافت پاسخ از همه «پردازشگرهای پیام» میماند. این مورد زمانی کاربرد دارد که نصب Edge شما چندین «پردازشگر پیام» داشته باشد و امکان تلاش مجدد درصورت بروز خطا فعال باشد. مقدار آن یکی از موارد زیر است:
همانند دارایی |
قبلاز شروع
قبلاز استفاده از مراحل این سند، مطمئن شوید که موضوعات زیر را درک میکنید:
- اگر با «داراییهای میزبان مجازی» آشنا نیستید، مرجع دارایی میزبان مجازی را بخوانید.
- اگر با پیکربندی داراییها برای Edge در «ابر خصوصی» آشنا نیستید، نحوه پیکربندی Edge را بخوانید.
- مطمئن شوید که روالهای مطلوب برای پیکربندی توصیههای مهلت زمانی ورودی/خروجی را دنبال میکنید.
پیکربندی کردن زمان اتمام I/O در میزبان مجازی
این بخش توضیح میدهد که چگونه زمان اتمام ورودی/خروجی را در میزبان مجازی منسوب به یک سازمان و محیط پیکربندی کنید. درنگ ورودی/خروجی را میتوان در میزبان مجازی ازطریق
دارایی proxy_read_timeout پیکربندی کرد، که نشاندهنده مقدار درنگ ورودی/خروجی برحسب ثانیه است.
میتوانید میزبان مجازی را بااستفاده از یکی از روشهای زیر پیکربندی کنید:
- میانای کاربر Edge
- Edge API
میانای کاربر Edge
برای پیکربندی میزبان مجازی بااستفاده از «میانای کاربری Edge»، کارهای زیر را انجام دهید:
- به سیستم میانای کاربر Edge وارد شوید.
- به سرپرست > میزبانهای مجازی پیمایش کنید.
- محیط خاصی را که میخواهید این تغییر را در آن انجام دهید انتخاب کنید.
- میزبان مجازی خاصی را که میخواهید مقدار جدید مهلت زمانی ورودی/خروجی را برای آن پیکربندی کنید انتخاب کنید.
- در بخش داراییها، مقدار زمان اتمام خواندن پراکسی را برحسب ثانیه بهروز کنید.
برای مثال، اگر میخواهید زمان اتمام را به ۱۲۰ ثانیه تغییر دهید، همانطور که در شکل زیر نشان داده شده است، ۱۲۰ را تایپ کنید:
- تغییر را ذخیره کنید.
Edge API
برای پیکربندی میزبان مجازی بااستفاده از Edge API، مراحل زیر را انجام دهید:
- پیکربندی میزبان مجازی فعلی را بااستفاده از
میانای برنامهسازی کاربردی دریافت میزبان مجازی همانطور که در زیر نشان داده شده است دریافت کنید:
کاربر «ابر عمومی»
curl -v -X GET https//api.enterprise.apigee.com/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -u <username>کاربر «ابر خصوصی»
curl -v -X GET http://<management-host>:<port #>/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -u <username>مکان:
{organization-name} نام سازمان است
{environment-name} نام محیط است
{virtualhost-name} نام میزبان مجازی است
پیکربندی نمونه میزبان مجازی
{ "hostAliases": [ "api.myCompany,com" ], "interfaces": [], "listenOptions": [], "name": "secure", "port": "443", "retryOptions": [], "sSLInfo": { "ciphers": [], "clientAuthEnabled": "false", "enabled": "true", "ignoreValidationErrors": false, "keyAlias": "myCompanyKeyAlias", "keyStore": "ref://myCompanyKeystoreref", "protocols": [] }, "useBuiltInFreeTrialCert": false } - دارایی
proxy_read_timeoutرا به پیکربندی میزبان مجازی موجود پایهبار JSON درpropertiesبا مقدار در ثانیه اضافه کنید.برای مثال، برای تغییر دادن زمان اتمام I/O به ۱۲۰ ثانیه، بلوک کد
propertiesرا همانطور که در زیر نشان داده شده است اضافه کنید:نمونه پیکربندی میزبان مجازی بهروزشده
{ "hostAliases": [ "api.myCompany,com", ], "interfaces": [], "listenOptions": [], "name": "secure", "port": "443", "retryOptions": [], "properties": { "property": [ { "name": "proxy_read_timeout", "value": "120" } ] }, "sSLInfo": { "ciphers": [], "clientAuthEnabled": "false", "enabled": "true", "ignoreValidationErrors": false, "keyAlias": "myCompanyKeyAlias", "keyStore": "ref://myCompanyKeystoreref", "protocols": [] }, "useBuiltInFreeTrialCert": false } - پیکربندی میزبان مجازی بهروزشده را در فایلی ذخیره کنید. برای مثال،
virtualhost-payload.json. - پیکربندی
virtualhostرا با تغییر بااستفاده از میانای برنامهسازی کاربردی «بهروزرسانی میزبان مجازی» بهصورت زیر بهروز کنید:کاربر «ابر عمومی»
curl -v -X POST Content-Type: application/json https://api.enterprise.apigee.com/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -d @virtualhost-payload.json -u <username>
کاربر «ابر خصوصی»
curl -v -X POST Content-Type: application/json http://<management-host>:<port #>/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -d @virtualhost-payload.json -u <username>
مکان:
{organization-name} نام سازمان است
{environment-name} نام محیط است
{virtualhost-name} نام میزبان مجازی است
درحال درستیسنجی کردن مهلت زمانی ورودی/خروجی در میزبانهای مجازی
این بخش توضیح میدهد که چگونه بااستفاده از Edge API درستیسنجی کنید که زمان اتمام I/O در میزبان مجازی باموفقیت اصلاح شده است.
- میانای برنامهسازی کاربردی
دریافت میزبان مجازی را اجرا کنید تا پیکربندی
virtualhostرا همانطور که در زیر نشان داده شده است دریافت کنید:کاربر «ابر عمومی»
curl -v -X GET https://api.enterprise.apigee.com/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -u <username>کاربر «ابر خصوصی»
curl -v -X GET http://<management server-host>:<port #>/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -u <username>مکان:
{organization-name} نام سازمان است
{environment-name} نام محیط است
{virtualhost-name} نام میزبان مجازی است
- تأیید کنید که دارایی
proxy_read_timeoutروی مقدار جدید تنظیم شده است.نمونه پیکربندی میزبان مجازی بهروزشده
{ "hostAliases": [ "api.myCompany,com", ], "interfaces": [], "listenOptions": [], "name": "secure", "port": "443", "retryOptions": [], "properties": { "property": [ { "name": "proxy_read_timeout", "value": "120" } ] }, "sSLInfo": { "ciphers": [], "clientAuthEnabled": "false", "enabled": "true", "ignoreValidationErrors": false, "keyAlias": "myCompanyKeyAlias", "keyStore": "ref://myCompanyKeystoreref", "protocols": [] }, "useBuiltInFreeTrialCert": false }در مثال بالا، توجه داشته باشید که
proxy_read_timeoutبا مقدار جدید ۱۲۰ ثانیه تنظیم شده است. - اگر هنوز مقدار قدیمی
proxy_read_timeout,را میبینید، تأیید کنید که همه مراحلی را که در پیکربندی درنگ ورودی/خروجی در میزبان مجازی توضیح داده شده است بهدرستی دنبال کردهاید. اگر مرحلهای را ازدست دادهاید، همه مراحل را دوباره بهدرستی تکرار کنید. - اگر همچنان نمیتوانید مهلت زمانی I/O را تغییر دهید، با پشتیبانی Apigee Edge تماس بگیرید.
پیکربندی کردن زمان اتمام I/O در «مسیریابها»
این بخش توضیح میدهد که چگونه مهلت زمانی ورودی/خروجی را در «مسیریابها» پیکربندی کنید. درنگ ورودی/خروجی را میتوان ازطریق
دارایی «مسیریاب»
conf_load_balancing_load.balancing.driver.proxy.read.timeout پیکربندی کرد، که
مقدار درنگ ورودی/خروجی را برحسب ثانیه نشان میدهد.
برای پیکربندی کردن زمان اتمام I/O در «مسیریابها»، کارهای زیر را انجام دهید:
- در ماشین «مسیریاب»، فایل زیر را در ویرایشگر باز کنید. اگر ازقبل وجود ندارد، آن را ایجاد کنید.
/opt/apigee/customer/application/router.properties
برای مثال، برای باز کردن فایل با
vi، فرمان زیر را وارد کنید:vi /opt/apigee/customer/application/router.properties
- خطی را با قالب زیر به فایل
propertiesاضافه کنید و مقدار a را جایگزینtime_in_secondsکنید: - تغییرات را ذخیره کنید.
- مطمئن شوید که این فایل دارایی متعلق به کاربر
apigeeاست، همانطور که در زیر نشان داده شده است:chown apigee:apigee /opt/apigee/customer/application/router.properties
- «رهیاب» را همانطور که در زیر نشان داده شده است بازراهاندازی کنید:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- اگر بیشاز یک «مسیریاب» دارید، مراحل بالا را در همه «مسیریابها» تکرار کنید.
conf_load_balancing_load.balancing.driver.proxy.read.timeout=time_in_seconds
برای مثال، برای تغییر دادن زمان اتمام I/O در «مسیریاب» به ۱۲۰ ثانیه، خط زیر را اضافه کنید:
conf_load_balancing_load.balancing.driver.proxy.read.timeout=120
همچنین میتوانید زمان اتمام I/O را برحسب دقیقه اصلاح کنید. برای مثال، برای تغییر دادن زمان اتمام به دو دقیقه، خط زیر را اضافه کنید:
conf_load_balancing_load.balancing.driver.proxy.read.timeout=2m
درحال درستیسنجی کردن زمان اتمام ورودی/خروجی در «رهیابها»
این بخش توضیح میدهد که چگونه تأیید کنید که زمان اتمام I/O در «مسیریابها» باموفقیت اصلاح شده است.
اگرچه از کد
conf_load_balancing_load.balancing.driver.proxy.read.timeout برای تنظیم زمان اتمام I/O
در «رهیاب» استفاده میکنید، باید بررسی کنید که آیا دارایی واقعی proxy_read_timeout با مقدار جدید تنظیم شده است یا نه.
- دارایی
proxy_read_timeoutرا در دایرکتوری/opt/nginx/conf.dجستجو کنید و بررسی کنید که آیا با مقدار جدید بهصورت زیر تنظیم شده است یا نه:grep -ri "proxy_read_timeout" /opt/nginx/conf.d
- اگر مقدار جدید درنگ ورودی/خروجی با موفقیت در مسیریاب تنظیم شود، فرمان بالا مقدار جدید را در همه فایلهای پیکربندی میزبان مجازی نشان میدهد.
در زیر نتیجه نمونه از فرمان
grepدرصورتیکه مهلت زمانی ورودی/خروجی ۱۲۰ ثانیه باشد آمده است:/opt/nginx/conf.d/0-default.conf:proxy_read_timeout 120; /opt/nginx/conf.d/0-edge-health.conf:proxy_read_timeout 1s;
در برونداد مثال بالا، توجه کنید که دارایی
proxy_read_timeoutبا مقدار جدید ۱۲۰ در0-default.confتنظیم شده است که فایل پیکربندی برای میزبان مجازی پیشفرض است. این نشان میدهد که زمان اتمام I/O باموفقیت روی «مسیریاب» روی ۱۲۰ ثانیه پیکربندی شده است. - اگر هنوز مقدار قدیمی دارایی
proxy_read_timeoutرا میبینید، درستیسنجی کنید که همه مراحل ذکرشده در پیکربندی کردن مهلت زمانی ورودی/خروجی در مسیریابها را بهدرستی دنبال کرده باشید. اگر مرحلهای را ازدست دادهاید، همه مراحل را دوباره بهدرستی تکرار کنید. - اگر همچنان نمیتوانید مهلت زمانی I/O را تغییر دهید، با پشتیبانی Apigee Edge تماس بگیرید.
گام بعدی چیست؟
درباره پیکربندی زمان اتمام ورودی/خروجی در «پردازشگر پیام» بیشتر بدانید