نظرة عامة على Analytics API

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X.
معلومات

يتناول هذا الموضوع إحصاءات واجهة برمجة التطبيقات Edge.

فيديو: شاهِد فيديو قصيرًا للحصول على نظرة عامة على خدمات إحصاءات واجهة برمجة تطبيقات Edge.

تحسين واجهة برمجة التطبيقات من خلال الإحصاءات

تجمع إحصاءات واجهة برمجة التطبيقات Edge وتحسب قدرًا كبيرًا من المعلومات التي تتدفق من خلال الخوادم الوكيلة لواجهة برمجة التطبيقات. يمكنك تصور هذه البيانات باستخدام الرسوم البيانية والمخططات في واجهة مستخدم Edge، أو يمكنك تنزيل البيانات الأولية تحليلاً بلا اتصال بالإنترنت باستخدام واجهات برمجة التطبيقات لإدارة Edge.

تساعدك "إحصاءات Google" في الإجابة عن أسئلة شائعة مثل:

  • ما مدى رواج زيارات واجهة برمجة التطبيقات بمرور الوقت؟
  • ما هي طرق واجهة برمجة التطبيقات الأكثر شيوعًا؟
  • من هم أفضل مطوّري التطبيقات لديّ؟
  • ما هو أسرع وقت استجابة لواجهة برمجة التطبيقات؟ الأبطأ؟
  • من الناحية الجغرافية، أين يمكنني العثور على أكبر عدد من زيارات واجهة برمجة التطبيقات؟

تساعدك الإجابات عن مثل هذه الأسئلة في تحسين واجهات برمجة التطبيقات، وتحديد المشاكل وحلّها، والحصول على نتائج الخاصة ببرنامج واجهة برمجة التطبيقات الخاص بك.

تساعد تحليلات واجهة برمجة التطبيقات الجميع على التحسن

من خلال عملية مستمرة لجمع البيانات وتحليلها وتمثيلها بيانيًا، تساعدك خدمة Edge API Analytics يمكن لفريق واجهة برمجة التطبيقات تحسين واجهات برمجة التطبيقات ومساعدة مطوّري التطبيقات على تحسين تطبيقاتهم:

النص البديل
  • فريق واجهة برمجة التطبيقات: يستخدم فريق واجهة برمجة التطبيقات الأنظمة الداخلية لإنشاء واجهات برمجة تطبيقات مثيرة للاهتمام. يريد فريق واجهة برمجة التطبيقات معرفة مستوى أداء برنامج واجهة برمجة التطبيقات بشكل عام، ومستوى أداء واجهات برمجة التطبيقات الفردية، وكيفية تحسين واجهات برمجة التطبيقات.
  • مطوّرو التطبيقات: من خلال مشاركة معلومات الإحصاءات مع مطوّري التطبيقات، تحصل على تطبيقات أفضل. يبتكر هؤلاء المطورون باستخدام واجهة برمجة التطبيقات الخاصة بك وينشئون تطبيقات إبداعية تساعد في زيادة إلى مؤسستك تساعد خدمة "إحصاءات Google" مطوّري التطبيقات في معرفة مستوى أداء تطبيقاتهم ومقدار أدائها يساهم في تحقيق الأرباح لمؤسستك يرغب مطوّرو التطبيقات في معرفة كيفية تحسين تطبيقاتهم.
  • فريق العمليات: يريد فريق العمليات فهم أنماط الزيارات توقع وقت إضافة موارد الخلفية أو إجراء تعديلات مهمة أخرى.
  • مالك النشاط التجاري: يريد مالك النشاط التجاري معرفة كيفية إجراء ذلك يؤتي الاستثمارات في واجهة برمجة التطبيقات تؤتي ثمارها، ومتى يجب استثمار أموال واجهة برمجة التطبيقات في المستقبل.

ما نوع البيانات التي يتم جمعها وتحليلها؟

تجمع أداة "إحصاءات واجهة برمجة التطبيقات" (Edge) مجموعة واسعة من البيانات التي تتدفق من خلال الخوادم الوكيلة لواجهة برمجة التطبيقات وتحلِّلها، مثل:

  • مدة الردّ
  • وقت استجابة الطلب
  • حجم الطلب
  • أخطاء الاستهداف
  • اسم منتج واجهة برمجة التطبيقات
  • عنوان البريد الإلكتروني للمطوِّر
  • اسم التطبيق
  • أشخاص آخرون كثيرون

