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

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

این سند نحوه پیکربندی کردن مهلت زمانی ورودی/خروجی در «مسیریاب‌های Apigee Edge» را توضیح می‌دهد.

مهلت زمانی ورودی/خروجی در «مسیریاب» نشان‌دهنده مدت زمانی است که «مسیریاب» پس‌از ایجاد اتصال و ارسال درخواست به «پردازشگر پیام»، منتظر دریافت پاسخ از «پردازشگر پیام» می‌ماند. مقدار پیش‌فرض زمان اتمام I/O در «مسیریاب» ۵۷ ثانیه است.

براساس نیازهایتان، زمان اتمام I/O برای «مسیریاب‌ها» می‌تواند از مقدار پیش‌فرض ۵۷ ثانیه افزایش یا کاهش یابد. می‌تواند به روش‌های زیر پیکربندی شود:

  • در میزبان مجازی
  • در رهیاب

دارایی‌های زیر مهلت زمانی ورودی/خروجی را در «مسیریاب‌ها» کنترل می‌کنند:

نام دارایی مکان شرح
proxy_read_timeout میزبان مجازی

حداکثر زمانی را که «مسیریاب» پس‌از ایجاد اتصال و ارسال درخواست به «پردازشگر پیام» منتظر دریافت پاسخ از «پردازشگر پیام» می‌ماند مشخص می‌کند.

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

به‌طور پیش‌فرض، این دارایی مقدار تنظیم‌شده برای دارایی conf_load_balancing_load.balancing.driver.proxy.read.timeout در «مسیریاب» را می‌گیرد. مقدار پیش‌فرض ۵۷ ثانیه است.

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

conf_load_balancing_load.balancing.driver.proxy.read.timeout رهیاب

حداکثر زمانی را که «مسیریاب» پس‌از ایجاد اتصال و ارسال درخواست به «پردازشگر پیام» منتظر دریافت پاسخ از «پردازشگر پیام» می‌ماند مشخص می‌کند.

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

این دارایی برای همه میزبان‌های مجازی در این «مسیریاب» استفاده می‌شود.

مقدار پیش‌فرض این دارایی ۵۷ ثانیه است.

می‌توانید این دارایی را همان‌گونه که در پیکربندی کردن مهلت زمانی ورودی/خروجی در مسیریاب‌ها در زیر توضیح داده شده است اصلاح کنید، یا می‌توانید این مقدار را با تنظیم دارایی 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 شما چندین «پردازشگر پیام» داشته باشد و امکان تلاش مجدد درصورت بروز خطا فعال باشد. مقدار آن یکی از موارد زیر است:

  • مقدار کنونی conf_load_balancing_load.balancing.driver.proxy.read.timeout
  • مقدار پیش‌فرض ۵۷ ثانیه

همانند دارایی conf_load_balancing_load.balancing.driver.proxy.read.timeout ، می‌توانید بازه‌های زمانی دیگری به‌جز پیش‌فرض (ثانیه) مشخص کنید.

قبل‌از شروع

قبل‌از استفاده از مراحل این سند، مطمئن شوید که موضوعات زیر را درک می‌کنید:

پیکربندی کردن زمان اتمام I/O در میزبان مجازی

این بخش توضیح می‌دهد که چگونه زمان اتمام ورودی/خروجی را در میزبان مجازی منسوب به یک سازمان و محیط پیکربندی کنید. درنگ ورودی/خروجی را می‌توان در میزبان مجازی ازطریق دارایی proxy_read_timeout پیکربندی کرد، که نشان‌دهنده مقدار درنگ ورودی/خروجی برحسب ثانیه است.

می‌توانید میزبان مجازی را بااستفاده از یکی از روش‌های زیر پیکربندی کنید:

  • میانای کاربر Edge
  • Edge API

میانای کاربر Edge

برای پیکربندی میزبان مجازی بااستفاده از «میانای کاربری Edge»، کارهای زیر را انجام دهید:

  1. به سیستم میانای کاربر Edge وارد شوید.
  2. به سرپرست > میزبان‌های مجازی پیمایش کنید.
  3. محیط خاصی را که می‌خواهید این تغییر را در آن انجام دهید انتخاب کنید.
  4. میزبان مجازی خاصی را که می‌خواهید مقدار جدید مهلت زمانی ورودی/خروجی را برای آن پیکربندی کنید انتخاب کنید.
  5. در بخش دارایی‌ها، مقدار زمان اتمام خواندن پراکسی را برحسب ثانیه به‌روز کنید.

    برای مثال، اگر می‌خواهید زمان اتمام را به ۱۲۰ ثانیه تغییر دهید، همان‌طور که در شکل زیر نشان داده شده است، ۱۲۰ را تایپ کنید:

    مقدار درنگ خواندن پراکسی ۱۲۰

  6. تغییر را ذخیره کنید.

Edge API

