أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
يقارن هذا القسم بين مراقبة واجهة برمجة التطبيقات وإحصاءات Edge. على الرغم من أنّ ميزة "مراقبة واجهة برمجة التطبيقات" وميزة "إحصاءات Edge" تتيحان جمع بيانات واجهة برمجة التطبيقات وعرضها، إلا أنّ لكلّ منهما أهدافًا مختلفة:
- يهدف رصد واجهة برمجة التطبيقات إلى التأكّد من أنّ واجهات برمجة التطبيقات قيد التشغيل على النحو المقصود. لهذا الغرض، عليك الاطّلاع على أحدث البيانات المتاحة. توفّر ميزة "مراقبة واجهة برمجة التطبيقات" بيانات قريبة جدًا من الوقت الفعلي، وتتيح لك إنشاء تنبيهات لإعلامك في حال حدوث مشكلة.
- يهدف تقرير "إحصاءات الحواف" إلى فهم السلوك على المدى الطويل لواجهات برمجة التطبيقات، حتى تتمكّن من التأكّد من أنّها تلبّي متطلبات نشاطك التجاري، أو إجراء تغييرات إذا لزم الأمر. ولهذه الأغراض، لا يُعدّ الاطّلاع على البيانات في الوقت الفعلي أمرًا مهمًا. ونتيجةً لذلك، يتأخّر ظهور بيانات "إحصاءات YouTube"، ولكن عادةً ما يكون ذلك خلال 10 دقائق كحد أقصى.
يُرجى العِلم أنّ بيانات مراقبة واجهة برمجة التطبيقات، التي ترتبط في الغالب برموز الأخطاء ووقت الاستجابة، هي مجموعة فرعية صغيرة من بيانات "إحصاءات Google".
الاختلافات بين بيانات "مراقبة واجهة برمجة التطبيقات" وبيانات "إحصاءات Google"
يوضّح هذا القسم بعض الاختلافات البسيطة بين البيانات التي يجمعها Edge Analytics مقارنةً ببيانات "مراقبة واجهة برمجة التطبيقات". بما أنّ ميزة "مراقبة واجهة برمجة التطبيقات" و"إحصاءات واجهة برمجة التطبيقات" تستخدمان قنوات تدفق بيانات مختلفة، قد تلاحظ اختلافات طفيفة بين التقارير المخصّصة التي تنشئها ميزة "المراقبة" والتقارير التي تنشئها ميزة "إحصاءات واجهة برمجة التطبيقات". على سبيل المثال، قد تلاحظ اختلافات في النتائج التي تم الإبلاغ عنها لأخطاء وقت الاستراحة، سواء كانت أخطاء وقت استراحة في الخلفية (رمز حالة HTTP 504 للطلب) أو أخطاء وقت استراحة في العميل (رمز حالة HTTP 499). قد تظهر هذه الرسائل برمز الحالة 200 في التقارير المخصّصة في "إحصاءات Google"، ولكنّها ستظهر برمز الحالة 504 أو 499 في التقارير المخصّصة للتتبّع.مراقبة واجهة برمجة التطبيقات
توفّر ميزة مراقبة واجهات برمجة التطبيقات إحصاءات في الوقت الفعلي عن أداء واجهات برمجة التطبيقات، وتساعدك في تشخيص المشاكل وحلّها بسرعة للحفاظ على عمل واجهات برمجة التطبيقات على النحو المطلوب.
تتيح لك ميزة "مراقبة واجهة برمجة التطبيقات" تنفيذ ما يلي:
- زيادة مدى توفّر واجهة برمجة التطبيقات وتقليل متوسّط مدّة تحديد المشاكل وحلّها (MTTD)
- اتّخاذ الإجراءات المناسبة استنادًا إلى التنبيهات السياقية قبل تأثُّر المستهلكين
- يمكنك الاستفادة من رموز أخطاء Apigee لتسريع عملية التشخيص.
- يمكنك عزل المناطق التي تتضمّن مشاكل بسرعة لتشخيص مشاكل الأخطاء والأداء ووقت الاستجابة ومصدرها.
Edge API Analytics
تجمع إحصاءات Edge API المعلومات التي تتدفق من خلال واجهات برمجة التطبيقات وتحلّلها. تلتقط ميزة "إحصاءات واجهة برمجة التطبيقات" معلومات مثل:
- مؤشرات عدد زيارات واجهة برمجة التطبيقات بمرور الوقت
- أهم تطبيقاتك
- أهم المطوّرين لديك
- طرق واجهة برمجة التطبيقات الأكثر شيوعًا
- متى يكون وقت استجابة واجهة برمجة التطبيقات الأسرع/الأبطأ
- من حيث الموقع الجغرافي، أين ترى أكبر عدد من زيارات واجهة برمجة التطبيقات؟
البيانات التي تجمعها "إحصاءات واجهة برمجة التطبيقات"
تجمع ميزة "إحصاءات واجهات برمجة التطبيقات" مجموعة كبيرة من البيانات التي تتدفق عبر واجهات برمجة التطبيقات، ثم تحلّلها. على سبيل المثال، أثناء نشر واجهة برمجة التطبيقات، تسجِّل "إحصاءات Google" باستمرار عدد الرسائل التي تمّ تلقّيها وعدد المطوّرين ومُدد الاستجابة والأخطاء وعدد التطبيقات المستخدَمة وحجم الطلب والعديد من البيانات الأخرى.
للحصول على مقدمة جيدة عن المقاييس وكيفية استخدامها، يُرجى الاطّلاع على مقالة استخدام واجهات برمجة التطبيقات للمقاييس لقياس أداء برنامج واجهات برمجة التطبيقات. للحصول على قائمة كاملة بالمقاييس، اطّلِع على مرجع المقاييس والسمات والفلاتر في "إحصاءات Google".
جمع المقاييس المخصّصة
يمكنك أيضًا جمع مقاييس مخصّصة باستخدام سياسة StatisticsCollector. يمكن لسياسة StatisticsCollector كتابة معلومات من رؤوس الطلبات وحمولات XML/JSON ومَعلمات طلبات البحث ومعرّفات الموارد المنتظمة (URI) والمواقع الجغرافية الأخرى إلى خادم "إحصاءات Google" لتحليلها وإنشاء التقارير.
الوصول إلى بيانات "إحصاءات Google"
بعد إنشاء المقاييس المحدّدة مسبقًا والمقاييس المخصّصة، يمكنك الوصول إليها باستخدام أدوات التمثيل البصري في "إحصاءات Google" من خلال واجهة برمجة التطبيقات، بما في ذلك لوحة البيانات والتقارير المخصّصة و"الخريطة الجغرافية". لمزيد من المعلومات عن أدوات العروض المرئية التي تقدّمها "إحصاءات واجهة برمجة التطبيقات"، اطّلِع على لوحات بيانات "إحصاءات Google". لمزيد من المعلومات عن التقارير المخصّصة، اطّلِع على مقالة إنشاء تقارير مخصّصة.
مقارنة بين ميزة "مراقبة واجهة برمجة التطبيقات" و"إحصاءات واجهة برمجة التطبيقات"
يستخدم مطوّرو واجهات برمجة التطبيقات كلّ من "مراقبة واجهات برمجة التطبيقات" و"إحصاءات واجهات برمجة التطبيقات". ومن بين الاختلافات الرئيسية بين الاثنين آلية التنبيهات المضمّنة في ميزة "مراقبة واجهة برمجة التطبيقات". تتيح التنبيهات لفريق العمليات الاستجابة للمشاكل المتعلّقة بواجهات برمجة التطبيقات في الوقت الفعلي لضمان توفّر واجهات برمجة التطبيقات وأداءها على النحو المتوقّع.
تحدِّد شروط التنبيهات رمز حالة معيّنًا (2xx/4xx/5xx) ومعدّل استجابة وحدود رمز الخطأ التي تؤدي إلى تشغيل تنبيهات مرئية في واجهة المستخدم وإرسال إشعارات من خلال مجموعة متنوعة من القنوات، مثل البريد الإلكتروني أو Slack أو PagerDuty أو وحدات الربط. يمكنك إعداد التنبيهات على مستوى البيئة أو الوكيل لواجهة برمجة التطبيقات أو الخدمة المستهدَفة أو المنطقة.
بعد بدء تنبيه، يمكن لفريق العمليات استخدام واجهة مستخدم "مراقبة واجهة برمجة التطبيقات" للتحقيق في المشكلة والتعمّق في معرفة السبب الأساسي لها. يمكنك بعد ذلك إنشاء تقرير مخصّص يحتوي على معلومات محدّدة مسبقًا عن التنبيه، مثل:
- إجمالي وقت الاستجابة
- الوقت المستهدَف للردّ
- أخطاء الخادم الوكيل
- أخطاء الاستهداف
- معرّف فريد عالمي للطلب
- وغيرها الكثير
تم تصميم "إحصاءات واجهات برمجة التطبيقات" لتسجيل مجموعة كبيرة من البيانات لاستخدامها من قِبل عدة فِرق. على سبيل المثال:
- يمكن لفريق العمليات استخدام بيانات "إحصاءات Google" لتحديد الفترات التي يكون فيها عدد الزيارات مرتفعًا أو منخفضًا حتى يتمكّنوا من زيادة أو تقليل نطاق خدماتك لتلبية الطلبات المتغيّرة.
- يمكن لفريق التسويق استخدام بيانات "إحصاءات Google" لتحديد أنماط استخدام العملاء التي تحدّدها واجهات برمجة تطبيقات أو تطبيقات أو عملاء أو بيانات أخرى فردية.
- يمكن لجميع الفِرق الوصول إلى البيانات المخصّصة التي يتم جمعها من طلب لتتبُّع معلومات محدّدة، مثل قيم الرأس أو مَعلمات طلب البحث أو الحمولة المطلوبة.