درحال مشاهده اسناد 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 مفید خواهد بود.
برای بررسی گزارشها، از مراحل زیر استفاده کنید:
- بااستفاده از فرمان زیر، گزارشهای NGINX را مشاهده کنید:
/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log
- فیلدهای زیر را در ورودیهای گزارش بررسی کنید:
فیلد مقدار Upstream_status, status404X-Apigee-fault-codemessaging.adaptors.http.flow.ApplicationNotFoundشناسه پیام را از گزارشها یادداشت کنید.
- گزارشهای «پردازشگر پیام» را بررسی کنید
(
/opt/apigee/var/log/edge-message-processor/logs/system.log)تا ببینید آیاmessaging.adaptors.http.flow.ApplicationNotFoundرا برای میانای برنامهسازی کاربردی خاص دارید یا شناسه پیام منحصربهفرد مرحله ۲ را برای درخواست میانای برنامهسازی کاربردی دارید.پیام خطای نمونه از گزارش «پردازشگر پیام»
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 را دارند.
- در ابر عمومی و میانای کاربر Edge جدید در ابر خصوصی:
- سرپرست را انتخاب کنید.
- میزبانهای مجازی را انتخاب کنید.
- برای هر محیط، از فیلتر جستجو برای تعیین میزبانهای مجازی که با نام مستعار میزبان خاصی که درخواستهای میانای API با آن فراخوانی شده است مطابقت دارند استفاده کنید.
- اگر چند میزبان مجازی را پیدا کردید که از نام مستعار میزبان یکسانی استفاده میکنند، برای حل این مشکل به وضوح بروید.
برای مثال:

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

میاناهای برنامهسازی کاربردی مدیریت
از این دستورالعملها برای تعیین اینکه آیا چندین میزبان مجازی با میزبان یکسان نام مستعار/درگاه # بااستفاده از Management APIs وجود دارد یا نه استفاده کنید.
تعریف هریک از میزبانهای مجازی را در هریک از محیطهای سازمانتان دریافت کنید تا ببینید کدام میزبانهای مجازی نام مستعار میزبان و شماره درگاه یکسانی دارند:
برای مثال، اگر خطای
404را با نشانی وبhttp://example.com:9001/proxy1مشاهده کردید، باید پیدا کنید کدام میزبانهای مجازی نام مستعار میزبانexample.comو درگاه9001را دارند.دریافت فهرست محیطها
کاربر «ابر عمومی»:
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" ]
دریافت فهرست میزبانان مجازی در محیط
کاربر «ابر عمومی»:
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" ]
تعریف هریک از میزبانهای مجازی در محیط را دریافت کنید.
کاربر «ابر عمومی»:
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" : [ ] }دو مرحله بالا را برای محیطهای دیگر در سازمانتان تکرار کنید.
در این مثال، مراحل را برای محیط
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خطا است.- اگر چند میزبان مجازی پیدا کردید که با همان نام مستعار میزبان مطابقت دارند، برای رفع این مشکل به راهحل بروید.
وضوح
- مطمئن شوید که هر میزبان مجازی فقط شامل ترکیبهای یکتای نام مستعار میزبان و درگاه باشد.
- اگر چندین میزبان مجازی را با ترکیبهای یکسان نام مستعار میزبان و درگاه شناسایی کردهاید، باید آنها را با نام مستعار میزبان یکتا بهروز کنید.
- میتوانید این موارد را بااستفاده از «واسط کاربر Edge» یا «میانای برنامهسازی کاربردی مدیریت» بهروز کنید. دستورالعملها را میتوانید در بخش تغییر دادن میزبان مجازی پیدا کنید.
- مطمئن شوید که هر نام مستعار میزبان ورودی ساناد دامنه مناسبی داشته باشد.
- در مثال بالا، اگر پیکربندی ما به این شکل باشد:
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" : [ ] }- میتوانید میزبان مجازی نادرست را بهروز کنید تا همپوشانی نداشته باشند.
- یعنی نام مستعار میزبان را به
example2.comبهروز کنید. - مطمئن شوید نام مستعار میزبان جدید ورودی ساناد مشابهی با نام مستعار میزبان قبلی داشته باشد.
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" : [ ] }' -iHTTP/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" : [ ] }
- فراخوانهای 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" } }
- اگر مشکل همچنان ادامه داشت، به باید اطلاعات تشخیصی را جمعآوری کنید بروید.
باید اطلاعات تشخیص خرابی را جمعآوری کند
اگر مشکل حتی پساز دنبال کردن دستورالعملهای بالا برطرف نشد، اطلاعات تشخیصی زیر را جمعآوری کنید و سپس با پشتیبانی 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رخ داده است