برای پیکربندی میزبان مجازی بااستفاده از Edge API، مراحل زیر را انجام دهید:

  1. پیکربندی میزبان مجازی فعلی را بااستفاده از میانای برنامه‌سازی کاربردی دریافت میزبان مجازی همان‌طور که در زیر نشان داده شده است دریافت کنید:

    کاربر «ابر عمومی»

    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
        }
  2. دارایی 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
    }
  3. پیکربندی میزبان مجازی به‌روزشده را در فایلی ذخیره کنید. برای مثال، virtualhost-payload.json.
  4. پیکربندی 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 در میزبان مجازی باموفقیت اصلاح شده است.

  1. میانای برنامه‌سازی کاربردی دریافت میزبان مجازی را اجرا کنید تا پیکربندی 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} نام میزبان مجازی است

  2. تأیید کنید که دارایی 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 با مقدار جدید ۱۲۰ ثانیه تنظیم شده است.

  3. اگر هنوز مقدار قدیمی proxy_read_timeout, را می‌بینید، تأیید کنید که همه مراحلی را که در پیکربندی درنگ ورودی/خروجی در میزبان مجازی توضیح داده شده است به‌درستی دنبال کرده‌اید. اگر مرحله‌ای را ازدست داده‌اید، همه مراحل را دوباره به‌درستی تکرار کنید.
  4. اگر همچنان نمی‌توانید مهلت زمانی I/O را تغییر دهید، با پشتیبانی Apigee Edge تماس بگیرید.

پیکربندی کردن زمان اتمام I/O در «مسیریاب‌ها»

این بخش توضیح می‌دهد که چگونه مهلت زمانی ورودی/خروجی را در «مسیریاب‌ها» پیکربندی کنید. درنگ ورودی/خروجی را می‌توان ازطریق دارایی «مسیریاب» conf_load_balancing_load.balancing.driver.proxy.read.timeout پیکربندی کرد، که مقدار درنگ ورودی/خروجی را برحسب ثانیه نشان می‌دهد.

برای پیکربندی کردن زمان اتمام I/O در «مسیریاب‌ها»، کارهای زیر را انجام دهید:

  1. در ماشین «مسیریاب»، فایل زیر را در ویرایشگر باز کنید. اگر ازقبل وجود ندارد، آن را ایجاد کنید.
    /opt/apigee/customer/application/router.properties

    برای مثال، برای باز کردن فایل با vi، فرمان زیر را وارد کنید:

    vi /opt/apigee/customer/application/router.properties
  2. خطی را با قالب زیر به فایل properties اضافه کنید و مقدار a را جایگزین time_in_seconds کنید:
  3. 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
  4. تغییرات را ذخیره کنید.
  5. مطمئن شوید که این فایل دارایی متعلق به کاربر apigee است، همان‌طور که در زیر نشان داده شده است:
    chown apigee:apigee /opt/apigee/customer/application/router.properties
  6. «رهیاب» را همان‌طور که در زیر نشان داده شده است بازراه‌اندازی کنید:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  7. اگر بیش‌از یک «مسیریاب» دارید، مراحل بالا را در همه «مسیریاب‌ها» تکرار کنید.

درحال درستی‌سنجی کردن زمان اتمام ورودی/خروجی در «رهیاب‌ها»

این بخش توضیح می‌دهد که چگونه تأیید کنید که زمان اتمام I/O در «مسیریاب‌ها» باموفقیت اصلاح شده است.

اگرچه از کد conf_load_balancing_load.balancing.driver.proxy.read.timeout برای تنظیم زمان اتمام I/O در «رهیاب» استفاده می‌کنید، باید بررسی کنید که آیا دارایی واقعی proxy_read_timeout با مقدار جدید تنظیم شده است یا نه.

  1. دارایی proxy_read_timeout را در دایرکتوری /opt/nginx/conf.d جستجو کنید و بررسی کنید که آیا با مقدار جدید به‌صورت زیر تنظیم شده است یا نه:
    grep -ri "proxy_read_timeout" /opt/nginx/conf.d
  2. اگر مقدار جدید درنگ ورودی/خروجی با موفقیت در مسیریاب تنظیم شود، فرمان بالا مقدار جدید را در همه فایل‌های پیکربندی میزبان مجازی نشان می‌دهد.

    در زیر نتیجه نمونه از فرمان 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 باموفقیت روی «مسیریاب» روی ۱۲۰ ثانیه پیکربندی شده است.

  3. اگر هنوز مقدار قدیمی دارایی proxy_read_timeout را می‌بینید، درستی‌سنجی کنید که همه مراحل ذکرشده در پیکربندی کردن مهلت زمانی ورودی/خروجی در مسیریاب‌ها را به‌درستی دنبال کرده باشید. اگر مرحله‌ای را ازدست داده‌اید، همه مراحل را دوباره به‌درستی تکرار کنید.
  4. اگر همچنان نمی‌توانید مهلت زمانی I/O را تغییر دهید، با پشتیبانی Apigee Edge تماس بگیرید.

گام بعدی چیست؟

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