Antipattern: اطلاعات سفارشی را به طرح متعلق به Apigee در پایگاه داده Postgres اضافه کنید

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

Edge API Analytics یک ویژگی داخلی بسیار قدرتمند است که توسط Apigee Edge ارائه شده است. این طیف وسیعی از داده‌ها را جمع‌آوری و تجزیه و تحلیل می‌کند که در میان APIها جریان دارد. داده های تحلیلی گرفته شده می تواند بینش بسیار مفیدی را ارائه دهد. به عنوان مثال، روند حجم ترافیک API در یک دوره زمانی چگونه است؟ کدام API بیشترین استفاده را دارد؟ کدام API ها دارای نرخ خطای بالایی هستند؟

تجزیه و تحلیل منظم این داده ها و بینش ها می تواند برای انجام اقدامات مناسب مانند برنامه ریزی ظرفیت آینده API ها بر اساس استفاده فعلی، تصمیمات تجاری و سرمایه گذاری آتی و بسیاری موارد دیگر مورد استفاده قرار گیرد.

داده های تجزیه و تحلیل و ذخیره سازی آن

API Analytics انواع مختلفی از داده ها را می گیرد مانند:

  • اطلاعات در مورد یک API - درخواست URI، آدرس IP مشتری، کدهای وضعیت پاسخ، و غیره
  • عملکرد پروکسی API - میزان موفقیت / شکست، زمان پردازش درخواست و پاسخ و غیره
  • عملکرد سرور هدف - میزان موفقیت / شکست، زمان پردازش
  • اطلاعات خطا - تعداد خطاها، کد خطا، خط مشی خرابی، تعداد Apigee و سرور هدف باعث خطا شدند.
  • اطلاعات دیگر - تعداد درخواست‌های ایجاد شده توسط برنامه‌نویسان، برنامه‌های توسعه‌دهنده و غیره

همه این داده ها در یک طرح analytics ایجاد و مدیریت شده در پایگاه داده Postgres توسط Apigee Edge ذخیره می شوند.

به طور معمول، در نصب وانیلی Edge، Postgres طرحواره های زیر را خواهد داشت:

طرحی به نام analytics توسط Edge برای ذخیره تمام داده های تجزیه و تحلیل برای هر سازمان و محیط استفاده می شود. اگر کسب درآمد نصب شده باشد، یک طرح rkms وجود خواهد داشت. طرحواره های دیگر برای داخلی های Postgres در نظر گرفته شده است.

طرح analytics همچنان در حال تغییر است زیرا Apigee Edge به صورت پویا جداول واقعیت جدید را در زمان اجرا به آن اضافه می کند. مؤلفه سرور Postgres داده های واقعیت را در جداول انبوهی جمع می کند که بارگذاری می شوند و در رابط کاربری Edge نمایش داده می شوند.

ضد الگو

افزودن ستون‌ها، جداول و/یا نماهای سفارشی به هر یک از طرح‌واره‌های متعلق به Apigee در پایگاه داده Postgres در محیط‌های Private Cloud مستقیماً با استفاده از جستارهای SQL توصیه نمی‌شود، زیرا می‌تواند پیامدهای نامطلوبی داشته باشد.

بیایید برای توضیح کامل این موضوع مثالی بزنیم.

در نظر بگیرید که یک جدول سفارشی با نام account در زیر طرح تجزیه و تحلیل ایجاد شده است که در زیر نشان داده شده است:

پس از مدتی، فرض کنید که نیاز به ارتقاء Apigee Edge از یک نسخه پایین تر به یک نسخه بالاتر وجود دارد. ارتقاء Private Cloud Apigee Edge شامل ارتقاء Postgres در میان بسیاری از مؤلفه های دیگر است. اگر ستون‌ها، جدول‌ها یا نماهای سفارشی به پایگاه داده Postgres اضافه شده باشد، ارتقای Postgres با خطاهایی که به اشیاء سفارشی ارجاع می‌دهند با شکست مواجه می‌شود، زیرا توسط Apigee Edge ایجاد نشده‌اند. بنابراین، ارتقاء Apigee Edge نیز با شکست مواجه می شود و نمی توان آن را تکمیل کرد.

به همین ترتیب خطاهایی در طول فعالیت های نگهداری Apigee Edge که در آن پشتیبان گیری و بازیابی اجزای Edge از جمله پایگاه داده Postgres انجام می شود، رخ می دهد.

تاثیر

  • ارتقاء Apigee Edge نمی‌تواند تکمیل شود زیرا ارتقاء مؤلفه Postgres با خطاهای ارجاع به اشیاء سفارشی که توسط Apigee Edge ایجاد نشده‌اند ناموفق است.
  • ناسازگاری (و خرابی) در حین انجام تعمیر و نگهداری سرویس Apigee Analytics (پشتیبان گیری/بازیابی).

بهترین تمرین

  • هیچ اطلاعات سفارشی در قالب ستون‌ها، جدول‌ها، نماها، توابع و رویه‌ها را مستقیماً به هیچ یک از طرحواره‌های متعلق به Apigee مانند analytics و غیره اضافه نکنید.
  • اگر نیاز به پشتیبانی از اطلاعات سفارشی وجود دارد، می توان آن را به عنوان ستون (فیلد) با استفاده از خط مشی جمع آوری آمار به طرح analytics اضافه کرد.

