يتم الآن عرض مستندات Apigee Edge.
يمكنك الاطّلاع على وثائق Apigee X.
يعرّف هذا الموضوع إحصاءات Edge API.
فيديو: شاهِد فيديو قصيرًا يقدّم نظرة عامة عن خدمات Edge API.
تحسين واجهة برمجة التطبيقات من خلال الإحصاءات
تجمع "إحصاءات Edge API" وتحتسب كمية كبيرة من المعلومات التي تتدفق عبر الخوادم الوكيلة لواجهة برمجة التطبيقات. ويمكنك عرض هذه البيانات مرئيًا باستخدام الرسوم البيانية والمخططات في واجهة مستخدم Edge، أو يمكنك تنزيل البيانات الأولية للتحليل بلا اتصال بالإنترنت باستخدام واجهات برمجة تطبيقات Edge.
تساعدك "إحصاءات Google" في الإجابة عن أسئلة شائعة، مثل:
- كيف هو عدد زيارات واجهة برمجة التطبيقات الخاصة بي بمرور الوقت؟
- ما هي أساليب واجهة برمجة التطبيقات الأكثر رواجًا؟
- من هم أفضل مطوّري برامجي؟
- ما هو وقت الاستجابة لواجهة برمجة التطبيقات؟ الأبطأ؟
- من الناحية الجغرافية، أين يمكنني الاطّلاع على أكبر عدد من زيارات واجهة برمجة التطبيقات؟
وتساعدك الإجابات عن هذه الأسئلة على تحسين واجهات برمجة التطبيقات وتحديد المشاكل وحلّها واتّخاذ قرارات أفضل بشأن نشاطك التجاري بشأن برنامج واجهة برمجة التطبيقات.
تساعد "إحصاءات واجهة برمجة التطبيقات" الجميع على التحسين
من خلال العمل المستمر لجمع البيانات وتحليلها وتمثيلها مرئيًا، تساعد "إحصاءات واجهة برمجة تطبيقات Edge" فريق واجهة برمجة التطبيقات على تحسين واجهات برمجة التطبيقات وتساعد مطوّري التطبيقات في تحسين تطبيقاتهم:
- فريق واجهة برمجة التطبيقات - يتولى فريق واجهة برمجة التطبيقات الاستفادة من الأنظمة الداخلية لإنشاء واجهات برمجة تطبيقات مثيرة للاهتمام. يريد فريق واجهة برمجة التطبيقات معرفة مستوى أداء برنامج واجهة برمجة التطبيقات بشكل عام، ومستوى أداء واجهات برمجة التطبيقات الفردية، وكيفية تحسين واجهات برمجة التطبيقات هذه.
- مطوّرو التطبيقات: يمكنك الحصول على تطبيقات أفضل من خلال مشاركة معلومات الإحصاءات مع مطوّري التطبيقات. يعمل هؤلاء المطوّرون على الابتكار باستخدام واجهة برمجة التطبيقات الخاصة بك وإنشاء تطبيقات إبداعية تساعد في زيادة الأرباح لمؤسستك. تساعد "إحصاءات Google" مطوّري التطبيقات على معرفة مستوى أداء تطبيقاتهم ومقدارهم في المساهمة في المرحلة النهائية لنشاطك التجاري. يرغب مطوّرو التطبيقات في معرفة كيفية تحسين تطبيقاتهم.
- فريق العمليات: يريد فريق العمليات فهم أنماط الزيارات وتوقع الوقت المناسب لإضافة موارد الخلفية أو إجراء تعديلات مهمة أخرى.
- مالك النشاط التجاري: يريد مالك النشاط التجاري معرفة كيفية دفع استثماره لواجهة برمجة التطبيقات والمكان الذي يستثمر فيه دولارات واجهة برمجة التطبيقات في المستقبل.
ما هو نوع البيانات التي يتم جمعها وتحليلها؟
تجمع إحصاءات Edge API مجموعة واسعة من البيانات التي تتدفق عبر الخوادم الوكيلة لواجهة برمجة التطبيقات، مثل:
- مدة الردّ
- وقت استجابة الطلب
- حجم الطلب
- أخطاء الاستهداف
- اسم منتج واجهة برمجة التطبيقات
- عنوان البريد الإلكتروني لمطوّر البرامج
- اسم التطبيق
- غيرها الكثير
للحصول على قائمة كاملة بالبيانات التي تجمعها إحصاءات البيانات من واجهة برمجة التطبيقات، اطّلِع على مرجع المقاييس والسمات والفلاتر في "إحصاءات Google".
كيف يمكنني جمع بيانات الإحصاءات المخصصة؟
تجمع شركة Edge في الأصل وفرة من البيانات. وقد تحتاج أيضًا إلى جمع بيانات إحصاءات مخصّصة للخوادم الوكيلة أو التطبيقات أو المنتجات أو المطوّرين في واجهة برمجة التطبيقات. على سبيل المثال، قد تحتاج إلى جمع بيانات الإحصاءات من معلمات طلب البحث أو عناوين الطلبات أو نصوص الطلبات والرد أو المتغيّرات التي تحدّدها في واجهات برمجة التطبيقات.
جمع بيانات إحصاءات مخصّصة باستخدام سياسة جمع الإحصاءات. بعد استخراج البيانات المخصّصة، يمكنك استخدام واجهة مستخدم "إحصاءات Google" أو واجهة برمجة التطبيقات لفحص البيانات. راجِع تحليل محتوى رسالة واجهة برمجة التطبيقات باستخدام الإحصاءات المخصّصة للحصول على مثال كامل يوضّح كيفية جمع بيانات الإحصاءات المخصّصة.
الاختلافات بين بيانات "إحصاءات Google" وبيانات واجهة برمجة تطبيقات المراقبة
يصف هذا القسم بعض الاختلافات الطفيفة بين البيانات التي تجمعها Edge Analytics مقارنةً بمراقبة واجهة برمجة التطبيقات. نظرًا لأنّ مراقبة واجهة برمجة التطبيقات و"إحصاءات Google" تستخدم مسارات بيانات مختلفة، قد تلاحظ اختلافات طفيفة بين التقارير المخصّصة التي تنشئها المراقبة والتقارير التي تنشئها خدمة "إحصاءات Google". على سبيل المثال، قد تلاحظ اختلافات في النتائج المبلّغ عنها عن أخطاء المهلة، سواء المهلات الخلفية (رمز حالة HTTP 504 عند الطلب) أو المُهلات العميلة (رمز حالة HTTP 499). وقد تظهر هذه الرموز مع رمز الحالة 200 في التقارير المخصصة على "إحصاءات Google"، وستظهر مع رمز الحالة 504 أو 499 في تقارير مراقبة مخصّصة.متى تكون بيانات الإحصاءات متوفّرة ولأي مدة؟
هناك فاصلان زمنيان يتحكّمان في وقت عرض بيانات الإحصاءات ومدة عرضها:
- الفاصل الزمني لتأخُّر البيانات: بعد إجراء طلب بيانات إلى خادم وكيل لواجهة برمجة التطبيقات، قد يستغرق الأمر ما يصل إلى 10 دقائق حتى يصبح الوصول إلى البيانات متاحًا للعرض أو من خلال طلبات بيانات من واجهة برمجة التطبيقات للإدارة.
- الاحتفاظ بالبيانات: هي المدة الزمنية التي يتم خلالها الاحتفاظ ببيانات الإحصاءات من خلال اختلافات حسب الخطة في Edge. استنادًا إلى خطتك، قد تكون بيانات الإحصاءات متاحة خلال آخر 30 أو 60 أو 90 أو 365 يومًا.
كيف يمكنني الوصول إلى بيانات الإحصاءات؟
توفّر "إحصاءات Edge API" أدوات لعرض البيانات مضمّنة في واجهة مستخدم Edge. وتشمل هذه الأدوات لوحات بيانات إحصاءات محددة مسبقًا وتقارير مخصّصة تعرض البيانات في رسومات بيانية ومخطّطات، وتتيح لك التوغّل للاطّلاع على البيانات مجمّعة في سمات مختلفة (مثل الخادم الوكيل لواجهة برمجة التطبيقات أو عنوان IP أو رمز حالة HTTP).
بالإضافة إلى ذلك، يمكنك تنزيل بيانات الإحصاءات باستخدام واجهة برمجة تطبيقات إدارة Edge. وبعد تنزيلها، يمكنك استيراد هذه البيانات إلى أدوات التمثيل البصري للبيانات الخاصة بك أو نظام الإحصاءات.
لوحات بيانات "إحصاءات Google"
توفّر واجهة مستخدم Edge مجموعة من لوحات البيانات المحدّدة مسبقًا والتي يمكنك استخدامها لعرض بيانات الإحصاءات. على سبيل المثال، تعرض الصور التالية لوحة بيانات أداء الخادم الوكيل:
تحتوي لوحة البيانات هذه على رسومات بيانية لما يلي:
- إجمالي عدد الزيارات: إجمالي عدد طلبات البيانات من واجهة برمجة التطبيقات التي تلقّتها Edge في بيئة واجهة برمجة تطبيقات في مؤسسة.
- اكتمل عدد الزيارات - إجمالي عدد الطلبات التي أدت إلى استجابة ناجحة. ولا يتم احتساب استجابات الخطأ.
- أخطاء في الزيارات: إجمالي عدد جميع طلبات البيانات من واجهة برمجة التطبيقات التي لم تنجح، أي أنّ الطلب لا يقدّم ردًّا. يشمل العدد كلاً من أخطاء الخادم الوكيل (من جانب واجهة برمجة التطبيقات) وأخطاء الهدف (خدمات الخلفية).
- متوسط تقنية TPS: متوسط عدد طلبات البيانات من واجهة برمجة التطبيقات والردود الناتجة في الثانية.
تشمل لوحات البيانات الإضافية المحدَّدة مسبقًا ما يلي:
- أداء ذاكرة التخزين المؤقت
- تفاعل مطوّري البرامج
- استخدام الجهاز
- تحليل رمز الخطأ
- الموقع الجغرافي
- تحليل وقت الاستجابة
- الأداء المستهدَف
- تشكيل الزيارات
لمزيد من المعلومات حول لوحات البيانات هذه المحددة مسبقًا، يُرجى الاطّلاع على مقالة استخدام لوحات بيانات الإحصاءات.
التقارير المخصصة
تتيح لك التقارير المخصّصة التعمّق في مقاييس محدّدة لواجهة برمجة التطبيقات وعرض البيانات الدقيقة التي تريد الاطّلاع عليها. يمكنك إنشاء تقرير مخصّص باستخدام أي من بيانات الإحصاءات المضمّنة في Edge أو بيانات الإحصاءات التي تم جمعها من خلال سياسة جمع الإحصاءات.
عند إنشاء تقرير مخصّص، يمكنك اختيار البيانات التي تريد الاطّلاع عليها (المقاييس)، وتجميع البيانات بطرق مفيدة (السمات) وتقييد البيانات اختياريًا استنادًا إلى خصائص معيّنة للبيانات (الفلترة).
ويمكنك أيضًا ضبط نوع الرسم البياني المعروض في التقرير المخصّص على شكل عمود أو رسم بياني خطي. توضّح الصور التالية أمثلة على الرسم البياني للمعاملات في الثانية المجمّعة حسب الخادم الوكيل لواجهة برمجة التطبيقات:
العمود - يتم تمثيل كل خادم وكيل لواجهة برمجة التطبيقات بعمود مختلف:
السطر - يتم تمثيل كل خادم وكيل لواجهة برمجة التطبيقات بحيث يكون سطرًا مختلفًا:
ولمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء التقارير المخصّصة وإدارتها.
Analytics API
استخدم واجهة برمجة تطبيقات إدارة Edge لتنزيل بيانات الإحصاءات. على سبيل المثال، يمكنك استخدام واجهة برمجة التطبيقات لإنشاء أدواتك المرئية التي يمكنك تضمينها في البوابات أو التطبيقات المخصصة.
في ما يلي مثال على طلب بيانات من واجهة برمجة التطبيقات لاسترداد بيانات الإحصاءات المتعلقة بالخوادم الوكيلة لواجهة برمجة التطبيقات:
curl https://api.enterprise.apigee.com/v1/o/org_name/environments/test/stats/apiproxy?"select=sum(message_count)&timeRange=6/24/2018%2000:00~6/24/2018%2023:59&timeUnit=hour" \ -u email:password
ترِد هذه المكالمة:
- مجموع الطلبات (عدد الرسائل) لكل خادم وكيل لواجهة برمجة التطبيقات
- لمدة 24 ساعة
- مجمّعة حسب الساعة
تحدِّد معلَمة طلب البحث timeRange الفترة الزمنية في النموذج:
?timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM
يُرجى ملاحظة %20 قبل HH:MM. تتطلب المعلَمة timeRange
حرف مسافة مشفّرًا بعنوان URL قبل HH:MM، أو حرف +، كما في:
MM/DD/YYYY+HH:MM~MM/DD/YYYY+HH:MM.
ولمزيد من المعلومات، يُرجى الاطّلاع على استخدام واجهات برمجة تطبيقات المقاييس لقياس أداء برنامج واجهة برمجة التطبيقات.
تصدير بيانات الإحصاءات إلى Google Cloud
يمكنك استخدام واجهة برمجة تطبيقات إدارة Edge لتصدير جميع بيانات الإحصاءات ليوم كامل من Edge إلى مستودع البيانات الخاص بك، مثل Google Cloud Storage أو BigQuery. يمكنك بعد ذلك الاستفادة من إمكانات طلب البحث وتعلُّم الآلة الفعّالة التي تقدّمها Google Cloud BigQuery وTensorFlow لإجراء تحليل للبيانات.
ولمزيد من المعلومات، يُرجى الاطّلاع على تصدير البيانات من "إحصاءات Google".
كيف يمكنني مشاركة البيانات مع مطوّري التطبيقات؟
عندما تفكّر في أنّ مطوّري التطبيقات هم عملاؤك، يجب أن تتأكّد من توفرهم الأدوات والمعلومات المتاحة لهم للاستفادة إلى أقصى حد من واجهة برمجة التطبيقات.
لا يهتم مطوّرو التطبيقات فقط بجودة تطبيقاتهم، بل مهتمون جدًا بواجهات برمجة التطبيقات. تتضمن بوابات مطوّري البرامج المستندة إلى Drupal صفحة أداء التطبيق الاختيارية المصممة لمنح مطوّري التطبيقات إمكانية الوصول إلى المقاييس المهمة لتطبيقاتهم. تقدّم هذه الصفحة لمطوّري البرامج معلومات عن:
- الأخطاء: ما هي أخطاء واجهة برمجة التطبيقات التي تظهر لتطبيقي؟
- الأداء: هل واجهة برمجة التطبيقات بطيئة الآن؟ ما هي طرق واجهة برمجة التطبيقات التي عادةً ما تكون بطيئة أو بطيئة في الوقت الحالي؟
- مدى التوفّر: هل تتّخذ واجهة برمجة التطبيقات ارتفاعًا أو انخفاضًا في الوقت الحالي؟
- الحصة: هل تتوفّر حصة في واجهة برمجة التطبيقات؟ وبصفتي مطوّر التطبيقات، كيف أتعامل مع الحصة؟
لمزيد من المعلومات، يرجى الاطّلاع على:
- Drupal 7: عرض إحصاءات لاستخدام التطبيق
- Drupal 8: مراقبة التطبيقات
- البوابة المتكاملة: غير متاحة
بالإضافة إلى ذلك، يمكنك مشاركة الإحصاءات مع مطوّري البرامج من خلال:
- إنشاء تقارير مخصّصة ومشاركتها مع مطوّري التطبيقات ولمزيد من المعلومات، يُرجى الاطّلاع على إنشاء تقارير مخصّصة.
- استخدام واجهة برمجة تطبيقات إدارة Edge لالتقاط البيانات على مدار فترة زمنية أطول لمشاركتها مع مطوّري التطبيقات بلا اتصال بالإنترنت ولمزيد من المعلومات، يُرجى الاطّلاع على استخدام واجهات برمجة تطبيقات المقاييس لقياس أداء برنامج واجهة برمجة التطبيقات.
كيف يمكنني إنشاء بيانات إحصاءات كاملة؟
ما المقصود بالإحصاءات الكاملة؟ يمكنك مثلاً إنشاء خادم وكيل لواجهة برمجة التطبيقات وسيجمع تطبيق Edge بيانات الإحصاءات حول ذلك الخادم الوكيل. ماذا عن المقاييس للمطوّر أو التطبيق الذي يُطلق عليه اسم الخادم الوكيل لواجهة برمجة التطبيقات؟ إذا لم يكن متصفِّح Edge يعرف مَن أجرى طلب بيانات من واجهة برمجة التطبيقات، لن يتمكّن من جمع هذه البيانات.
يجب تنفيذ بعض الخطوات للسماح لحساب Edge بتحديد مطوّري البرامج وتطبيقات المطوّرين التي تطلب الخوادم الوكيلة لواجهة برمجة التطبيقات. وفي ما يلي قائمة بهذه الخطوات مع روابط تؤدي إلى معلومات أكثر تفصيلاً:
- أنشئ منتجًا واحدًا أو أكثر من واجهات برمجة التطبيقات، وهو عبارة عن مجموعة من الخوادم الوكيلة لواجهة برمجة التطبيقات إلى جانب خطة خدمة. يُرجى الاطّلاع على إدارة منتجات واجهة برمجة التطبيقات.
- تسجيل مطوّري التطبيقات باستخدام Edge. يُرجى الاطّلاع على تسجيل مطوّري التطبيقات.
- تسجيل التطبيقات وإنشاء مفاتيح واجهة برمجة التطبيقات لمطوّري البرامج. يُرجى الاطّلاع على القسم تسجيل التطبيقات وإدارة مفاتيح واجهة برمجة التطبيقات.
- أضِف سياسات أمان إلى الخوادم الوكيلة لواجهة برمجة التطبيقات التي تتحقّق من مفاتيح واجهة برمجة التطبيقات و/أو الرموز المميّزة للأمان. يمكنك الاطّلاع على المواضيع التالية:التحقّق من سياسة مفتاح واجهة برمجة التطبيقات وسياسة OAuthV2 والتحقّق من سياسة JWT.
- إذا كنت تستخدم Edge Microgateway، احرص على تفعيل المكوّن الإضافي لخدمة "إحصاءات Google" (الذي يتم تفعيله تلقائيًا). في حال إيقاف المكوّن الإضافي لخدمة "إحصاءات Google"، لن ترسِل شركة Edge Microgateway بيانات الإحصاءات إلى "إحصاءات Edge".
توضّح البرامج التعليمية التالية الخطوات اللازمة التي تتيح لك الاطّلاع على إحصاءات لمطوّري البرامج والتطبيقات: تأمين واجهة برمجة تطبيقات من خلال طلب مفاتيح واجهة برمجة التطبيقات وتأمين واجهة برمجة تطبيقات باستخدام OAuth.
مقارنة واجهة برمجة تطبيقات الإحصاءات بمراقبة واجهة برمجة التطبيقات
يمكنك الاستفادة من كل من EdgeMonitoring وAPI API في Analytics. تفحص واجهة برمجة التطبيقات الخاصة بالمراقبة بيانات الإحصاءات لتوفير إحصاءات سياقية في الوقت الفعلي حول أداء واجهة برمجة التطبيقات، ما يسمح بتشخيص المشاكل بسرعة وتسهيل الإجراءات التي تهدف إلى استمرارية العمل. تم تصميم مراقبة واجهة برمجة التطبيقات للعثور بسرعة على المشاكل في واجهات برمجة التطبيقات والخلفيات. تم تصميم إحصاءات واجهة برمجة التطبيقات للحصول على مجموعة واسعة من بيانات الإحصاءات لاستخدامها من خلال عدة فِرق مختلفة، ولكن عادةً ما يتم استخدام البيانات للتحليل في سيناريوهات الوقت الفعلي.
يتمثل أحد الاختلافات الأساسية بين مراقبة واجهة برمجة التطبيقات وإحصاءات واجهة برمجة التطبيقات في آلية التنبيه المدمجة في مراقبة واجهة برمجة التطبيقات. عند استخدام التنبيهات، يمكنك تحديد رمز حالة HTTP (2xx/4xx/5xx) أو وقت الاستجابة أو رمز الخطأ الذي يؤدي إلى تجاوز إشعار التنبيه إلى فريق العمليات لديك. ويمكن إرسال إشعارات التنبيه من خلال قنوات متعددة، مثل البريد الإلكتروني أو Slack أو صفحات الويب أو الردود التلقائية على الويب، ما يتيح لك الردّ على المشاكل على الفور.
يمكنك الاطّلاع على مقارنة بين مراقبة واجهة برمجة التطبيقات و"إحصاءات واجهة برمجة تطبيقات Edge" للحصول على مقارنة أكثر تفصيلاً بين هذه الخدمات.