أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
Edge API Analytics هي ميزة مُدمَجة فعّالة جدًا توفّرها Apigee Edge. تجمع هذه الخدمة مجموعة واسعة من البيانات التي تنتقل عبر واجهات برمجة التطبيقات وتحلّلها. يمكن أن تقدّم بيانات الإحصاءات التي يتم جمعها إحصاءات مفيدة جدًا. على سبيل المثال، ما هو اتجاه حجم الزيارات إلى واجهة برمجة التطبيقات خلال فترة زمنية معيّنة؟ ما هي واجهة برمجة التطبيقات الأكثر استخدامًا؟ ما هي واجهات برمجة التطبيقات التي تسجّل معدّلات خطأ عالية؟
يمكن استخدام التحليل المنتظم لهذه البيانات والإحصاءات لاتّخاذ الإجراءات المناسبة، مثل التخطيط المستقبلي لسعة واجهات برمجة التطبيقات استنادًا إلى الاستخدام الحالي وقرارات الاستثمار في النشاط التجاري والمستقبل وغير ذلك الكثير.
بيانات "إحصاءات Google" وتخزينها
تسجّل "إحصاءات واجهة برمجة التطبيقات" العديد من أنواع البيانات المختلفة، مثل:
- معلومات حول واجهة برمجة التطبيقات، مثل معرّف الموارد المنتظم (URI) للطلب وعنوان IP الخاص بالعميل ورموز حالة الرد وما إلى ذلك
- أداء خادم وكيل لواجهة برمجة التطبيقات: معدّل النجاح/الإخفاق، ووقت معالجة الطلبات والاستجابات، وما إلى ذلك
- أداء الخادم المستهدف - معدّل النجاح/الفشل، وقت المعالجة
- معلومات الخطأ - عدد الأخطاء ورمز الخطأ والسياسة التي تعذّر تنفيذها وعدد الأخطاء التي تسبّب فيها كل من 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" (الاحتفاظ بنسخة احتياطية/الاستعادة)
أفضل الممارسات
- لا تُضِف أي معلومات مخصّصة في شكل أعمدة وجداول وطرق عرض ودوال وإجراءات مباشرةً إلى أي من المخططات التي تملكها Apigee، مثل
analyticsوما إلى ذلك. - إذا كانت هناك حاجة إلى توفير معلومات مخصّصة، يمكن إضافتها كأعمدة (حقول) باستخدام سياسة "أداة جمع الإحصاءات" إلى مخطط
analytics.