للحصول على قائمة كاملة بالبيانات التي يتم جمعها من خلال "إحصاءات واجهة برمجة التطبيقات"، يُرجى الاطّلاع على مرجع المقاييس والسمات والفلاتر في "إحصاءات Google"

كيف يمكنني جمع بيانات إحصاءات مخصّصة؟

تجمع شبكة Edge في الأصل مقدارًا كبيرًا من البيانات. قد ترغب أيضًا في جمع بيانات تحليلات مخصصة إلى الخوادم الوكيلة لواجهة برمجة التطبيقات أو التطبيقات أو المنتجات أو المطورين. على سبيل المثال، قد ترغب في جمع بيانات تحليلات من مَعلمات طلب البحث أو عناوين الطلبات أو نصوص الطلبات والاستجابة أو المتغيّرات التي تحدّدها في واجهات برمجة التطبيقات.

يمكنك جمع بيانات الإحصاءات المخصّصة باستخدام سياسة StatisticsCollector. وبعد استخراج البيانات المخصّصة، يمكنك استخدام واجهة المستخدِم أو واجهة برمجة التطبيقات في "إحصاءات Google" لفحص البيانات. الاطّلاع على مقالة تحليل محتوى الرسائل من واجهة برمجة التطبيقات باستخدام الإحصاءات المخصّصة لعرض مثال كامل يوضّح كيفية جمع بيانات إحصائية مخصّصة

الاختلافات بين بيانات "إحصاءات Google" وبيانات مراقبة واجهة برمجة التطبيقات

يصف هذا القسم بعض الاختلافات الطفيفة بين البيانات التي تم جمعها بواسطة Edge Analytics مقابل مراقبة واجهة برمجة التطبيقات. نظرًا لأن مراقبة واجهة برمجة التطبيقات و"إحصاءات Google" تستخدمان بيانات مختلفة مسارات البيانات، قد تلاحظ اختلافات طفيفة بين التقارير المخصصة التي تم إنشاؤها في إطار المراقبة والتقارير التي تم إنشاؤها بواسطة "إحصاءات YouTube" على سبيل المثال، قد ترى اختلافات في النتائج المُبلغ عنها لأخطاء المهلة - كلاً من مهلات الخلفية (رمز حالة HTTP 504 في الطلب) وانتهاء مهلة العميل (رمز حالة HTTP 499). وقد تظهر هذه المشاكل مع رمز الحالة 200 في التقارير المخصّصة على "إحصاءات Google"، ولكنها ستظهر برمز الحالة 504 أو 499 في تقارير المراقبة المخصّصة.

متى وكم ستكون بيانات تحليلاتي متاحة؟

هناك فاصلان زمنيان يتحكّمان في وقت عرض بيانات الإحصاءات ومدة عرضها:

  • الفاصل الزمني لتأخير البيانات - بعد إجراء استدعاء للخادم الوكيل لواجهة برمجة التطبيقات، قد يستغرق ما يصل إلى 10 دقائق لتصبح البيانات متاحة للعرض أو من خلال طلبات بيانات من واجهة برمجة التطبيقات للإدارة.
  • الاحتفاظ بالبيانات - مدة الاحتفاظ ببيانات الإحصاءات بواسطة Edge تختلف حسب الخطة. استنادًا إلى خطتك، قد تتوفر بيانات الإحصاءات لآخر 30 أو 60 أو 90 أو 365 يومًا.

كيف يمكنني الوصول إلى بيانات التحليلات؟

توفّر خدمة "إحصاءات واجهة برمجة التطبيقات Edge" أدوات عرض البيانات المضمَّنة في واجهة مستخدم Edge. تتضمن هذه الأدوات لوحات بيانات تحليلات محددة مسبقًا وتقارير مخصصة تعرض البيانات في رسوم بيانية ومخططات وتتيح لك توغّل للاطّلاع على البيانات مجمّعة في سمات مختلفة (مثل الخادم الوكيل لواجهة برمجة التطبيقات أو عنوان IP أو رمز حالة HTTP).

بالإضافة إلى ذلك، يمكنك تنزيل البيانات الإحصائية باستخدام واجهة برمجة تطبيقات إدارة Edge. بمجرد التنزيل، يمكنك استيراد تلك البيانات إلى أدوات تصور البيانات أو نظام التحليلات الخاص بك.

لوحات بيانات "إحصاءات Google"

