15.02.18 - یادداشت های انتشار ابر Apigee Edge

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

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

ویژگی‌ها و پیشرفت‌های جدید

در ادامه به ویژگی‌ها و بهبودهای جدید این نسخه اشاره خواهیم کرد.

پیشرفت‌های تحلیلی

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

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

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

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

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

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

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

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

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

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

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

اشکالات برطرف شد

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

شناسه مسئله توضیحات
APIRT-272 تنظیمات io.timeout.millis اجرا نمی‌شود.
تنظیم io.timeout.millis روی اتصال HTTP Target یک پروکسی 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 سیاست کنترل دسترسی با بیش از یک IP X-Forwarded-For که ترافیک را مسدود نمی‌کند
در سیاست کنترل دسترسی، فقط از اولین هدر X-Forwarded-For استفاده می‌شد. اکنون اگر بیش از یک هدر X-Forwarded-For وجود داشته باشد، این سیاست از تمام هدرهای X-Forwarded-For استفاده می‌کند.
APIRT-1078 پردازنده‌های پیام و روترها گاهی اوقات در حین استقرار وارد حالت بی‌رمق می‌شوند
APIRT-1098 گزارش‌های MP هنگام اجرای جاوا اسکریپت، خطای java.util.ConcurrentModificationException را نشان می‌دهند.
خطاهای عدم دسترسی به سرویس در برخی از سیاست‌های جاوا اسکریپت هنگام اشکال‌زدایی/ردیابی رخ می‌داد. این مشکل برطرف شده است.
APIRT-1099 مشکل با GetOAuthV2Info - AuthorizationCode. ارسال NPE.
خط‌مشی GetOAuthV2Info هنگام تلاش برای دریافت "AuthorizationCode" خطای null pointer exceptions صادر می‌کرد. این مشکل برطرف شده است. این خط‌مشی اکنون از بازیابی اطلاعات AuthorizationCode پشتیبانی می‌کند.
AXAPP-572 منوی کشویی در صفحه داشبورد پس از انتخاب، حالت خود را تغییر نمی‌دهد
AXAPP-1295 گزارش‌های سفارشی منجر به خطای داخلی سرور می‌شوند
رابط کاربری مدیریت اکنون تضمین می‌کند که کاراکترهای ویژه (%، ") برای فراخوانی‌های تحلیلی از گزارش‌های سفارشی به درستی کدگذاری شوند.
AXAPP-1320 جستجوی عمیق برای بعد سفارشی خالی باعث ایجاد خطا با سطح دقت "دقیق" می‌شود.
AXAPP-1390 هشدار «خطای سرور» هنگام تلاش برای بارگذاری نمای عملکرد بالا در صفحه «داشبورد»
AXAPP-1427 مشکل پاسخگویی در داشبورد هنگام مشاهده "بر اساس دقیقه"
کوررت-۲۸۰ TCPMonitor باید وظایف را با تأخیر ثابت و نه با فاصله زمانی ثابت زمان‌بندی کند تا از مصرف تمام نخ‌ها جلوگیری شود.
کد TCPMonitor بهینه شده است تا منابع سیستم را با کارایی بیشتری مدیریت کند.
کوررت-۲۹۷ خطای java.lang.OutOfMemoryError: خطای حافظه بافر مستقیم در روتر Netty هنگام تست بار مشاهده شد.
کوررت-۳۳۱ آدرس اینترنتی (URL) با '|' باعث درخواست ناقص می‌شود
کاراکترهای pipe در URLها ("|") باعث خطاهای درخواست نادرست می‌شدند. این مشکل برطرف شده است.
کوررت-۳۳۸ یافتن بهترین مسیر پایه منطبق در مواقعی که ورودی‌های متناقضی با proxyBasePath، env، vhost alias و vhost port وجود دارد
کوررت-۳۴۸ به دلیل هدر پاسخ "اتصال: بسته" مقدار 200 در بک‌اند به 503 تغییر یافته است.
DEVRT-1039 طرح نرخ تراکنش اجباری نیست
الزام سیاست ثبت تراکنش‌ها اجرا نمی‌شد. اکنون کسب درآمد همچنان مستلزم وجود یک سیاست ثبت تراکنش برای یک محصول است تا بتوان برای بسته‌ای که شامل محصول است، طرح نرخ‌گذاری تعریف کرد.
DEVRT-1210 فیلد تاریخ و شرایط استفاده از منطقه زمانی سازمان برای اعتبارسنجی استفاده نمی‌کند.
تاریخ اجرای شرایط و ضوابط به اشتباه محاسبه شده بود. اکنون این تاریخ بر اساس منطقه زمانی سازمان اعتبارسنجی می‌شود.
MGMT-927 رابط کاربری توسعه‌دهنده، XML را در سیاست‌ها به درستی تجزیه نمی‌کند و می‌تواند هنگام ذخیره نسخه‌های جدید، مشکلاتی ایجاد کند.
رابط کاربری مدیریت، پروکسی‌ها و سیاست‌های API را زمانی که تعاریف XML در چندین خط قرار می‌گرفتند، تجزیه نمی‌کرد. این مشکل برطرف شده است.
MGMT-1294 رابط کاربری جدید ردیابی، در صورتی که بک‌اند هدف برای پاسخگویی مدتی طول بکشد، درخواست ورودی را نشان نمی‌دهد.
MGMT-1302 حلقه تغییر مسیر هنگام ورود به رابط کاربری مدیریت
در موارد خاص، ورود به رابط کاربری مدیریت در فایرفاکس کار نمی‌کرد. این مشکل برطرف شده است.
MGMT-1309 فیلتر رابط کاربری Trace به طور صریح کاراکترهای خاص را در آدرس اینترنتی (urlencodes) کدگذاری می‌کند.
MGMT-1323 مدل API بدون نیاز به اطلاعات احراز هویت قابل بازیابی است
منابع مدل API اکنون برای همه درخواست‌ها به جز نقطه پایانی کشف proxyUrl نیاز به احراز هویت دارند. این بدان معناست که مشاهده مستقیم SmartDocs HTML از backend اکنون به اعتبارنامه نیاز دارد.
MGMT-1386 خطای AJAX در صفحه مرور APIProxy
خطاهای یکپارچگی داده‌ها زمانی رخ می‌داد که چندین سازمان در تب‌های مختلف مرورگر فعال بودند. رابط کاربری مدیریت Edge اکنون به تضمین یکپارچگی داده‌ها در موقعیت‌های چند تب مرورگر کمک می‌کند. پس از اینکه با یک سازمان در یک تب مرورگر کار کردید، مدیریت شما را مجبور می‌کند که در تمام تب‌های رابط کاربری مدیریتی دیگر به آن سازمان بروید.
MGMT-1410 سرور هدف هنگام استفاده در فراخوانی سرویس تأیید نشده است
در یک سیاست فراخوانی سرویس، یک نقطه پایانی هدفِ از دست رفته در طول استقرار بسته پروکسی API مجاز بود. نقطه پایانی هدف این سیاست اکنون در حال اعتبارسنجی است و یک نقطه پایانی هدف از دست رفته در فراخوانی سرویس، هنگام استقرار خطا می‌دهد.
MGMT-1411 هیچ متغیر <Path> در LoadBalancer مربوط به TargetEndPoint در حین استقرار، NPE را ارسال نمی‌کند.
در یک HTTPTargetConnection، وقتی از LoadBalancer استفاده می‌شد و Path مشخص نمی‌شد، خطای ۵۰۰ رخ می‌داد. این مشکل برطرف شده است. اگر LoadBalancer عنصر Path را نداشته باشد، از "/" پیش‌فرض استفاده می‌شود.
MGMT-1416 بهبود پیام هنگام استقرار یک بسته پروکسی با شرایط نادرست
پیام‌های خطا هنگام توسعه‌ی پراکسی‌های API بهبود یافته‌اند تا اطلاعات بیشتری در مورد محل و دلایل خطاها ارائه دهند.
MGMT-1496 پیام خطای رابط کاربری نادرست هنگام اضافه کردن کاربر
هنگام تلاش برای اضافه کردن مجدد یک کاربر موجود به یک سازمان، پیام "کاربر تعریف نشده از قبل در سازمان وجود دارد" ظاهر شد. اکنون کلمه "تعریف نشده" با نام کاربری جایگزین شده است.
MGMT-1532 نقش سفارشی بدون مجوز ویرایش، امکان ایجاد پروکسی API را فراهم نمی‌کند.
MGMT-1538 توسعه‌دهندگانی که در بخش محلی ایمیل خود $ دارند، قابل بازیابی نیستند.
MGMT-1543 نمی‌توان از طریق رابط کاربری مدیریت، در نقش «کاربر» مستقر شد

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

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

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