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

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

يقدّم هذا الموضوع لمحة عن Edge API Analytics.

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

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

تجمع إحصاءات واجهة برمجة التطبيقات 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" لإجراء مقارنة أكثر تفصيلاً بين هذه الخدمات

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