أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. info
يقدّم هذا الموضوع لمحة عن Edge API Analytics.
فيديو: شاهِد فيديو قصيرًا للحصول على نظرة عامة على خدمات Edge API في "إحصاءات Google".
تحسين واجهة برمجة التطبيقات من خلال الإحصاءات
تجمع ميزة Edge API Analytics مجموعة كبيرة من المعلومات التي تتدفق من خلال وكلاء واجهات برمجة التطبيقات وتحسبها. يمكنك عرض هذه البيانات باستخدام الرسوم البيانية في واجهة مستخدم Edge، أو يمكنك تنزيل البيانات الأولية لتحليلها بلا إنترنت باستخدام واجهات برمجة تطبيقات إدارة Edge.
تساعدك "إحصاءات YouTube" في الإجابة عن أسئلة شائعة، مثل:
- كيف يتغيّر عدد الزيارات إلى واجهة برمجة التطبيقات بمرور الوقت؟
- ما هي طرق واجهة برمجة التطبيقات الأكثر شيوعًا؟
- من هم أبرز المطوّرين لديّ؟
- متى يكون وقت استجابة واجهة برمجة التطبيقات أسرع؟ هل هو الأبطأ؟
- من حيث الموقع الجغرافي، أين أرى أكبر عدد من زيارات واجهة برمجة التطبيقات؟
تساعدك الإجابات عن أسئلة مثل هذه في تحسين واجهات برمجة التطبيقات وتحديد المشاكل وحلّها واتخاذ قرارات أفضل بشأن نشاطك التجاري في ما يتعلّق ببرنامج واجهات برمجة التطبيقات.
تساعد ميزة "إحصاءات واجهة برمجة التطبيقات" الجميع في تحسين الأداء.
من خلال عملية مستمرة لجمع البيانات وتحليلها وعرضها بيانيًا، تساعد ميزة "إحصاءات Edge API" فريق واجهة برمجة التطبيقات على تحسين واجهات برمجة التطبيقات الخاصة به ويساعد مطوّري التطبيقات على تحسين تطبيقاتهم:
- فريق واجهات برمجة التطبيقات: يستفيد فريق واجهات برمجة التطبيقات من الأنظمة الداخلية لإنشاء واجهات برمجة تطبيقات مثيرة للاهتمام. يريد فريق واجهات برمجة التطبيقات معرفة مستوى أداء برنامج واجهات برمجة التطبيقات بشكل عام، ومستوى أداء واجهات برمجة التطبيقات الفردية، وكيفية تحسين واجهات برمجة التطبيقات.
- مطوّرو التطبيقات: من خلال مشاركة معلومات الإحصاءات مع مطوّري التطبيقات، يمكنك الحصول على تطبيقات أفضل. يقدّم هؤلاء المطوّرون حلولاً مبتكرة باستخدام واجهة برمجة التطبيقات الخاصة بك وينشئون تطبيقات إبداعية تساعد في زيادة أرباح مؤسستك. تساعد "إحصاءات Google" مطوّري التطبيقات في معرفة مستوى أداء تطبيقاتهم ومقدار مساهمتها في تحقيق أرباح مؤسستك. يريد مطوّرو التطبيقات معرفة كيفية تحسين تطبيقاتهم.
- فريق العمليات: يريد فريق العمليات فهم أنماط الزيارات والتوقّع في الوقت المناسب لإضافة موارد الخلفية أو إجراء تعديلات مهمة أخرى.
- مالك النشاط التجاري: يريد مالك النشاط التجاري معرفة مدى فعالية استثماره في واجهة برمجة التطبيقات ومعرفة أوجه الاستثمار المستقبلية في واجهة برمجة التطبيقات.
ما هو نوع البيانات التي يتم جمعها وتحليلها؟
تجمع ميزة "إحصاءات واجهات برمجة التطبيقات في Edge" مجموعة كبيرة من البيانات التي تتدفق عبر وكلاء واجهات برمجة التطبيقات، مثل:
- مدة الردّ
- وقت استجابة الطلب
- حجم الطلب
- أخطاء الاستهداف
- اسم المنتج في واجهة برمجة التطبيقات
- عنوان البريد الإلكتروني للمطوِّر
- اسم التطبيق
- والعديد من الأنواع الأخرى
للحصول على قائمة كاملة بالبيانات التي تجمعها "إحصاءات Google" من خلال واجهة برمجة التطبيقات، اطّلِع على مرجع مقاييس "إحصاءات Google" وسمات وفلاتر.
كيف يمكنني جمع بيانات الإحصاءات المخصّصة؟
يجمع Edge مجموعة كبيرة من البيانات تلقائيًا. قد تحتاج أيضًا إلى جمع بيانات إحصاءات مخصّصة تتعلّق بالتطبيقات أو المنتجات أو المطوّرين أو الخوادم الوكيلة لواجهات برمجة التطبيقات. على سبيل المثال، قد تحتاج إلى جمع بيانات الإحصاءات من مَعلمات طلب البحث أو عناوين الطلبات أو نصوص الطلبات والردود أو المتغيّرات التي تحدّدها في واجهات برمجة التطبيقات.
تجمع بيانات إحصاءات مخصّصة باستخدام سياسة StatisticsCollector. بعد استخراج البيانات المخصّصة، يمكنك استخدام واجهة مستخدم الإحصاءات أو واجهة برمجة التطبيقات لفحص البيانات. اطّلِع على تحليل محتوى رسالة واجهة برمجة التطبيقات باستخدام الإحصاءات المخصّصة للاطّلاع على مثال كامل يوضّح كيفية جمع بيانات الإحصاءات المخصّصة.
الاختلافات بين بيانات "إحصاءات Google" وبيانات "مراقبة واجهة برمجة التطبيقات"
يوضّح هذا القسم بعض الاختلافات البسيطة بين البيانات التي يجمعها Edge Analytics مقارنةً ببيانات "مراقبة واجهة برمجة التطبيقات". بما أنّ ميزة "مراقبة واجهة برمجة التطبيقات" و"إحصاءات واجهة برمجة التطبيقات" تستخدمان قنوات تدفق بيانات مختلفة، قد تلاحظ اختلافات طفيفة بين التقارير المخصّصة التي تنشئها ميزة "المراقبة" والتقارير التي تنشئها ميزة "إحصاءات واجهة برمجة التطبيقات". على سبيل المثال، قد تلاحظ اختلافات في النتائج التي تم الإبلاغ عنها لأخطاء وقت الاستراحة، سواء كانت أخطاء وقت استراحة في الخلفية (رمز حالة HTTP 504 للطلب) أو أخطاء وقت استراحة في العميل (رمز حالة HTTP 499). قد تظهر هذه الرسائل برمز الحالة 200 في التقارير المخصّصة في "إحصاءات Google"، ولكنّها ستظهر برمز الحالة 504 أو 499 في التقارير المخصّصة للتتبّع.متى تُتاح بيانات الإحصاءات وما هي مدة إتاحتها؟
هناك فترتان زمنيتان تتحكّمان في وقت ومدة عرض بيانات الإحصاءات:
- فاصل تأخُّر البيانات: بعد إجراء طلب إلى وكيل واجهة برمجة التطبيقات، يمكن أن يستغرق الوصول إلى البيانات لعرضها أو من خلال طلبات البيانات من واجهة برمجة التطبيقات الإدارية مدة تصل إلى 10 دقائق.
- الاحتفاظ بالبيانات:
تعتمد المدة التي يتم فيها الاحتفاظ ببيانات "إحصاءات Google" على خطة الاشتراك:
- عادي: 30 يومًا
- Enterprise: 3 أشهر
- Enterprise Plus: 14 شهرًا
كيف يمكنني الوصول إلى بيانات الإحصاءات؟
توفّر واجهة برمجة التطبيقات Edge API Analytics أدوات تصور البيانات المضمّنة في واجهة مستخدم Edge. وتشمل هذه الأدوات لوحات بيانات تحليلية محدّدة مسبقًا وتقارير مخصّصة تعرِض البيانات في الرسومات البيانية والرسومات البيانية وتسمح لك بالاطّلاع على البيانات المجمّعة في سمات مختلفة (مثلاً حسب وكيل واجهة برمجة التطبيقات أو عنوان IP أو رمز حالة HTTP).
بالإضافة إلى ذلك، يمكنك تنزيل بيانات الإحصاءات باستخدام Edge management API. بعد تنزيلها، يمكنك استيراد هذه البيانات إلى أدوات التمثيل البصري للبيانات أو نظام الإحصاءات الخاص بك.
لوحات بيانات "إحصاءات Google"
توفّر واجهة مستخدم Edge مجموعة من لوحات البيانات المحدّدة مسبقًا التي يمكنك استخدامها لعرض بيانات الإحصاءات. على سبيل المثال، تعرض الصور التالية لوحة بيانات أداء الخادم الوكيل:
تتضمّن لوحة البيانات هذه الرسومات البيانية التالية:
- إجمالي عدد الزيارات: إجمالي عدد طلبات البيانات من واجهة برمجة التطبيقات التي تلقّتها Edge لواجهة برمجة التطبيقات في مؤسسة.
- نجاح عدد الزيارات: إجمالي عدد الطلبات التي أدّت إلى استجابة ناجحة. ولا يتم احتساب الردود التي تتضمّن أخطاء.
- أخطاء الزيارات: إجمالي عدد جميع طلبات البيانات من واجهة برمجة التطبيقات التي تعذّر تنفيذها، أي أنّ الطلب لا يقدّم ردًا. ويشمل العدد كلّ من أخطاء الوكيل (من جانب Apigee) وأخطاء الاستهداف (خدمات الخلفية).
- متوسط عدد طلبات البيانات في الثانية: متوسط عدد طلبات البيانات والردود الناتجة عنها في الثانية.
تشمل لوحات البيانات المحدّدة مسبقًا الإضافية ما يلي:
- أداء ذاكرة التخزين المؤقت
- تفاعل المطوّرين
- استخدام الجهاز
- تحليل رموز الخطأ
- GeoMap
- تحليل وقت الاستجابة
- استهداف الأداء
- تركيبة الزيارات
لمزيد من المعلومات عن لوحات البيانات المحدّدة مسبقًا هذه، يُرجى الاطّلاع على استخدام لوحات بيانات الإحصاءات.
التقارير المخصصة
تتيح لك التقارير المخصّصة الانتقال إلى التفاصيل في مقاييس معيّنة لواجهة برمجة التطبيقات وعرض البيانات الدقيقة التي تريد الاطّلاع عليها. يمكنك إنشاء تقرير مخصّص باستخدام أيّ من بيانات الإحصاءات المضمّنة في Edge أو بيانات الإحصاءات المخصّصة التي جمعتها سياسة StatisticsCollector.
عند إنشاء تقرير مخصّص، يمكنك اختيار البيانات التي تريد الاطّلاع عليها (المقاييس)، وتجميع البيانات بطرق مفيدة (السمات)، وحصر البيانات المعروضة اختياريًا استنادًا إلى خصائص معيّنة للبيانات (الفلترة).
يمكنك أيضًا ضبط نوع الرسم البياني المعروض في التقرير المخصّص على أنّه رسم بياني عمودي أو خطي. تعرض الصور التالية أمثلة على الرسوم البيانية للمعاملات في الثانية مجمّعة حسب الوكيل لواجهة برمجة التطبيقات:
العمود: يمثّل كل وكيل واجهة برمجة تطبيقات عمودًا مختلفًا:
السطر: يتم تمثيل كل وكيل لواجهة برمجة التطبيقات بسطر مختلف:
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء التقارير المخصّصة وإدارتها.
Analytics API
استخدِم Edge management API لتنزيل بيانات الإحصاءات. على سبيل المثال، يمكنك استخدام واجهة برمجة التطبيقات لإنشاء أدوات العروض المرئية الخاصة بك التي يمكنك تضمينها في البوابات أو التطبيقات المخصّصة.
في ما يلي مثال على طلب بيانات من واجهة برمجة التطبيقات لاسترداد بيانات الإحصاءات لمثيل واجهة برمجة التطبيقات:
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 management API لتصدير جميع بيانات الإحصاءات ليوم كامل من Edge إلى مستودع البيانات الخاص بك، مثل Google Cloud Storage أو BigQuery. يمكنك بعد ذلك الاستفادة من إمكانات الاستعلامات وتعلُّم الآلة القوية التي يوفّرها Google Cloud BigQuery وTensorFlow لإجراء تحليل البيانات بنفسك.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تصدير البيانات من "إحصاءات Google".
كيف يمكنني مشاركة البيانات مع مطوّري التطبيقات؟
عندما تتعامل مع مطوّري التطبيقات على أنّهم عملاؤك، عليك التأكّد من توفّر الأدوات والمعلومات لهم للاستفادة إلى أقصى حدّ من واجهة برمجة التطبيقات.
لا يقتصر اهتمام مطوّري التطبيقات على جودة تطبيقاتهم، بل يهتمون أيضًا بوجوهات برمجة التطبيقات. تتضمّن بوابات المطوّرين المستندة إلى Drupal صفحة أداء التطبيق اختيارية مصمّمة لمنح مطوّري التطبيقات إمكانية الوصول إلى المقاييس المهمة لتطبيقاتهم. تقدّم هذه الصفحة للمطوّرين معلومات عن:
- الأخطاء: ما هي أخطاء واجهة برمجة التطبيقات التي يواجهها تطبيقي؟
- الأداء: هل واجهة برمجة التطبيقات بطيئة الآن؟ ما هي طُرق واجهة برمجة التطبيقات التي تكون بطيئة عادةً أو بطيئة في الوقت الحالي؟
- مدى التوفّر: هل واجهة برمجة التطبيقات متاحة حاليًا أم لا؟
- الحصة: هل لديك حصة لواجهة برمجة التطبيقات؟ بصفتي مطوّر التطبيق، كيف أبلي بحالٍ مقارنةً بالحصة؟
لمزيد من المعلومات، يُرجى الاطّلاع على:
- Drupal 7: عرض الإحصاءات لاستخدام التطبيق
- Drupal 8: مراقبة التطبيقات
- بوابة مدمجة: غير متاحة
بالإضافة إلى ذلك، يمكنك مشاركة الإحصاءات مع المطوّرين من خلال:
- إنشاء تقارير مخصّصة ومشاركتها مع مطوّري التطبيقات لمزيد من المعلومات، اطّلِع على إنشاء تقارير مخصّصة.
- استخدام واجهة برمجة التطبيقات Edge management API لتسجيل البيانات على مدار فترة زمنية أوسع لمشاركتها مع مطوّري التطبيقات بلا إنترنت لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام واجهات برمجة تطبيقات المقاييس لقياس أداء برنامج واجهات برمجة التطبيقات.
كيف يمكنني إنشاء بيانات تحليلات كاملة؟
ما المقصود بالتحليلات الكاملة؟ على سبيل المثال، يمكنك إنشاء وكيل لواجهة برمجة التطبيقات وسيجمع Edge بيانات الإحصاءات عن هذا الوكيل. ماذا عن مقاييس المطوّر أو التطبيق الذي استدعى خادم وكيل واجهة برمجة التطبيقات؟ إذا لم يكن متصفح Edge يعرف مَن أجرى طلبًا إلى واجهة برمجة التطبيقات، لن يتمكّن من جمع هذه البيانات.
يجب اتّباع بعض الخطوات للسماح لـ Edge بمعرفة المطوّرين وتطبيقات المطوّرين التي تستدعي أدوات الربط لواجهات برمجة التطبيقات. في ما يلي قائمة بهذه الخطوات مع روابط إلى معلومات أكثر تفصيلاً:
- إنشاء منتج واحد أو أكثر من منتجات واجهات برمجة التطبيقات، وهي مجموعة من الوكلاء لواجهة برمجة التطبيقات بالإضافة إلى خطة خدمة اطّلِع على إدارة منتجات واجهة برمجة التطبيقات.
- تسجيل مطوّري التطبيقات باستخدام Edge يُرجى الاطّلاع على تسجيل مطوّري التطبيقات.
- تسجيل التطبيقات وإنشاء مفاتيح واجهة برمجة التطبيقات للمطوّرين راجِع مقالة تسجيل التطبيقات وإدارة مفاتيح واجهة برمجة التطبيقات.
- إضافة سياسات أمان إلى الخوادم الوكيلة لواجهات برمجة التطبيقات التي تُثبت صحة مفاتيح واجهة برمجة التطبيقات و/أو الرموز المميّزة لأمانها اطّلِع على المواضيع التالية:سياسة التحقّق من مفتاح واجهة برمجة التطبيقات وسياسة OAuthV2 وسياسة التحقّق من JWT.
- إذا كنت تستخدِم Edge Microgateway، تأكَّد من تفعيل المكوّن الإضافي للإحصاءات (الذي يكون مفعّلاً تلقائيًا). في حال إيقاف مكوّن تحليلات الأداء الإضافي، لن ترسل بوابة Edge Microgateway بيانات التحليلات إلى تحليلات Edge.
ترشدك الأدلة التعليمية التالية خلال الخطوات اللازمة التي تتيح لك الاطّلاع على إحصاءات المطوّرين والتطبيقات: تأمين واجهة برمجة تطبيقات من خلال طلب مفاتيح واجهة برمجة التطبيقات وتأمين واجهة برمجة تطبيقات باستخدام OAuth.
مقارنة "إحصاءات واجهة برمجة التطبيقات" بميزة "مراقبة واجهة برمجة التطبيقات"
يمكنك الاستفادة من كلّ من مراقبة واجهة برمجة التطبيقات و"إحصاءات واجهة برمجة التطبيقات" في Edge. تفحص ميزة "مراقبة واجهة برمجة التطبيقات" بيانات الإحصاءات لتقديم إحصاءات سياقية في الوقت الفعلي حول أداء واجهة برمجة التطبيقات، ما يتيح لك تشخيص المشاكل بسرعة وتسهيل الإجراءات التصحيحية لضمان استمرارية النشاط التجاري. تم تصميم ميزة "مراقبة واجهة برمجة التطبيقات" للعثور بسرعة على المشاكل في واجهات برمجة التطبيقات وخدمات الخلفية. تم تصميم ميزة "إحصاءات واجهة برمجة التطبيقات" لتسجيل مجموعة كبيرة من بيانات الإحصاءات لاستخدامها من قِبل عدة فِرق مختلفة، ولكن يتم استخدام البيانات عادةً للتحليل في سيناريوهات غير فورية.
من بين الاختلافات الأساسية بين "مراقبة واجهة برمجة التطبيقات" و"إحصاءات واجهة برمجة التطبيقات" آلية التنبيه المضمّنة في "مراقبة واجهة برمجة التطبيقات". باستخدام التنبيهات، يمكنك تحديد رمز حالة HTTP (2xx/4xx/5xx) أو وقت الاستجابة أو رمز خطأ الحدّ الذي يؤدي تجاوزه إلى تشغيل إشعار تنبيه لفريق العمليات. يمكن إرسال إشعارات التنبيهات من خلال مجموعة متنوعة من القنوات، مثل البريد الإلكتروني أو Slack أو أجهزة إرسال الرسائل القصيرة أو وحدات ربط البيانات، ما يتيح لك الردّ على المشاكل على الفور.
اطّلِع على مقارنة ميزة "مراقبة واجهة برمجة التطبيقات" مع ميزة "إحصاءات واجهة برمجة التطبيقات في Edge" لمقارنة أكثر تفصيلاً بين هاتين الخدمتَين.