در ادامه مطلب

،

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

Edge API Analytics یک ویژگی داخلی بسیار قدرتمند است که توسط Apigee Edge ارائه شده است. این طیف وسیعی از داده‌ها را جمع‌آوری و تجزیه و تحلیل می‌کند که در میان APIها جریان دارد. داده های تحلیلی گرفته شده می تواند بینش بسیار مفیدی را ارائه دهد. به عنوان مثال، روند حجم ترافیک API در یک دوره زمانی چگونه است؟ کدام API بیشترین استفاده را دارد؟ کدام API ها دارای نرخ خطای بالایی هستند؟

تجزیه و تحلیل منظم این داده ها و بینش ها می تواند برای انجام اقدامات مناسب مانند برنامه ریزی ظرفیت آینده API ها بر اساس استفاده فعلی، تصمیمات تجاری و سرمایه گذاری آتی و بسیاری موارد دیگر مورد استفاده قرار گیرد.

داده های تجزیه و تحلیل و ذخیره سازی آن

API Analytics انواع مختلفی از داده ها را می گیرد مانند:

  • اطلاعات در مورد یک API - درخواست URI، آدرس IP مشتری، کدهای وضعیت پاسخ، و غیره
  • عملکرد پروکسی API - میزان موفقیت / شکست، زمان پردازش درخواست و پاسخ و غیره
  • عملکرد سرور هدف - میزان موفقیت / شکست، زمان پردازش
  • اطلاعات خطا - تعداد خطاها، کد خطا، خط مشی خرابی، تعداد Apigee و سرور هدف باعث خطا شدند.
  • اطلاعات دیگر - تعداد درخواست‌های ایجاد شده توسط برنامه‌نویسان، برنامه‌های توسعه‌دهنده و غیره

همه این داده ها در یک طرح analytics ایجاد و مدیریت شده در پایگاه داده Postgres توسط Apigee Edge ذخیره می شوند.

به طور معمول، در نصب وانیلی Edge، Postgres طرحواره های زیر را خواهد داشت:

طرحی به نام analytics توسط Edge برای ذخیره تمام داده های تجزیه و تحلیل برای هر سازمان و محیط استفاده می شود. اگر کسب درآمد نصب شده باشد، یک طرح rkms وجود خواهد داشت. طرحواره های دیگر برای داخلی های Postgres در نظر گرفته شده است.

طرح analytics همچنان در حال تغییر است زیرا Apigee Edge به صورت پویا جداول واقعیت جدید را در زمان اجرا به آن اضافه می کند. مؤلفه سرور Postgres داده های واقعیت را در جداول انبوهی جمع می کند که بارگذاری می شوند و در رابط کاربری Edge نمایش داده می شوند.

ضد الگو

افزودن ستون‌ها، جداول و/یا نماهای سفارشی به هر یک از طرح‌واره‌های متعلق به Apigee در پایگاه داده Postgres در محیط‌های Private Cloud مستقیماً با استفاده از جستارهای SQL توصیه نمی‌شود، زیرا می‌تواند پیامدهای نامطلوبی داشته باشد.

بیایید برای توضیح کامل این موضوع مثالی بزنیم.

در نظر بگیرید که یک جدول سفارشی با نام account در زیر طرح تجزیه و تحلیل ایجاد شده است که در زیر نشان داده شده است:

پس از مدتی، فرض کنید که نیاز به ارتقاء Apigee Edge از یک نسخه پایین تر به یک نسخه بالاتر وجود دارد. ارتقاء Private Cloud Apigee Edge شامل ارتقاء Postgres در میان بسیاری از مؤلفه های دیگر است. اگر ستون‌ها، جدول‌ها یا نماهای سفارشی به پایگاه داده Postgres اضافه شده باشد، ارتقای Postgres با خطاهایی که به اشیاء سفارشی ارجاع می‌دهند با شکست مواجه می‌شود، زیرا توسط Apigee Edge ایجاد نشده‌اند. بنابراین، ارتقاء Apigee Edge نیز با شکست مواجه می شود و نمی توان آن را تکمیل کرد.

به همین ترتیب خطاهایی در طول فعالیت های نگهداری Apigee Edge که در آن پشتیبان گیری و بازیابی اجزای Edge از جمله پایگاه داده Postgres انجام می شود، رخ می دهد.

تاثیر

  • ارتقاء Apigee Edge نمی‌تواند تکمیل شود زیرا ارتقاء مؤلفه Postgres با خطاهای ارجاع به اشیاء سفارشی که توسط Apigee Edge ایجاد نشده‌اند ناموفق است.
  • ناسازگاری (و خرابی) در حین انجام تعمیر و نگهداری سرویس Apigee Analytics (پشتیبان گیری/بازیابی).

بهترین تمرین

  • هیچ اطلاعات سفارشی در قالب ستون‌ها، جدول‌ها، نماها، توابع و رویه‌ها را مستقیماً به هیچ یک از طرحواره‌های متعلق به Apigee مانند analytics و غیره اضافه نکنید.
  • اگر نیاز به پشتیبانی از اطلاعات سفارشی وجود دارد، می توان آن را به عنوان ستون (فیلد) با استفاده از خط مشی جمع آوری آمار به طرح analytics اضافه کرد.

در ادامه مطلب