‫۴۰۴ چندین میزبان مجازی با نام مستعار میزبان یکسان

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

نشانه

برنامه مشتری کد وضعیت HTTP 404 را با پیام Not Found و پیام خطای Unable to identify proxy for host: VIRTUAL_HOST and url: PATH به‌عنوان پاسخ به تماس‌های API دریافت می‌کند.

این خطا به این معنی است که Edge نتوانسته است پراکسی API را برای میزبان مجازی و مسیر مشخص‌شده پیدا کند.

پیام خطا

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

HTTP/1.1 404 Not Found

علاوه‌براین، ممکن است پیام خطایی مشابه پیام زیر مشاهده کنید:

{
   "fault":{
      "faultstring":"Unable to identify proxy for host: default and url: \/oauth2\/token",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.ApplicationNotFound"
      }
   }
}

علل احتمالی

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

مراحل متداول تشخیص خرابی

گزارش‌های NGINX و «پردازشگر پیام» در عیب‌یابی خطای 404 مفید خواهد بود. برای بررسی گزارش‌ها، از مراحل زیر استفاده کنید:

  1. بااستفاده از فرمان زیر، گزارش‌های NGINX را مشاهده کنید:
    /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log
  2. فیلدهای زیر را در ورودی‌های گزارش بررسی کنید:
    فیلد مقدار
    Upstream_status, status 404
    X-Apigee-fault-code messaging.adaptors.http.flow.ApplicationNotFound

    شناسه پیام را از گزارش‌ها یادداشت کنید.

  3. گزارش‌های «پردازشگر پیام» را بررسی کنید (/opt/apigee/var/log/edge-message-processor/logs/system.log) تا ببینید آیا messaging.adaptors.http.flow.ApplicationNotFound را برای میانای برنامه‌سازی کاربردی خاص دارید یا شناسه پیام منحصربه‌فرد مرحله ۲ را برای درخواست میانای برنامه‌سازی کاربردی دارید.

    پیام خطای نمونه از گزارش «پردازشگر پیام»

  4. NIOThread@1 ERROR ADAPTORS.HTTP.FLOW - AbstractRequestListener.onException() : Request:POST,
    uri:/weather, message Id:null, exception:com.apigee.rest.framework.ResourceNotFoundException{
    code = messaging.adaptors.http.flow.ApplicationNotFound, message = Unable to identify proxy for
    host: vh1 and url: /weather, associated contexts = []}, context:Context@342ea86b
    input=ClientInputChannel(SSLClientChannel[Accepted: Remote:10.123.123.123:8443
    Local:10.135.33.68:62092]@1206954 useCount=1 bytesRead=0 bytesWritten=0 age=1ms
    lastIO=0ms  isOpen=true)

    گزارش بالا کد خطا را نشان می‌دهد و پیام خطا به‌صورت زیر است:

    code = messaging.adaptors.http.flow.ApplicationNotFound,
    message = Unable to identify proxy for host: vh1 and url: /weather

دلیل: چندین میزبان مجازی با نام مستعار میزبان و شماره درگاه یکسان

«مسیریاب‌های Apigee Edge» و «پردازشگرهای پیام» از هر دو سرصفحه میزبان، شماره درگاه، و مسیرهای نشانی وب برای مسیریابی ترافیک به پراکسی API صحیح استفاده می‌کنند. داشتن تعریف‌های مبهم مثل چندین میزبان مجازی با نام مستعار میزبان و شماره درگاه یکسان، یک الگوی ضد مستند است و می‌تواند منجر به رفتارهای غیرمنتظره شود. یکی از خطاهای رایجی که مشاهده خواهید کرد خطای 404 با پیام Unable to identify proxy for host: VIRTUAL_HOST and url: PATH است.