توفّر واجهة مستخدم Edge مجموعة من لوحات البيانات المحددة مسبقًا التي يمكنك استخدامها لعرض بيانات الإحصاءات. على سبيل المثال، تعرض الصور التالية لوحة بيانات أداء الخادم الوكيل:

تتضمّن لوحة البيانات هذه رسومًا بيانية لما يلي:

  • إجمالي عدد الزيارات: إجمالي عدد طلبات البيانات من واجهة برمجة التطبيقات التي استلمها Edge لبيئة واجهة برمجة تطبيقات في مؤسسة.
  • نجاح الزيارات: إجمالي عدد الطلبات التي أدّت إلى استجابة ناجحة. لا تُحتسب الردود على الأخطاء.
  • أخطاء الزيارات - إجمالي عدد جميع طلبات البيانات من واجهة برمجة التطبيقات التي لم تنجح، أي أن الطلب لا يقدم ردًا. يشتمل العدد على أخطاء الخادم الوكيل (جانب Apigee) وأخطاء الاستهداف (خدمات الخلفية).
  • متوسط TPS: متوسط عدد طلبات واجهة برمجة التطبيقات والاستجابات الناتجة في الثانية.

تشمل لوحات المعلومات الإضافية المحددة مسبقًا ما يلي:

ولمزيد من المعلومات عن لوحات البيانات المحدّدة مسبقًا هذه، يُرجى الاطّلاع على مقالة استخدام لوحات بيانات الإحصاءات.

التقارير المخصصة

تتيح لك التقارير المخصّصة التوغّل في مقاييس واجهة برمجة التطبيقات المحدّدة وعرض البيانات الدقيقة التي تريد الاطّلاع عليها. يمكنك إنشاء تقرير مخصص باستخدام أي من بيانات التحليلات المضمنة في Edge أو التحليلات المخصصة البيانات التي يتم جمعها من خلال سياسة StatisticsCollector.

عند إنشاء تقرير مخصّص، يمكنك اختيار البيانات التي تريد عرضها (المقاييس)، وتجميع البيانات ذات مغزى (الأبعاد)، وتحديد البيانات التي يتم عرضها بشكل اختياري استنادًا إلى خصائص معينة للبيانات (التصفية).

يمكنك أيضًا ضبط نوع الرسم البياني المعروض في التقرير المخصّص كرسم بياني عمودي أو خطي. تعرض الصور التالية أمثلة على الرسوم البيانية للمعاملات في الثانية المجمَّعة حسب الخادم الوكيل لواجهة برمجة التطبيقات:

  • العمود: يتم تمثيل كل خادم وكيل لواجهة برمجة التطبيقات بعمود مختلف:

    رسم بياني عمودي مخصّص

  • سطر - يتم تمثيل كل خادم وكيل لواجهة برمجة التطبيقات بسطر مختلف:

    رسم بياني خطي مخصّص

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء التقارير المخصَّصة وإدارتها.

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 صفحة أداء تطبيق اختيارية مصممة لمنح مطوّري التطبيقات إمكانية الوصول إلى مقاييس مهمة لتطبيقاتهم. تقدّم هذه الصفحة للمطوّرين معلومات حول:

  • الأخطاء: ما هي أخطاء واجهة برمجة التطبيقات التي تظهر لتطبيقي؟
  • الأداء: هل واجهة برمجة التطبيقات بطيئة في الوقت الحالي؟ ما هي الطرق البطيئة لواجهة برمجة التطبيقات؟ أم بطيئة في الوقت الحالي؟
  • مدى التوفّر: هل واجهة برمجة التطبيقات تعمل أم لا في الوقت الحالي؟
  • الحصة: هل هناك حصة محدّدة لواجهة برمجة التطبيقات؟ وما هو مستوى أدائي بصفتي مطوِّر التطبيقات مقابل الحصة؟

لمزيد من المعلومات، يُرجى الاطّلاع على:

بالإضافة إلى ذلك، يمكنك مشاركة الإحصاءات مع المطوِّرين من خلال:

كيف يمكنني إنشاء بيانات تحليلات كاملة؟

ما المقصود بالتحليلات الكاملة؟ على سبيل المثال، يمكنك إنشاء خادم وكيل لواجهة برمجة التطبيقات وEdge جمع بيانات تحليلات عن هذا الخادم الوكيل ولكن ماذا عن المقاييس الخاصة بالمطور أو التطبيق والتي دعت الخادم الوكيل لواجهة برمجة التطبيقات؟ إذا لم تكن شبكة Edge تعرف المستخدم الذي طلب البيانات من واجهة برمجة التطبيقات، لن يمكنها جمع هذه البيانات.

