‫۱۸-۰۲-۱۵ - یادداشت‌های انتشار ابری Apigee Edge

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

در سه‌شنبه ۱۷ فوریه ۲۰۱۵، نسخه ابری جدیدی از Apigee Edge منتشر کردیم.

ویژگی‌های جدید و بهبودها

در این نسخه پخش، ویژگی‌های جدید و موارد بهبودیافته زیر ارائه شده است.

بهبودهای Analytics

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

  • نمودارهای عملکرد برای «میاناهای برنامه‌سازی کاربردی»، «توسعه‌دهندگان»، «محصولات»، و «برنامه‌های توسعه‌دهنده» منتقل شده است. از آن‌ها برای نمایش در پایین صفحات اصلی این نهادها استفاده می‌شد. اکنون با انتخاب برگه Analytics در بالای هر صفحه به نمودارها دسترسی پیدا می‌کنید.
  • این نسخه شامل کار عمده روی این داشبوردهای موجود یا جدید است:
    • داشبورد Apigee (اصلاح‌شده): شامل سه نمودار سنجه است: ترافیک پراکسی، مشارکت توسعه‌دهنده، و برنامه‌های توسعه‌دهنده. هر نمودار نمای «جزئیات بیشتر» را ارائه می‌دهد که به شما امکان می‌دهد در هر سنجه‌ای دقیق شوید. داشبورد Apigee را ببینید.
    • عملکرد پراکسی (جدید): الگوهای ترافیک پراکسی API و زمان‌های پردازش را نشان می‌دهد. جایگزین داشبورد «عملکرد پراکسی API» می‌شود. عملکرد پراکسی میانای برنامه‌سازی کاربردی را ببینید.
    • ترکیب ترافیک (اصلاح‌شده): ظاهر و احساس داشبورد و محتواها کاملاً اصلاح شده است. سهم نسبی میاناهای برنامه‌سازی کاربردی، برنامه‌ها، توسعه‌دهندگان، و محصولات برتر شما را در برنامه کلی میانای برنامه‌سازی کاربردی شما اندازه‌گیری می‌کند. ترکیب ترافیک را ببینید.
    • تجزیه‌وتحلیل خطا (اصلاح‌شده): ظاهر و احساس و محتوای کاملاً اصلاح‌شده. نرخ‌های خطا را برای پراکسی‌های API و هدف‌ها نشان می‌دهد. داشبورد تجزیه‌وتحلیل کد خطا را ببینید.
  • نام این داشبوردهای موجود تغییر کرده است:
    • نام عملکرد نقطه پایانی به عملکرد هدف تغییر کرد: الگوهای ترافیک و سنجه‌های عملکرد را برای هدف‌های پشتیبان پراکسی API نشان می‌دهد. عملکرد هدف را ببینید.
    • نام تعامل شریک به تعامل توسعه‌دهنده تغییر کرد: نشان می‌دهد کدام‌یک از توسعه‌دهندگان نرم‌افزار ثبت‌شده شما بیشترین ترافیک میانای برنامه‌سازی کاربردی را تولید می‌کنند. برای هریک از توسعه‌دهندگان خود می‌توانید متوجه شوید که چه کسی بیشترین ترافیک API و بیشترین خطاها را تولید می‌کند. تعامل توسعه‌دهنده را ببینید.

گزینه‌های فیلتر کردن در واسط کاربر مدیریت

در صفحات «پراکسی‌های API»، «محصولات»، «توسعه‌دهندگان»، و «برنامه‌ها» در واسط کاربر مدیریت، گزینه‌های فیلتر کردن جدیدی برای جستجو دردسترس است.

ابزار ردیابی آفلاین

ابزار «ردیابی آفلاین» به شما امکان می‌دهد جلسه‌های ردیابی را که قبلاً ذخیره شده‌اند مشاهده و تجزیه‌وتحلیل کنید. جلسه ردیابی ذخیره‌شده اساساً «ضبط» جلسه ردیابی است و می‌تواند برای مواردی که عیب‌یابی و تجزیه‌وتحلیل بیشتر لازم است مفید باشد. واسط کاربر ابزار «ردیابی آفلاین» شبیه ابزار «ردیابی زنده» است.

برای اطلاعات بیشتر، استفاده از ابزار ردیابی آفلاین را ببینید.

نقش‌های کاربر در «تنظیمات کاربر» نمایش داده می‌شود

در صفحه «تنظیمات کاربر» رابط کاربری مدیریت (نام کاربری > تنظیمات کاربر)، نقش‌های کاربر اکنون نمایش داده می‌شود.

بهبودهای واسط کاربر مدیریت لبه

این نسخهٔ پخش شامل تعدادی بهبود کوچک در قابلیت استفاده و یکپارچگی در میانای کاربری مدیریت Edge است.

اشکالات رفع شد

اشکالات زیر در این نسخه پخش برطرف شده است.