معمولاً اگر چندین میزبان مجازی با نام مستعار میزبان یکسان وجود داشته باشد، خطاهای 404 متناوب مشاهده خواهید کرد. دلیل این امر این است که «پراکسی API» خاص ممکن است به‌گونه‌ای پیکربندی شده باشد که درخواست‌ها را فقط در یکی از میزبان‌های مجازی بپذیرد. وقتی درخواست‌های میانای برنامه‌سازی کاربردی به میزبان مجازی خاصی که در «پراکسی میانای برنامه‌سازی کاربردی» پیکربندی شده است هدایت شود، پاسخ موفقیت‌آمیزی دریافت خواهید کرد. بااین‌حال، وقتی درخواست‌های «میانای برنامه‌سازی کاربردی» به میزبان‌های مجازی دیگری هدایت می‌شود که «پراکسی میانای برنامه‌سازی کاربردی» برای پذیرفتن درخواست‌ها در آن‌ها پیکربندی نشده است، «میاناهای برنامه‌سازی کاربردی» با این خطاهای 404 ناموفق خواهند بود.

دستورالعمل‌های ارائه‌شده در 404 Unable to identify proxy for host: <virtual host name> and url: <path> را دنبال کنید و این خطا را عیب‌یابی کنید. اگر هیچ‌کدام از این دلایل منجر به این خطا نمی‌شود، از مراحل زیر برای تعیین اینکه آیا میزبان‌های مجازی با نام‌های مستعار میزبان تکراری باعث ایجاد 404 خطاها می‌شوند یا خیر، استفاده کنید.

تشخیص

از یکی از روش‌های زیر برای تعیین اینکه آیا چندین میزبان مجازی با نام مستعار میزبان/شماره درگاه یکسان وجود دارد که منجر به خطاهای 404 می‌شود یا نه استفاده کنید:

  • میانای کاربر Edge
  • میاناهای برنامه‌سازی کاربردی مدیریت

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

از این دستورالعمل‌ها برای تعیین اینکه آیا چندین میزبان مجازی با میزبان یکسان نام مستعار/شماره درگاه بااستفاده از «میانای کاربری Edge» وجود دارد یا نه استفاده کنید.

برای مثال، اگر خطای 404 را با نشانی وب http://example.com:9001/proxy1 مشاهده کردید، باید پیدا کنید کدام میزبان‌های مجازی نام مستعار میزبان example.com و درگاه 9001 را دارند.

  1. در ابر عمومی و میانای کاربر Edge جدید در ابر خصوصی:
    1. سرپرست را انتخاب کنید.
    2. میزبان‌های مجازی را انتخاب کنید.
    3. برای هر محیط، از فیلتر جستجو برای تعیین میزبان‌های مجازی که با نام مستعار میزبان خاصی که درخواست‌های میانای API با آن فراخوانی شده است مطابقت دارند استفاده کنید.
    4. اگر چند میزبان مجازی را پیدا کردید که از نام مستعار میزبان یکسانی استفاده می‌کنند، برای حل این مشکل به وضوح بروید.

    برای مثال:

  2. در میانای کاربر کلاسیک در «ابر خصوصی»:
    1. برگه APIs را انتخاب کنید.
    2. پیکربندی محیط را انتخاب کنید.
    3. میزبان‌های مجازی را انتخاب کنید.
    4. برای هر محیط، فهرست میزبان‌های مجازی را مشاهده کنید تا ببینید آیا با نام مستعار میزبان خاصی که درخواست‌های API با آن فراخوانی شده است مطابقت دارد یا خیر.
    5. اگر چند میزبان مجازی پیدا کردید که با همان نام مستعار میزبان مطابقت دارند، برای رفع این مشکل به راه‌حل بروید.

    برای مثال:

میاناهای برنامه‌سازی کاربردی مدیریت