يجب تنفيذ بضع خطوات ليتمكّن متصفّح Edge من التعرّف على المطوّرين وتطبيقاتهم عن طريق الاتصال بالخوادم الوكيلة لواجهة برمجة التطبيقات. في ما يلي قائمة بهذه الخطوات مع روابط تؤدي إلى معلومات أكثر تفصيلاً:

  1. إنشاء منتج واحد أو أكثر من منتجات واجهة برمجة التطبيقات، وهو مجموعة من الخوادم الوكيلة لواجهة برمجة التطبيقات مع خطة خدمة. راجِع إدارة منتجات واجهة برمجة التطبيقات.
  2. سجِّل مطوّري التطبيقات من خلال Edge. عرض تسجيل مطوّري التطبيقات
  3. يمكنك تسجيل التطبيقات وإنشاء مفاتيح واجهة برمجة التطبيقات للمطوّرين. عرض تسجيل التطبيقات وإدارة مفاتيح واجهة برمجة التطبيقات
  4. إضافة سياسات أمان إلى الخوادم الوكيلة لواجهة برمجة التطبيقات والتي تتحقق من مفاتيح واجهة برمجة التطبيقات و/أو الرموز المميزة للأمان راجِع المواضيع التالية:التحقُّق من سياسة مفتاح واجهة برمجة التطبيقات وسياسة OAuthV2 والتحقّق من سياسة JWT.
  5. إذا كنت تستخدم Edge Microgateway، تأكَّد من تفعيل المكوّن الإضافي للإحصاءات. (يتم تفعيله تلقائيًا). إذا تم إيقاف المكوِّن الإضافي للتحليلات، فلن ترسل Edge Microgateway بيانات التحليلات إلى إحصاءات Edge.

ترشدك البرامج التعليمية التالية خلال الخطوات اللازمة التي تتيح لك رؤية تحليلات على المطوّرين والتطبيقات: تأمين واجهة برمجة تطبيقات من خلال طلب مفاتيح واجهة برمجة التطبيقات وتأمين واجهة برمجة التطبيقات باستخدام بروتوكول OAuth.

مقارنة "إحصاءات واجهة برمجة التطبيقات" بمراقبة واجهة برمجة التطبيقات

يمكنك الاستفادة من مراقبة واجهة برمجة التطبيقات من Edge وتحليلات واجهة برمجة التطبيقات. تفحص واجهة برمجة التطبيقات بيانات الإحصاءات لتوفير إحصاءات سياقية في الوقت الفعلي حول أداء واجهة برمجة التطبيقات، ما يتيح لك تشخيص المشاكل بسرعة وتسهيل الإجراءات العلاجية لاستمرار النشاط التجاري تم تصميم "مراقبة واجهة برمجة التطبيقات" (API) للعثور سريعًا على المشاكل في واجهات برمجة التطبيقات والخلفيات. تم تصميم إحصاءات واجهة برمجة التطبيقات للحصول على مجموعة واسعة من بيانات التحليلات لتستخدمها فرق مختلفة ولكن تُستخدم البيانات عادةً للتحليل في سيناريوهات غير الوقت الفعلي.

أحد الاختلافات الأساسية بين مراقبة واجهة برمجة التطبيقات وتحليلات واجهة برمجة التطبيقات هو آلية التنبيه المصمَّمة في مراقبة واجهة برمجة التطبيقات. مع التنبيهات، يمكنك تحديد رمز حالة HTTP (2xx/4xx/5xx) أو وقت الاستجابة أو رمز خطأ. الذي يؤدي إلى إرسال تنبيه إلى فريق العمليات عند تجاوزه. يمكن لإشعارات التنبيهات يتم إرسالها من خلال مجموعة متنوعة من القنوات، مثل البريد الإلكتروني أو Slack أو أجهزة النداء أو الردود التلقائية على الويب، ما يتيح لك الرد المشكلات على الفور.

الاطّلاع على مقالة مقارنة مراقبة واجهة برمجة التطبيقات مع "إحصاءات واجهة برمجة التطبيقات Edge" لإجراء مقارنة أكثر تفصيلاً بين هذه الخدمات

مزيد من المعلومات