درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نشانه
وقتی Envoy Proxy ازطریق
وقثدهنده Apigee برای Envoy فراخوانی میشود، با خطای HTTP 403 Forbidden مواجه میشود.
پیام خطا
پیام خطای زیر نمایش داده میشود:
HTTP/1.1 403 Forbidden content-length: 19 content-type: text/plain date: Tue, 03 Nov 2020 00:20:10 GMT server: istio-envoy
علل احتمالی
اگر یکی از شرایط زیر رخ دهد، پراکسی Envoy خطای HTTP 403 ایجاد میکند:
| علت | شرح | دستورالعملهای عیبیابی برای موارد زیر قابلاجرا است |
|---|---|---|
| محصول میانای برنامهسازی کاربردی فعال نیست | محصول API برای محیط خاص فعال نیست. | کاربران «فضای ابری خصوصی و عمومی لبهای» |
| مسیر نشانی وب سرویس هدف در «محصول API» وجود ندارد | مسیر نشانی وب سرویس هدف وجود ندارد یا به محصول API در بخش منابع API اضافه نشده است. | کاربران «فضای ابری خصوصی و عمومی لبهای» |
| نام میزبان در «محصول API» وجود ندارد | نام میزبان ارائهشده در درخواست API مشتری در محصول API در Apigee هدفهای سرویس از دور وجود ندارد. | کاربران «فضای ابری خصوصی و عمومی لبهای» |
| کلید میانای برنامهسازی کاربردی در سرایند درخواست وجود ندارد | کلید API در سرصفحه HTTP x-api-key ارسال نشده است. |
کاربران «فضای ابری خصوصی و عمومی لبهای» |
| کلید میانای برنامهسازی کاربردی نامعتبر است | کلید API که بهعنوان بخشی از درخواست ارسال شده است نامعتبر است. | کاربران «فضای ابری خصوصی و عمومی لبهای» |
| «وقثدهنده Apigee برای Envoy» نمیتواند با پراکسی API سرویس از دور ارتباط برقرار کند | «وقثدهنده Apigee برای Envoy» نمیتواند با پراکسی میانای برنامهسازی کاربردی سرویس راه دور ارتباط برقرار کند. | کاربران «فضای ابری خصوصی و عمومی لبهای» |
| پراکسی Envoy نمیتواند با «وقثدهنده Apigee برای Envoy» ارتباط برقرار کند | پراکسی Envoy نمیتواند با «وقثدهنده Apigee برای Envoy» ارتباط برقرار کند | کاربران «فضای ابری خصوصی و عمومی لبهای» |
قبلاز شروع
- تأیید کنید که پیام پاسخ
403 Forbiddenرا از پراکسی Envoy دریافت میکنید. برای مثال:curl -i -H "x-api-key: $API_KEY" http://httpbin:8080/echo HTTP/1.1 403 Forbidden content-length: 19 content-type: text/plain date: Tue, 12 Jan 2021 08:18:08 GMT server: envoy RBAC: access denied
فعال کردن گزارشهای اشکالزدایی:
برای دریافت جزئیات بیشتر درباره خطا، مطمئن شوید که گزارشهای اشکالزدایی را در «آداپتور Apigee برای Envoy» فعال کردهاید. درغیراینصورت، «آداپتور Apigee برای Envoy» را متوقف کنید و آن را دوباره با فعال کردن گزارشهای اشکالزدایی بااستفاده از فرمان زیر شروع کنید:
apigee-remote-service-envoy -c config.yaml -l debug
دلیل: محصول API فعال نیست
اگر «محصول میانای برنامهسازی کاربردی» خاصی که «پراکسی Envoy» استفاده میکند در محیط خاصی که فراخوانیهای میانای برنامهسازی کاربردی در آن فراخوانده میشود فعال نباشد، این خطا رخ میدهد.
تشخیص
برای تشخیص مشکل، مراحل زیر را انجام دهید:
- گزارشهای اشکالزدایی را همانطور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
- گزارشهای «وقثدهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید پیام زیر در بخش
Authorizing requestنمایش داده میشود:product: API_PRODUCT_NAME not found
نمونه برونداد گزارش اشکالزدایی:
2021-01-12T08:18:08.124Z DEBUG auth/auth.go:98 Authenticate: key: 7mQIG..., claims: map[string]interface {}(nil) 2021-01-12T08:18:08.124Z DEBUG auth/verify_api_key.go:106 fetchToken fetching: 7mQIG... 2021-01-12T08:18:08.589Z DEBUG auth/auth.go:125 using api key from request 2021-01-12T08:18:08.589Z DEBUG auth/auth.go:157 Authenticate success: &auth.Context{Context:(*server.Handle r)(0xc0001a0600), ClientID:"7mQIG...", AccessToken:"", Application:"ENVOY-APP-1", APIProducts:[]string{"ENVOY-PRODUCT-1"}, Expires:time.Time{wall:0x0, ext:63746037188, loc:(*time.Location)(0x14a3be0)}, DeveloperEmail:"[---masked---]", Scopes:[] string{""}, APIKey:"7mQIG..."} 2021-01-12T08:18:08.589Z DEBUG product/manager.go:89 Authorizing request: products: [ENVOY-PRODUCT-1] scopes: [] operation: GET /echo target: httpbin:8080 - product: ENVOY-PRODUCT-1 not found
مثال بالا نشان میدهد که محصول API
ENVOY-PRODUCT-1در «وقثدهنده Apigee برای Envoy» پیدا نشد.برای کسب اطلاعات بیشتر درباره ثبت گزارش «وقثدهنده Apigee برای Envoy»، به ثبت گزارش مراجعه کنید.
- اگر این پیام را هنگام مجاز کردن درخواست میانای برنامهسازی کاربردی مشاهده کردید، احتمالاً نشان میدهد که «محصول میانای برنامهسازی کاربردی» خاص برای محیط خاصی که در آن فراخوانیهای میانای برنامهسازی کاربردی را انجام میدهید فعال نیست.
- برای درستیسنجی این موضوع، مراحل زیر را انجام دهید:
- به سیستم میانای کاربر Edge وارد شوید.
- در صفحه انتشار > محصولات API، روی محصول API خاصی که برای پیکربندی «آداپتور Apigee برای Envoy» استفاده کردهاید کلیک کنید.
- تأیید کنید که محیط خاصی که در آن درخواستهای API را انجام میدهید، در محصول API فعال باشد.
- اگر محیط خاصی در «محصول API» فعال نباشد، دلیل این مشکل همین است.
- اگر محیط خاص ازقبل فعال شده است، به علت: مسیر نشانی وب سرویس هدف در «محصول API» وجود ندارد بروید.
وضوح
اگر محیط خاص در محصول API فعال نباشد، مراحل زیر را برای حل مشکل انجام دهید:
- به سیستم میانای کاربر Edge وارد شوید.
- در صفحه انتشار > محصولات API، روی محصول API خاصی که برای پیکربندی «آداپتور Apigee برای Envoy» استفاده کردهاید کلیک کنید.
- در صفحه محصولات API > نام محصول، روی ویرایش کلیک کنید.
- محیط خاصی را که میخواهید در آن درخواستهای API ایجاد کنید با انتخاب چارگوش انتخاب محیط مربوطه فعال کنید.
- روی ذخیره کلیک کنید.
دلیل: مسیر نشانی وب سرویس هدف در محصول میانای برنامهسازی کاربردی وجود ندارد
اگر مسیر نشانی وب هدف در «محصول میانای برنامهسازی کاربردی» خاصی که Envoy Proxy استفاده میکند مشخص نشده باشد، این خطا رخ میدهد.
تشخیص
برای تشخیص مشکل، مراحل زیر را انجام دهید:
- گزارشهای اشکالزدایی را همانطور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
-
گزارشهای «آداپتور Apigee برای Envoy» را بررسی کنید و مطمئن شوید که پیام زیر برای «محصول API» خاص مرتبط با هدف خاص در بخش
Authorizing requestنمایش داده میشود:no path: REQUEST_URI_PATH
نمونه برونداد گزارش اشکالزدایی:
2021-01-12T08:09:02.604Z DEBUG auth/auth.go:98 Authenticate: key: 7mQIG..., claims: map[string]interface {}(nil) 2021-01-12T08:09:02.605Z DEBUG auth/auth.go:125 using api key from request 2021-01-12T08:09:02.605Z DEBUG auth/auth.go:157 Authenticate success: &auth.Context{Context:(*server.Handle r)(0xc0001a4180), ClientID:"7mQIG...", AccessToken:"", Application:"ENVOY-APP-1", APIProducts:[]string{"ENVOY-PRODUCT-1"}, Expires:time.Time{wall:0x0, ext:63746036507, loc:(*time.Location)(0x14a3be0)}, DeveloperEmail:"[---masked---]", Scopes:[] string{""}, APIKey:"7mQIG..."} 2021-01-12T08:09:02.605Z DEBUG product/manager.go:89 Authorizing request: products: [ENVOY-PRODUCT-1] scopes: [] operation: GET /echo1 target: httpbin:8080 - product: ENVOY-PRODUCT-1 no path: /echo1 2021-01-12T08:09:02.605Z DEBUG server/authorization.go:228 sending ok (actual: PERMISSION_DENIED)
برونداد نمونه پیام زیر را نشان میدهد:
no path: /echo1
این نشان میدهد که مسیر
/echo1در محصول APIENVOY-PRODUCT-1پیدا نشد. - اگر پیام
no path: REQUEST_URI_PATHرا در گزارشهای اشکالزدایی «آداپتور Apigee برای Envoy» میبینید، این پیام دلیل این مشکل است. اگر اینطور نیست، به علت: نام میزبان در محصول API وجود ندارد بروید.
وضوح
اگر «شناسه منبع یکنواخت» درخواست ویژه به «محصول API» برای هدف ویژه اضافه نشده است، مراحل زیر را برای حلوفصل مشکل انجام دهید:
- به سیستم میانای کاربر Edge وارد شوید.
- در صفحه انتشار > محصولات API، روی محصول API خاصی که برای پیکربندی «آداپتور Apigee برای Envoy» استفاده کردهاید کلیک کنید.
- در صفحه محصولات API > نام محصول، روی ویرایش کلیک کنید.
- در قاب منابع API، نشانی وب درخواست API را به محصول API اضافه کنید.
- گزارشهای «وقثدهنده Apigee برای Envoy» را پایش کنید و منتظر بمانید تا «وقثدهنده Apigee برای Envoy» محصول API بهروزشده را واکشی کند. پساز آن، درخواست API دیگری برای درستیسنجی اصلاح ارسال کنید.
دلیل: نام میزبان در محصول «میانای برنامهسازی کاربردی» وجود ندارد
اگر ترکیب نام میزبان و درگاه هدف به «محصول API» خاصی که Envoy Proxy استفاده میکند اضافه نشده باشد، این خطا رخ خواهد داد.
تشخیص
برای تشخیص مشکل، مراحل زیر را انجام دهید:
- گزارشهای اشکالزدایی را همانطور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
گزارشهای «آداپتور Apigee برای Envoy» را بررسی کنید و مطمئن شوید که پیام زیر برای «محصول API» خاص مرتبط با هدف خاص در بخش
Authorizing requestنمایش داده میشود:no targets: HOSTNAME:PORT
نمونه برونداد گزارش اشکالزدایی:
2021-01-12T08:12:06.019Z DEBUG auth/auth.go:98 Authenticate: key: 7mQIG..., claims: map[string]interface {}(nil) 2021-01-12T08:12:06.019Z DEBUG auth/auth.go:125 using api key from request 2021-01-12T08:12:06.019Z DEBUG auth/auth.go:157 Authenticate success: &auth.Context{Context:(*server.Handle r)(0xc0001a4180), ClientID:"7mQIG...", AccessToken:"", Application:"ENVOY-APP-1", APIProducts:[]string{"ENVOY-PRODUCT-1"}, Expires:time.Time{wall:0x0, ext:63746036507, loc:(*time.Location)(0x14a3be0)}, DeveloperEmail:"[---masked---]", Scopes:[] string{""}, APIKey:"7mQIG..."} 2021-01-12T08:12:06.019Z DEBUG product/manager.go:89 Authorizing request: products: [ENVOY-PRODUCT-1] scopes: [] operation: GET /echo target: httpbin1:8080 - product: ENVOY-PRODUCT-1 no targets: httpbin1:8080 2021-01-12T08:12:06.020Z DEBUG server/authorization.go:228 sending ok (actual: PERMISSION_DENIED)
مثال بالا نشان میدهد که ترکیب نام میزبان و درگاه
httpbin1:8080در محصول APIENVOY-PRODUCT-1پیدا نشد.- اگر گزارشهای «وقثدهنده Apigee برای Envoy» حاوی ورودی با پیام
no targets: HOSTNAME:PORTدرحین مجاز کردن درخواست باشد، این دلیل مشکل است. اگر اینطور نیست، به علت: کلید میانای برنامهسازی کاربردی در سرایند درخواست وجود ندارد.
وضوح
اگر ترکیب نام میزبان و درگاه هدف به محصول API اضافه نشده است، مراحل زیر را برای حل مشکل انجام دهید:
- به سیستم میانای کاربر Edge وارد شوید.
- در صفحه انتشار > محصولات API، روی محصول API خاصی که برای پیکربندی «آداپتور Apigee برای Envoy» استفاده کردهاید کلیک کنید.
- در صفحه محصولات API > نام محصول، روی ویرایش کلیک کنید.
در قاب هدفهای سرویس راه دور Apigee، نام میزبان هدف و درگاه را اضافه کنید و روی ذخیره کردن کلیک کنید.
اگر بخش هدفهای سرویس راه دور Apigee را در واسط کاربر نمیبینید، با نام
apigee-remote-service-targetsبه محصول API یک مشخصه سفارشی اضافه کنید و مقدار HOSTNAME:PORT را بااستفاده از Edge API اضافه کنید. برای مثال:curl https://api.enterprise.apigee.com/v1/organizations/$ORG/apiproducts/$ENVOY_PRODUCT \ -X GET \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type:application/json" \ -d \ { "apiResources": [ "/echo", "/verifyApiKey" ], "approvalType": "auto", "attributes": [ { "name": "access", "value": "public" }, { "name": "apigee-remote-service-targets", "value": "localhost:8080" } ], "createdAt": 1610435989556, "createdBy": "---masked---", "description": "", "displayName": "ENVOY-PRODUCT-1", "environments": [ "test" ], "lastModifiedAt": 1612234134060, "lastModifiedBy": "---masked---", "name": "ENVOY-PRODUCT-1", "proxies": [ "remote-service" ], "scopes": [] }- پساز انجام تکلیف بالا، گزارشهای «وقثدهنده Apigee برای Envoy» را پایش کنید و منتظر بمانید تا «وقثدهنده Apigee برای Envoy» محصول API بهروزشده را واکشی کند. پساز آن، درخواست API دیگری برای درستیسنجی اصلاح ارسال کنید.
دلیل: کلید API در سرایند درخواست وجود ندارد
اگر «کلید میانای برنامهسازی کاربردی» بهعنوان بخشی از سرایندهای درخواست ارسال نشود، این خطا رخ خواهد داد.
تشخیص
برای تشخیص مشکل، مراحل زیر را انجام دهید:
- گزارشهای اشکالزدایی را همانطور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
- گزارشهای «وقثدهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید پیام
[missing authentication]را در بخشAuthenticate errorمیبینید.نمونه برونداد گزارش اشکالزدایی:
2021-01-12T08:20:31.461Z DEBUG auth/auth.go:98 Authenticate: key: , claims: map[string]interface {}(nil) 2021-01-12T08:20:31.461Z DEBUG auth/auth.go:159 Authenticate error: &auth.Context{Context:(*server.Handler) (0xc0001a0600), ClientID:"", AccessToken:"", Application:"", APIProducts:[]string(nil), Expires:time.Time{wall:0x0, ext:0, loc:(*time.Location)(nil)}, DeveloperEmail:"", Scopes:[]string(nil), APIKey:""} [missing authentication] 2021-01-12T08:20:31.461Z DEBUG server/authorization.go:205 sending denied: UNAUTHENTICATED 2021-01-12T08:20:32.448Z DEBUG server/header_context.go:68 No context header x-apigee-api, using target header : :authority
برونداد نمونه نشاندادهشده در بالا پیام
[missing authentication]را دارد. این پیام نشان میدهد که کلید API بهعنوان بخشی از سرایند درخواست ارسال نشده است. - اگر گزارشهای «وقثدهنده Apigee برای Envoy» حاوی ورودی گزارش با پیام
[missing authentication]در بخشAuthenticate errorباشد، این دلیل مشکل است. اگر اینطور نیست، به علت: کلید میانای برنامهسازی کاربردی نامعتبر بروید.
وضوح
اگر خطای [missing authentication] در
گزارشهای «آداپتور Apigee برای Envoy» نمایش داده شد، مراحل زیر را برای حل مشکل انجام دهید:
- بررسی کنید که آیا کارخواه کلید میانای برنامهسازی کاربردی را بااستفاده از سرایند HTTP
x-api-keyدر درخواست میانای برنامهسازی کاربردی ارسال کرده است یا نه. درغیراینصورت، از کارخواه بخواهید کلید API را در سرایند HTTPx-api-keyارسال کند. - فایل پیکربندی «آداپتور Apigee برای Envoy» را بررسی کنید و مطمئن شوید نام سرایند کلید API پیشفرض
x-api-keyتغییر کرده باشد، برای مثال:apiVersion: v1 kind: ConfigMap metadata: name: apigee-remote-service-envoy namespace: apigee data: config.yaml: | global: tls: ... tenant: ... auth: target_header: api-keyدر مثال بالا، نام سرایند «کلید API» پیشفرض به
api-keyتغییر کرده است. در این مورد، باید «کلید API» را بهعنوان بخشی از سرایندapi-keyارسال کنید. - اگر نام سرایند کلید API پیشفرض تغییر کرده است، از کارخواه بخواهید از نام سرایند کلید API بهروزشده استفاده کند و درخواست API دیگری ارسال کند و بررسی کند که آیا مشکل حل میشود یا نه.
دلیل: کلید میانای برنامهسازی کاربردی نامعتبر است
اگر «کلید API» نامعتبر بهعنوان بخشی از سرایند درخواست ارسال شود، این خطا رخ خواهد داد.
تشخیص
برای تشخیص مشکل، مراحل زیر را انجام دهید:
- گزارشهای اشکالزدایی را همانطور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
- گزارشهای «وقثدهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید پیام
[permission denied]را در بخشAuthenticate errorمیبینید. این پیام معمولاً پساز آنکه «کلید API» توسط «آداپتور» واکشی شد نمایش داده میشود که با پیامfetchToken fetching: API_KEYنشان داده میشود.نمونه برونداد گزارش اشکالزدایی:
2021-01-12T05:01:07.198Z DEBUG auth/auth.go:98 Authenticate: key: 123, claims: map[string]interface {}(nil) 2021-01-12T05:01:07.198Z DEBUG auth/verify_api_key.go:106 fetchToken fetching: API_KEY 2021-01-12T05:01:09.102Z DEBUG server/header_context.go:68 No context header x-apigee-api, using target header: :authority 2021-01-12T05:01:09.831Z DEBUG auth/auth.go:159 Authenticate error: &auth.Context{Context:(*server.Handler)(0xc0001640c0), ClientID:"", AccessToken:"", Application:"", APIProducts:[]string(nil), Expires:time.Time{wall:0x0, ext:0, loc:(*time.Location)(nil)}, DeveloperEmail:"", Scopes:[]string(nil), APIKey:""} [permission denied] 2021-01-12T05:01:09.832Z DEBUG server/authorization.go:228 sending ok (actual: PERMISSION_DENIED)
در این مثال، کلید میانای API ارسالشده در درخواست API معتبر نبود.
- اگر گزارشهای «آداپتور Apigee برای Envoy» حاوی ورودی گزارشی با
[permission denied]در بخشAuthenticate errorباشد، نشان میدهد که «کلید API» که بهعنوان بخشی از درخواست ارسال شده است نامعتبر است و دلیل مشکل همین است. درغیراینصورت، به علت: «وقثدهنده Apigee برای Envoy» نمیتواند با پراکسی API سرویس از دور ارتباط برقرار کند.
وضوح
اگر پیام [permission denied] در بخش Authenticate
error در گزارشهای «آداپتور Apigee برای Envoy» مشاهده شد، مراحل زیر را برای حل کردن مشکل انجام دهید:
:
- کلید میانای برنامهسازی کاربردی ارسالشده در درخواست میانای برنامهسازی کاربردی را با مقدار کلید میانای برنامهسازی کاربردی موجود در برنامه متصل به محصول میانای برنامهسازی کاربردی بررسی کنید.
- اگر کلید API استفادهشده توسط مشتری معتبر نیست، از مشتری بخواهید کلید API معتبر را ارسال کند.
- اگر کلید API استفادهشده توسط مشتری معتبر است و همچنان خطای HTTP
403را میبینید، لطفاً با پشتیبانی Apigee Edge تماس بگیرید تا این موضوع را بیشتر بررسی کنند.
دلیل: «وقثدهنده Apigee برای Envoy» نمیتواند با پراکسی «میانای برنامهسازی کاربردی سرویس از دور» ارتباط برقرار کند
اگر «میانای Apigee برای Envoy» نتواند با «پراکسی API سرویس راه دور» ارتباط برقرار کند، این خطا رخ میدهد اگر میزبان سرویس راه دور پیکربندیشده نامعتبر باشد.
تشخیص
برای تشخیص مشکل، مراحل زیر را انجام دهید:
- گزارشهای اشکالزدایی را همانطور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
-
گزارشهای «وقثدهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید که پیام زیر را میبینید:
Error retrieving products: REQUEST_URI: no such host
نمونه برونداد گزارش اشکالزدایی:
2021-01-12T08:29:06.499Z DEBUG product/manager.go:188 retrieving products from: https://foo/remote-service/products 2021-01-12T08:29:06.505Z ERROR product/manager.go:164 Error retrieving products: GET "https://foo/remote-service/pro ducts": dial tcp: lookup foo on 169.254.169.254:53: no such host github.com/apigee/apigee-remote-service-golib/product.(*manager).start.func1 /go/pkg/mod/github.com/apigee/apigee-remote-service-golib@v1.4.0/product/manager.go:164 github.com/apigee/apigee-remote-service-golib/util.(*Looper).Run /go/pkg/mod/github.com/apigee/apigee-remote-service-golib@v1.4.0/util/looper.go:87 github.com/apigee/apigee-remote-service-golib/util.(*Looper).Start.func1 /go/pkg/mod/github.com/apigee/apigee-remote-service-golib@v1.4.0/util/looper.go:59
در این مثال، «آداپتور Apigee برای Envoy» نتوانست با پراکسی API سرویس راه دور ارتباط برقرار کند زیرا نام میزبان ارائهشده در نشانی وب پراکسی API سرور راه دور معتبر نیست، همانطور که خطای
no such hostنشان میدهد . - اگر گزارشهای «وقثدهنده Apigee برای Envoy» حاوی ورودی گزارش با پیام
no such hostباشد، این دلیل مشکل است. اگر اینطور نیست، به علت: پراکسی Envoy نمیتواند با «وقثدهنده Apigee برای Envoy» ارتباط برقرار کند.
وضوح
اگر خطاهای بالا در گزارشهای «آداپتور Apigee برای Envoy» نمایش داده میشود، مراحل زیر را برای حلوفصل کردن مشکل انجام دهید:
فایل پیکربندی «آداپتور Apigee برای Envoy» را بررسی کنید و مطمئن شوید نشانی وب پراکسی API سرویس راه دور معتبر باشد.
اگر اینطور نیست، «وقثدهنده Apigee برای Envoy» را متوقف کنید، نشانی وب پراکسی API سرویس راه دور را در فایل پیکربندی اصلاح کنید، «وقثدهنده Apigee برای Envoy» را شروع کنید، و درخواست API دیگری ارسال کنید و اصلاح را درستیسنجی کنید.
پیکربندی نمونه:
apiVersion: v1 kind: ConfigMap metadata: name: apigee-remote-service-envoy namespace: apigee data: config.yaml: | tenant: internal_api: https://istioservices.apigee.net/edgemicro remote_service_api: https://ORG-ENV.apigee.net/remote-service org_name: ORG env_name: ENV key: KEY secret: SECRET- تأیید کنید که پراکسی
remote-serviceAPI در محیط Edge مربوطه مستقر شده باشد. اگر اینطور نیست، پراکسیremote-serviceAPI را در محیط Edge مربوطه مستقر کنید و دوباره امتحان کنید. - اتصالپذیری شبکه بین «آداپتور Apigee برای Envoy» و
نقطه پایانی پراکسی API
remote-serviceرا بهتأیید برسانید. اگر مشکلی در اتصالپذیری شبکه پیدا شد، با تیم شبکهسازی خود تماس بگیرید و سعی کنید مشکل را برطرف کنید.
دلیل: پراکسی Envoy نمیتواند با «وقثدهنده Apigee برای Envoy» ارتباط برقرار کند
تشخیص
برای تشخیص مشکل، مراحل زیر را انجام دهید:
مطمئن شوید گزارشهای اشکالزدایی را در Envoy فعال کردهاید. اگر اینطور نیست، Envoy را متوقف کنید و آن را دوباره شروع کنید، گزارشهای اشکالزدایی را فعال کنید. سپس درخواست API دیگری ارسال کنید.
استقرار مستقل:
envoy -c envoy-config.yaml -l debug
استقرار مبتنی بر Kubernetes/Istio:
kubectl -n=istio-system get pods kubectl -n=istio-system exec -it INGRESS_GATEWAY_NAME bash -- curl -X POST localhost:15000/logging?connection=debug
- گزارشهای «وقثدهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید ورودی گزارشی با این پیام وجود دارد:
connecting to APIGEE_ENVOY_ADAPTER_HOST:5000
که سپس با موارد زیر دنبال میشود:
upstream connect error or disconnect/reset before headers. reset reason: ACTUAL_REASON
نمونه برونداد گزارش اشکالزدایی:
[2021-03-23 05:44:41.867][1303661][debug][connection] [external/envoy/source/common/network/connection_impl.cc:769] [C4] connecting to 127.0.0.1:5000 [2021-03-23 05:44:41.867][1303661][debug][connection] [external/envoy/source/common/network/connection_impl.cc:785] [C4] connection in progress [2021-03-23 05:44:41.868][1303661][debug][http2] [external/envoy/source/common/http/http2/codec_impl.cc:1173] [C4] updating connection-level initial window size to 268435456 [2021-03-23 05:44:41.869][1303661][debug][connection] [external/envoy/source/common/network/connection_impl.cc:634] [C4] delayed connection error: 111 [2021-03-23 05:44:41.869][1303661][debug][connection] [external/envoy/source/common/network/connection_impl.cc:203] [C4] closing socket: 0 [2021-03-23 05:44:41.869][1303661][debug][client] [external/envoy/source/common/http/codec_client.cc:96] [C4] disconnect. resetting 0 pending requests [2021-03-23 05:44:41.869][1303661][debug][pool] [external/envoy/source/common/conn_pool/conn_pool_base.cc:314] [C4] client disconnected, failure reason: [2021-03-23 05:44:41.869][1303661][debug][router] [external/envoy/source/common/router/router.cc:1031] [C0][S6149963213555558594] upstream reset: reset reason: connection failure, transport failure reason: [2021-03-23 05:44:41.869][1303661][debug][http] [external/envoy/source/common/http/async_client_impl.cc:100] async http request response headers (end_stream=true): ':status', '200' 'content-type', 'application/grpc' 'grpc-status', '14' 'grpc-message', 'upstream connect error or disconnect/reset before headers. reset reason: connection failure'
مثال بالا نشان میدهد که Envoy بهدلیل
connection failureنتوانسته است با «وقثدهنده Apigee برای Envoy» ارتباط برقرار کند. connection failureمیتواند به دلایل متعددی باشد. بیایید هریک از این سناریوها را بررسی کنیم.
سناریو شماره ۱: فرایند آداپتور اجرا نمیشود
اگر فرایند «وقثدهنده Apigee برای Envoy» درحال اجرا نباشد، این خطا ممکن است رخ دهد.
- با اجرای فرمان زیر، مطمئن شوید فرایند «آداپتور Apigee برای Envoy» درحال اجرا است.
فرمان. اگر فرایند «وقثدهنده Apigee برای Envoy» درحال اجرا باشد، نتیجه فرمان زیر باید آن را فهرست کند.
ps -ef | grep apigee-remote-service-envoy
- اگر درحال اجرا نیست، پس این دلیل مشکل است.
وضوح
- اگر فرایند «وقثدهنده Apigee برای Envoy» اجرا نمیشود، «وقثدهنده Apigee برای Envoy» را شروع کنید.
- درخواست API دیگری ایجاد کنید و بررسی کنید که آیا مشکل برطرف شده است یا خیر.
سناریو شماره ۲: فرایند آداپتور در درگاه مشخصشده گوش نمیدهد
اگر فرایند «وقثدهنده Apigee برای Envoy» در درگاه مشخصی گوش نمیدهد، این خطا میتواند رخ دهد.
اگر فرایند «وقثدهنده Apigee برای Envoy» درحال اجرا است، بررسی کنید که یک سوکت درحال گوش دادن به
درگاه ۵۰۰۰ وجود داشته باشد: APIGEE_ENVOY_ADAPTER_HOST:5000. برای درستیسنجی این مورد میتوانید فرمان
netstat را اجرا کنید:
sudo netstat -lnp | grep 5000
برونداد نمونه:
sudo netstat -lnp | grep 5000 tcp6 0 0 :::5000 :::* LISTEN 1596530/./apigee-re
اگر هیچ سوکتی درحال گوش دادن به درگاه ۵۰۰۰ نباشد، این میتواند دلیل این مشکل باشد.
وضوح
- «وقثدهنده Apigee برای Envoy» را متوقف کنید و دوباره آن را شروع کنید.
- درخواست API دیگری ایجاد کنید و بررسی کنید که آیا مشکل برطرف شده است یا خیر.
سناریو شماره ۳: اتصالپذیری شبکه بین Envoy و «وقثدهنده Apigee برای Envoy»
- اتصالپذیری شبکه بین Envoy و «وقثدهنده Apigee برای Envoy» را درستیسنجی کنید:
ssh $ENVOY_HOST telnet $APIGEE_ENVOY_ADAPTER_HOST 5000
اگر telnet بتواند اتصال TCP به «آداپتور Apigee برای Envoy» برقرار کند بروندادی مشابه زیر نمایش داده خواهد شد:
telnet $APIGEE_ENVOY_ADAPTER_HOST 5000 Trying ::1... Connected to localhost. Escape character is '^]'.
- اگر خطای
Connection timed outرا با telnet مشاهده کردید، این نشان میدهد که مشکل اتصالپذیری شبکه بین Envoy و «آداپتور Apigee برای Envoy» وجود دارد.
وضوح
اگر مشکلی در اتصالپذیری شبکه بین Envoy و «آداپتور Apigee برای Envoy» مشاهده کردید، لطفاً با تیم شبکهتان تماس بگیرید و سعی کنید مشکل را حل کنید.
اگر مشکل همچنان ادامه داشت، به باید اطلاعات تشخیصی را جمعآوری کنید بروید.
باید اطلاعات تشخیص خرابی را جمعآوری کند
اگر مشکل پساز دنبال کردن دستورالعملهای بالا همچنان ادامه داشت، اطلاعات تشخیصی زیر را جمعآوری کنید و سپس با پشتیبانی Apigee Edge تماس بگیرید:
-
محصول Apigee استفادهشده:
مثال: Apigee Edge Cloud، Apigee OPDK، Apigee hybrid، Apigee X
- سازمان و محیط Apigee
تعریف محصول میانای برنامهسازی کاربردی خواندهشده بااستفاده از Edge API:
curl -i -u $USER:$PASSWORD $MANAGEMENT_SERVER_ENDPOINT/v1/organizations/$ORGANIZATION/apiproducts/$API_PRODUCT
بااستفاده از واسط کاربر Apigee Edge، جلسه ردیابی را در پراکسی API
remote-serviceشروع کنید. این مشکل را بازتولید کنید و فایل XML جلسه «ردیابی» را همرسانی کنید.گزارشهای «وقثدهنده Apigee برای Envoy» (گزارشهای کامل مربوط به دوره زمانی دادهشده)
استقرار مستقل:
# by default Apigee Envoy write logs to stdout and stderr, check your deployment configuration and collect logs accordingly
استقرار مبتنی بر Kubernetes/Istio:
kubectl -n=apigee get pods kubectl -n=apigee logs APIGEE_REMOTE_SERVICE_ENVOY_POD_NAME > apigee-remote-service-envoy.log
- درخواست API ارسالشده به پراکسی Envoy بااستفاده از فرمان
curl(برونداد کامل فرمانcurl):curl -v ENVOY_PROXY_ENDPOINT
- درخواست میانای برنامهسازی کاربردی که بااستفاده از فرمان
curlبه سرویس هدف ارسال شده است (برونداد کامل فرمانcurl):curl -v TARGET_SERVICE_ENDPOINT