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