الحصول على تحليلات واجهة برمجة التطبيقات في إدارة واجهة برمجة تطبيقات Azure

ينطبق على: المطور | أساسي | الإصدار 2 الأساسي | قياسي | الإصدار 2 القياسي | بريميوم

توفر Azure API Management تحليلات لواجهات برمجة التطبيقات الخاصة بك بحيث يمكنك تحليل استخدامها وأدائها. استخدم التحليلات لمراقبة واجهات برمجة التطبيقات واستكشاف الأخطاء فيها وإصلاحها على مستوى عالٍ. للحصول على ميزات مراقبة أخرى، بما في ذلك المقاييس القريبة من الوقت الحقيقي وسجلات الموارد للتشخيص والتدقيق، راجع البرنامج التعليمي: مراقبة واجهات برمجة التطبيقات المنشورة.

لقطة شاشة لتحليلات واجهة برمجة التطبيقات في المدخل.

حول تحليلات واجهة برمجة التطبيقات

  • توفر إدارة واجهة برمجة التطبيقات تحليلات باستخدام لوحة معلومات تستند إلى Azure Monitor. تجمع لوحة المعلومات البيانات في مساحة عمل Azure Log Analytics.

  • في مستويات خدمة APIM الكلاسيكية، يتضمن مثيل API Management أيضا تحليلات مضمنة قديمة في مدخل Microsoft Azure، ويمكن الوصول إلى بيانات التحليلات باستخدام واجهة برمجة تطبيقات REST لإدارة API. يتم عرض البيانات المكافئة في لوحة المعلومات المستندة إلى Azure Monitor والتحليلات المضمنة.

هام

  • لوحة المعلومات المستندة إلى Azure Monitor هي الطريقة الموصى بها للوصول إلى بيانات التحليلات.
  • لا تتوفر التحليلات المضمنة القديمة في مستويات الإصدار 2.

باستخدام تحليلات واجهة برمجة التطبيقات، قم بتحليل استخدام وأداء واجهات برمجة التطبيقات في مثيل APIM عبر عدة أبعاد، بما في ذلك:

  • الوقت
  • الموقع الجغرافي
  • واجهات برمجة التطبيقات (API)
  • عمليات API
  • المنتجات
  • الاشتراكات
  • المستخدمون
  • الطلبات

إشعار

  • توفر تحليلات واجهة برمجة التطبيقات بيانات حول الطلبات، بما في ذلك الطلبات الفاشلة وغير المصرح بها.
  • تُعد القيم الجغرافية تقريبية استنادًا إلى تعيين عنوان IP.
  • قد يكون هناك تأخير لمدة 15 دقيقة أو أكثر في توفر بيانات التحليلات.

لوحة المعلومات المستندة إلى Azure Monitor

لاستخدام لوحة المعلومات المستندة إلى Azure Monitor، تحتاج إلى تكوين مساحة عمل Log Analytics كمصدر بيانات لسجلات بوابة APIM.

إذا كنت بحاجة إلى تكوين واحد، فيما يلي خطوات موجزة لإرسال سجلات البوابة إلى مساحة عمل Log Analytics. لمزيد من المعلومات، راجع البرنامج التعليمي: مراقبة واجهات برمجة التطبيقات المنشورة. هذا إعداد لمرة واحدة.

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
  2. في القائمة اليسرى، ضمن Monitoring، حدد Diagnostic settings>+ Add diagnostic setting.
  3. أدخل اسما وصفيا لإعداد التشخيص.
  4. في Logs، حدد Logs المتعلقة ب ApiManagement Gateway.
  5. في Destination details، حدد Send to Log Analytics وحدد مساحة عمل Log Analytics في نفس الاشتراك أو اشتراك مختلف. إذا كنت بحاجة إلى إنشاء مساحة عمل، فشاهد إنشاء مساحة عمل Log Analytics.
  6. اقبل الإعدادات الافتراضية للإعدادات الأخرى، أو قم بتخصيصها حسب الحاجة. حدد حفظ.

الوصول إلى لوحة المعلومات

بعد تكوين مساحة عمل Log Analytics، قم بالوصول إلى لوحة المعلومات المستندة إلى Azure Monitor لتحليل استخدام واجهات برمجة التطبيقات وأدائها.

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
  2. في القائمة اليسرى، ضمن Monitoring، حدد Insights. تفتح لوحة معلومات التحليلات.
  3. حدد نطاقا زمنيا للبيانات.
  4. حدد فئة تقرير لبيانات التحليلات، مثل المخطط الزمني، والجغرافيا، وما إلى ذلك.

التحليلات المضمنة القديمة

في مستويات خدمة APIM معينة، تتوفر التحليلات المضمنة أيضا في مدخل Microsoft Azure، ويمكن الوصول إلى بيانات التحليلات باستخدام API Management REST API.

التحليلات المضمنة - المدخل

للوصول إلى التحليلات المضمنة في مدخل Microsoft Azure:

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
  2. في القائمة اليسرى، ضمن Monitoring، حدد Analytics.
  3. حدد نطاقًا زمنيًا للبيانات، أو أدخل نطاقًا زمنيًا مخصصًا.
  4. حدد فئة تقرير لبيانات التحليلات، مثل المخطط الزمني، والجغرافيا، وما إلى ذلك.
  5. اختياريًا، قم بتصفية التقرير حسب فئة إضافية أو أكثر.

التحليلات - واجهة برمجة تطبيقات REST

استخدم Reports في واجهة برمجة تطبيقات REST في إدارة واجهة برمجة التطبيقات لاسترداد بيانات التحليلات وتصفيتها لمثيل إدارة واجهة برمجة التطبيقات لديك.

تُرجع العمليات المتوفرة سجلات التقرير حسب واجهة برمجة التطبيقات، أو الجغرافيا، أو عمليات واجهة برمجة التطبيقات، أو المنتج، أو الطلب، أو الاشتراك، أو الوقت، أو المستخدم.