از این دستورالعمل‌ها برای تعیین اینکه آیا چندین میزبان مجازی با میزبان یکسان نام مستعار/درگاه # بااستفاده از Management APIs وجود دارد یا نه استفاده کنید.

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

    برای مثال، اگر خطای 404 را با نشانی وب http://example.com:9001/proxy1 مشاهده کردید، باید پیدا کنید کدام میزبان‌های مجازی نام مستعار میزبان example.com و درگاه 9001 را دارند.

    1. دریافت فهرست محیط‌ها

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

      curl -v -X GET https//api.enterprise.apigee.com/v1/organizations/ORGANIZATION_NAME/environments -u USERNAME
      

      کاربر «ابر خصوصی»:

      curl -v -X GET http://MANAGEMENT_HOST:PORT#/v1/organizations/ORGANIZATION_NAME/environments -u USERNAME
      

      مکان:

      ORGANIZATION_NAME نام سازمان است

      مثال:

      curl http://127.0.0.1:8080/v1/organizations/myorg/environments -u USERNAME
      
      [ "prod", "test", "dev" ]
    2. دریافت فهرست میزبانان مجازی در محیط

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

      curl -v -X GET https//api.enterprise.apigee.com/v1/organizations/ORGANIZATION_NAME/environments/ENVIRONMENT_NAME/virtualhosts -u USERNAME
      

      کاربر «ابر خصوصی»:

      curl -v -X GET http://MANAGEMENT_HOST:PORT#/v1/organizations/ORGANIZATION_NAME/environments/ENVIRONMENT_NAME/virtualhosts -u USERNAME
      

      مکان:

      ORGANIZATION_NAME نام سازمان است

      ‫ENVIRONMENT_NAME نام محیط است

      مثال:

      curl http://127.0.0.1:8080/v1/organizations/myorg/environments/test/virtualhosts -u USERNAME
      
      [ "default" ]
    3. تعریف هریک از میزبان‌های مجازی در محیط را دریافت کنید.

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

      curl -v -X GET https//api.enterprise.apigee.com/v1/organizations/ORGANIZATION_NAME/environments/ENVIRONMENT_NAME/virtualhosts/VIRTUAL_HOST_NAME  -u USERNAME
      

      کاربر «ابر خصوصی»:

      curl -v -X GET http://MANAGEMENT_HOST:PORT#/v1/organizations/ORGANIZATION_NAME/environments/ENVIRONMENT_NAME/virtualhosts/VIRTUAL_HOST_NAME -u USERNAME
      

      مکان:

      ORGANIZATION_NAME نام سازمان است

      ‫ENVIRONMENT_NAME نام محیط است

      ‫VIRTUAL_HOST_NAME نام میزبان مجازی است

      مثال:

      curl http://127.0.0.1:8080/v1/organizations/myorg/environments/test/virtualhosts/default -u USERNAME
      
      {
        "hostAliases" : [ "example.com" ],
        "interfaces" : [ ],
        "listenOptions" : [ ],
        "name" : "default",
        "port" : "9001",
        "retryOptions" : [ ]
      }
    4. دو مرحله بالا را برای محیط‌های دیگر در سازمانتان تکرار کنید.

      در این مثال، مراحل را برای محیط dev تکرار کنید:

      curl http://127.0.0.1:8080/v1/organizations/myorg/environments/dev/virtualhosts -u USERNAME
      
      [ "default" ]
      curl http://127.0.0.1:8080/v1/organizations/myorg/environments/dev/virtualhosts/default -u USERNAME
      
      {
        "hostAliases" : [ "example.com" ],
        "interfaces" : [ ],
        "listenOptions" : [ ],
        "name" : "default",
        "port" : "9001",
        "retryOptions" : [ ]
      }

      در این مثال می‌بینید که دو میزبان مجازی default در دو محیط مختلف، test و dev، هر دو دارای نام مستعار میزبان یکسان example.com و شماره درگاه 9001 هستند. این دلیل 404 خطا است.

    5. اگر چند میزبان مجازی پیدا کردید که با همان نام مستعار میزبان مطابقت دارند، برای رفع این مشکل به راه‌حل بروید.