شناسه مشکل شرح
APIRT-272 تنظیم io.timeout.millis رعایت نمی‌شود
تنظیم io.timeout.millis در «اتصال هدف HTTP» یک پراکسی API اکنون برای نقطه‌های پایانی هدف پویا رعایت می‌شود.
APIRT-441 پیام‌های خطای OAuth که به مشتری برگردانده می‌شود تغییر کرده است
در خط‌مشی OAuthV2، وقتی continueOnError روی true تنظیم شده باشد، Edge اکنون متغیرهای جریان جدید زیر را برای ارائه اطلاعات بیشتر درباره خطاها تکمیل می‌کند: oauthV2.policy-name.fault.name و oauthV2.policy-name.fault.cause
APIRT-641 مکان XSDهای به‌روز
طرحواره‌های خط‌مشی‌های Edge در مخزن GitHub نمونه‌های Apigee به‌روز شده است. به https://github.com/apigee/api-platform-samples/tree/master/schemas/policy مراجعه کنید.
APIRT-848 استفاده زیاد از حافظه RES پردازشگرهای پیام
APIRT-970 استفاده زیاد از پشته در پردازشگرهای پیام
APIRT-998 «خط‌مشی کنترل دسترسی» با بیش‌از یک پروتکل اینترنتی X-Forwarded-For ترافیک را مسدود نمی‌کند
در خط‌مشی «کنترل دسترسی»، فقط از اولین سرصفحه X-Forwarded-For استفاده می‌شد. اکنون اگر بیش‌از یک سرصفحه X-Forwarded-For وجود داشته باشد، خط‌مشی از همه آن‌ها استفاده می‌کند.
APIRT-1078 پردازشگرهای پیام و مسیریاب‌ها گاهی اوقات درطول استقرار وارد وضعیت قدیمی می‌شوند
APIRT-1098 گزارش‌های MP که java.util.ConcurrentModificationException را درحین اجرای Javascript نشان می‌دهد
خطاهای «سرویس دردسترس نیست» در برخی‌از خط‌مشی‌های JavaScript درحین اشکال‌زدایی/ردیابی ایجاد می‌شد. این مشکل برطرف شده است.
APIRT-1099 مشکل در GetOAuthV2Info - AuthorizationCode. ‫NPE پرتاب شد.
خط‌مشی GetOAuthV2Info هنگام تلاش برای واکشی «کد مجوز» استثناهای اشاره‌گر تهی را ایجاد می‌کرد. این مشکل برطرف شده است. این خط‌مشی اکنون از بازیابی اطلاعات «کد تأییدیه» پشتیبانی می‌کند.
AXAPP-572 منو کرکره‌ای در صفحه «داشبورد» پس‌از انتخاب وضعیت را تغییر نمی‌دهد
AXAPP-1295 گزارش‌های سفارشی که منجر به خطای سرور داخلی می‌شوند
«واسط کاربر مدیریت» اکنون تضمین می‌کند که نویسه‌های ویژه (٪، «) برای تماس‌های Analytics از گزارش‌های سفارشی به‌درستی کدبندی شوند.
AXAPP-1320 جزئیات کاوش به بُعد سفارشی خالی باعث بروز خطا در سطح دقت «دقیق» می‌شود
AXAPP-1390 هشدار «خطای سرور» هنگام تلاش برای بار کردن نمای عملکرد برتر در صفحه «داشبورد»
AXAPP-1427 مشکل پاسخ‌دهی در داشبورد هنگام مشاهده «به‌صورت دقیقه‌ای»
CORERT-280 ‫TCPMonitor باید وظایف را با تأخیر ثابت زمان‌بندی کند و نه با فاصله ثابت تا از مصرف همه رشته‌ها جلوگیری شود
کد TCPMonitor برای مدیریت کارآمدتر منابع سیستم بهینه‌سازی شده است.
CORERT-297 java.lang.OutOfMemoryError: حافظه میان‌گیری مستقیم در مسیریاب Netty درطول آزمایش بار مشاهده شد
CORERT-331 نشانی وب دارای «|» باعث درخواست ناهنجار می‌شود
نویسه‌های لوله در نشانی‌های وب («|») باعث خطاهای درخواست بد می‌شد. این مشکل برطرف شده است.
CORERT-338 وقتی ورودی‌های متضاد با proxyBasePath،‏ env،‏ vhost alias، و vhost port وجود دارد، بهترین مطابقت مسیر پایه را پیدا کنید
CORERT-348 ‫200 «پشتیبان» به‌دلیل سرایند پاسخ «اتصال: بسته» به 503 تغییر کرد
DEVRT-1039 «طرح نرخ تراکنش» الزامی نیست
الزام «خط‌مشی ضبط تراکنش» اجرا نمی‌شد. درآمدزایی اکنون همچنان مستلزم وجود «خط‌مشی ضبط تراکنش» برای محصول است تا بتوان طرح نرخ را برای بسته‌ای که حاوی محصول است تعریف کرد.
DEVRT-1210 فیلد تاریخ «شرایط خدمات» از منطقه زمانی سازمان برای اعتبارسنجی استفاده نمی‌کند
«تاریخ مؤثر شرایط خدمات» به‌اشتباه محاسبه می‌شد. اکنون تاریخ براساس منطقه زمانی سازمان درستی‌سنجی می‌شود.
MGMT-927 «توسعه میانای کاربر» فایل XML را در خط‌مشی‌ها به‌درستی تجزیه نمی‌کند، که می‌تواند هنگام ذخیره کردن بازبینی‌های جدید مشکل ایجاد کند
وقتی تعریف‌های XML در چند خط پیچیده می‌شد، میانای کاربر مدیریت کارگزاران و خط‌مشی‌های API را تجزیه نمی‌کرد. این مشکل برطرف شده است.
MGMT-1294 اگر پاسخ دادن به درخواست ورودی در زیرینه هدف زمان ببرد، واسط کاربر ردیابی جدید درخواست ورودی را نشان نمی‌دهد
MGMT-1302 حلقه هدایت مجدد در ورود به سیستم واسط کاربری مدیریت
در برخی موارد، ورود به سیستم واسط کاربری مدیریت در Firefox کار نمی‌کرد. این مشکل برطرف شده است.
MGMT-1309 فیلتر «ردیابی واسط کاربر» نویسه‌های ویژه را به‌طور صریح با نشانی وب کدبندی می‌کند
MGMT-1323 مدل API را می‌توان بدون اطلاعات اعتباری بازیابی کرد
منابع مدل API اکنون در همه درخواست‌ها به‌جز نقطه پایانی اکتشاف proxyUrl به اصالت‌سنجی نیاز دارند. این یعنی مشاهده مستقیم HTML «سند هوشمند» از زیرینه اکنون به اطلاعات اعتباری نیاز دارد.
MGMT-1386 خطای AJAX در صفحه نمای کلی APIProxy
وقتی چندین سازمان در برگه‌های مرورگر مختلف فعال بودند، خطاهای تمامیت داده رخ می‌داد. واسط کاربر مدیریت Edge اکنون به تضمین یکپارچگی داده‌ها در شرایط چند زبانه مرورگر کمک می‌کند. پس‌از اینکه در برگه مرورگر با سازمانی کار کردید، نیروهای مدیریت شما را مجبور می‌کنند در همه برگه‌های دیگر واسط کاربر مدیریت به آن سازمان بروید.
MGMT-1410 وقتی «سرور هدف» در «نوشته راهنمای سرویس» استفاده می‌شود، درستی‌سنجی نمی‌شود
در خط‌مشی «نوشته راهنمای سرویس»، نقطه پایانی هدف ازدست‌رفته‌ای درطول استقرار بسته کارگزار میانای برنامه‌سازی کاربردی مجاز بود. نقطه پایانی هدف خط‌مشی اکنون درحال اعتبارسنجی است و نقطه پایانی هدف ازدست‌رفته در «نوشته راهنمای تماس با سرویس» هنگام استقرار خطا می‌دهد.
MGMT-1411 متغیر <Path> در LoadBalancer مربوط به TargetEndPoint وجود ندارد و درطول استقرار NPE ایجاد می‌کند
در HTTPTargetConnection، وقتی از LoadBalancer استفاده می‌شد و Path مشخص نشده بود، خطای 500 ایجاد می‌شد. این مشکل برطرف شده است. اگر عنصر «مسیر» در «توزیع‌کننده بار» وجود نداشته باشد، از «/» پیش‌فرض استفاده می‌شود.
MGMT-1416 بهبود پیام هنگام استقرار دسته پراکسی با «شرط» نادرست
پیام‌های خطا درحین توسعه پراکسی‌های API بهبود یافته است تا اطلاعات بیشتری درباره مکان و دلایل خطاها ارائه دهد.
MGMT-1496 پیام خطای نادرست رابط کاربری هنگام افزودن کاربر
وقتی سعی می‌شد کاربر موجودی به سازمانی دوباره اضافه شود، پیام «کاربر تعریف‌نشده ازقبل در سازمان وجود دارد» نشان داده می‌شد. اکنون کلمه «تعریف‌نشده» با نام کاربری جایگزین شده است.
MGMT-1532 نقش سفارشی بدون اجازه «ویرایش» اجازه ایجاد میانای برنامه‌سازی کاربردی پروکسی را نمی‌دهد
MGMT-1538 توسعه‌دهندگانی که در بخش محلی ایمیلشان $ دارند قابل‌بازیابی نیستند
MGMT-1543 نمی‌تواند ازطریق واسط کاربر مدیریت در نقش «کاربر» مستقر شود

مشکلات شناخته‌شده

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

شناسه مشکل شرح
APIRT-950 گزارش‌ها ممکن است «na» را برای برنامه و محصول توسعه‌دهنده نمایش دهند
«na» گاهی در گزارش‌های تجزیه‌وتحلیل نشان داده می‌شود. موضوع مستندات زیر توضیح می‌دهد که «na» در زمینه‌های مختلف به چه معنا است: یعنی چه؟ به‌روزرسانی آتی نمایش این برچسب را در «میانای کاربر» بهبود خواهد بخشید.