مشاركة عبر

مرجع إعدادات سجلات التشخيص: APIM

  • مقالة

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

يصف هذا المرجع إعدادات تسجيل تشخيص واجهة برمجة التطبيقات من مثيل APIM. لتمكين تسجيل طلبات واجهة برمجة التطبيقات، راجع الإرشادات التالية:

إشعار

تنطبق بعض الإعدادات، حيثما لوحظ، فقط على تسجيل الدخول إلى Application Insights.

الإعدادات النوع ‏‏الوصف
تمكين boolean تحديد ما إذا كان تسجيل API ممكناً أم لا.

يمكن تمكين التسجيل لجميع واجهات برمجة التطبيقات أو لواجهة برمجة تطبيقات فردية. إعدادات لواجهة برمجة تطبيقات فردية تتجاوز الإعدادات لجميع واجهات برمجة التطبيقات، إذا تم تمكينها.
الوجهة مسجّل Azure Application Insights تحديد المسجل الذي سيتم استخدامه لتسجيل Application Insights.
أخذ عينات (%) عشري القيم من 0 إلى 100 (في المائة).
تحديد النسبة المئوية للطلبات التي تم تسجيلها. يعني أخذ العينات بنسبة 0٪ عدم تسجيل الطلبات، بينما يعني أخذ العينات بنسبة 100٪ تسجيل جميع الطلبات. الافتراضي: 100

للحصول على تأثيرات الأداء لتسجيل Application Insights، راجع الآثار المترتبة على الأداء وأخذ عينات السجل.
تسجيل الأخطاء دوماً boolean إذا تم تمكين هذا الإعداد، يتم تسجيل جميع حالات الفشل، بغض النظر عن إعداد أخذ العينات .
تسجيل عنوان IP للعميل boolean إذا تم تمكين هذا الإعداد، يتم تسجيل عنوان IP للعميل لطلبات واجهة برمجة التطبيقات.
الإسهاب يحدد إسهاب السجلات وما إذا تم تسجيل التتبعات المخصصة التي تم تكوينها في نهج التتبع .

* خطأ - الطلبات الفاشلة، وتتبعات مخصصة للخطورة error
* المعلومات - الطلبات الفاشلة والناجحة، وتتبعات مخصصة للخطورة error و information
* مطول - الطلبات الفاشلة والناجحة، وتتبعات مخصصة للخطورة errorو informationو verbose

الافتراضي: معلومات
بروتوكول الارتباط يحدد البروتوكول المستخدم لربط بيانات تتبع الاستخدام المرسلة بواسطة مكونات متعددة إلى Application Insights. الافتراضي: قديم

للحصول على معلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
الرؤوس المراد تسجيلها قائمة تحديد العناوين التي تم تسجيلها للطلبات والاستجابات. افتراضي: لا يتم تسجيل أي عناوين.
عدد وحدات بايت الحمولة (النص الأساسي) المراد تسجيلها integer يحدد عدد وحدات البايت الأولية لطلب الواجهة الأمامية أو الخلفية أو نص الاستجابة الذي تم تسجيله. الحد الأقصى: 8192. الافتراضي: 0
طلب الواجهة الأمامية تحديد ما إذا كانت طلبات الواجهة الأمامية (الطلبات الواردة إلى بوابة APIM) وكيفية تسجيلها.

إذا تم تمكين هذا الإعداد، فحدد الرؤوس التي تريد تسجيلها أو عدد وحدات بايت الحمولة المراد تسجيلها أو كليهما.
استجابة الواجهة الأمامية تحديد ما إذا كانت استجابات الواجهة الأمامية (الاستجابات الصادرة من بوابة APIM) وكيفية تسجيلها.

إذا تم تمكين هذا الإعداد، فحدد الرؤوس التي تريد تسجيلها أو عدد وحدات بايت الحمولة المراد تسجيلها أو كليهما.
طلب الواجهة الخلفية يحدد ما إذا كان يتم تسجيل طلبات الواجهة الخلفية (الطلبات الصادرة من بوابة إدارة واجهة برمجة التطبيقات) وكيفية تسجيلها.

إذا تم تمكين هذا الإعداد، فحدد الرؤوس التي تريد تسجيلها أو عدد وحدات بايت الحمولة المراد تسجيلها أو كليهما.
استجابة الواجهة الخلفية تحديد ما إذا كانت الاستجابات الخلفية (الاستجابات الواردة إلى بوابة APIM) قد تم تسجيلها وكيفية تسجيلها.

إذا تم تمكين هذا الإعداد، فحدد الرؤوس التي تريد تسجيلها أو عدد وحدات بايت الحمولة المراد تسجيلها أو كليهما.

هام

إذا تم التمكين، يمكن أن تصل حمولات الطلب أو الاستجابة المسجلة إلى 8192 بايت. تفرض APIM أيضا حد 32 كيلوبايت لإدخال سجل تشخيصي تم إرساله إلى Azure Monitor، والذي يتضمن الحمولات والسمات الأخرى مثل رموز الحالة والرؤوس والطوابع الزمنية. إذا تجاوز الحجم المدمج للسمات 32 كيلوبايت، فإن API Management تقليم الإدخال عن طريق إزالة كافة النص الأساسي ومحتوى التتبع.

الخطوات التالية

  • لمزيد من المعلومات، راجع مرجع كيان التشخيص في API Management REST API.
  • استخدم نهج التتبع لإضافة تتبعات مخصصة إلى بيانات تتبع استخدام Application Insights أو سجلات الموارد أو تتبع الطلب.