وضوح

  1. مطمئن شوید که هر میزبان مجازی فقط شامل ترکیب‌های یکتای نام مستعار میزبان و درگاه باشد.
  2. اگر چندین میزبان مجازی را با ترکیب‌های یکسان نام مستعار میزبان و درگاه شناسایی کرده‌اید، باید آن‌ها را با نام مستعار میزبان یکتا به‌روز کنید.
  3. می‌توانید این موارد را بااستفاده از «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت» به‌روز کنید. دستورالعمل‌ها را می‌توانید در بخش تغییر دادن میزبان مجازی پیدا کنید.
  4. مطمئن شوید که هر نام مستعار میزبان ورودی ساناد دامنه مناسبی داشته باشد.
  5. در مثال بالا، اگر پیکربندی ما به این شکل باشد:
    curl -X GET http://localhost:8080/v1/organizations/myorg/environments -u user
    
    [ "prod", "test", "dev" ]
    curl -X GET http://localhost:8080/v1/organizations/myorg/environments/test/virtualhosts/default -u user
    
    {
      "hostAliases" : [ "example.com" ],
      "interfaces" : [  ],
      "listenOptions" : [  ],
      "name" : "default",
      "port" : "9001",
      "retryOptions" : [  ]
    }
    curl -X GET http://localhost:8080/v1/organizations/myorg/environments/dev/virtualhosts/default -u user
    
    {
      "hostAliases" : [ "example.com" ],
      "interfaces" : [  ],
      "listenOptions" : [  ],
      "name" : "default",
      "port" : "9001",
      "retryOptions" : [  ]
    }
    1. می‌توانید میزبان مجازی نادرست را به‌روز کنید تا هم‌پوشانی نداشته باشند.
    2. یعنی نام مستعار میزبان را به example2.com به‌روز کنید.
    3. مطمئن شوید نام مستعار میزبان جدید ورودی ساناد مشابهی با نام مستعار میزبان قبلی داشته باشد.
      curl -X GET http://localhost:8080/v1/organizations/myorg/environments/dev/virtualhosts/default -u user -H 'Content-Type: application/json' -d '{
        "hostAliases" : [ "example2.com" ],
        "interfaces" : [  ],
        "listenOptions" : [  ],
        "name" : "default",
        "port" : "9001",
        "retryOptions" : [  ]
      }' -i
      
      HTTP/1.1 200 OK
      Date: Tue, 02 Feb 2021 20:54:29 GMT
      Content-Type: application/json
      X-Apigee.user: user
      X-Apigee.organization: myorg
      X-Apigee.environment: dev
      X-Apigee.backends: management-server
      Date: Tue, 02 Feb 2021 20:54:29 GMT
      Content-Length: 152
      
      {
        "hostAliases" : [ "example2.com" ],
        "interfaces" : [  ],
        "listenOptions" : [  ],
        "name" : "default",
        "port" : "9001",
        "retryOptions" : [  ]
      }
  6. فراخوان‌های API را دوباره به پراکسی ارسال کنید و مطمئن شوید که به‌طور مداوم پاسخ‌های موفقیت‌آمیز دریافت می‌کنید:
    curl http://example.com:9001/proxy1
    
    {
        "slideshow": {
    	    "author": "Yours Truly",
    		"date": "date of publication",
    		"slides": [
    		    {
    			    "title": "Wake up to WonderWidgets!",
    				"type:": "all"
    			},
    			{
    			    "items": [
    				    "Why WonderWidgets are great",
    					"Who buys WonderWidgets"
    				],
    				"title": "Overview",
    				"type": "all"
    			}
    		],
    		"title": "Sample Slide Show"
        }
    
    }
  7. اگر مشکل همچنان ادامه داشت، به باید اطلاعات تشخیصی را جمع‌آوری کنید بروید.

باید اطلاعات تشخیص خرابی را جمع‌آوری کند

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

اگر کاربر «ابر عمومی» هستید، اطلاعات زیر را ارائه دهید:

  • نام سازمان
  • نام محیط
  • نام پراکسی میانای برنامه‌سازی کاربردی
  • برای بازتولید خطای 404، فرمان curl را تکمیل کنید
  • اگر خطاهای 404 درحال‌حاضر رخ نمی‌دهد، دوره زمانی را با اطلاعات منطقه زمانی که خطاهای 404 در گذشته رخ داده است ارائه دهید.

اگر کاربر «ابر خصوصی» هستید، اطلاعات زیر را ارائه دهید:

  • پیام خطای کامل مشاهده‌شده برای درخواست‌های ناموفق
  • نام سازمان، نام محیط، و نام «پراکسی API» که برای آن 404 خطا مشاهده می‌کنید
  • دسته «پراکسی میانای برنامه‌سازی کاربردی»
  • گزارش‌های دسترسی NGINX
    /opt/apigee/var/log/edge-router/nginx/ORGANIZATION_NAME~ENVIRONMENT_NAME.PORT#_access_log
  • گزارش‌های «پردازشگر پیام»
    /opt/apigee/var/log/edge-message-processor/logs/system.log
  • دوره زمانی با اطلاعات منطقه زمانی که خطاهای 404 رخ داده است