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

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

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

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

داده‌های Analytics و فضای ذخیره‌سازی آن

‫API Analytics انواع مختلفی از داده‌ها را ضبط می‌کند، ازجمله:

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

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

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

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

طرحواره analytics با افزودن پویای جدول‌های حقیقت جدید به آن در زمان اجرا توسط Apigee Edge، همچنان تغییر خواهد کرد. عنصر سرور Postgres داده‌های واقعی را در جدول‌های مجموعه‌ای که در «میانای کاربری New 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 اضافه کرد.

مطالعه بیشتر