مشاركة عبر

Trace

  • مقالة

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

يضيف النهج trace تتبعا مخصصا إلى إخراج تتبع الطلب في وحدة تحكم الاختبار وبيانات تتبع استخدام Application Insights و/أو سجلات الموارد.

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

هام

  • لم يعد من الممكن تمكين تتبع طلب إدارة واجهة برمجة التطبيقات عن طريق تعيين عنوان Ocp-Apim-Trace في طلب واستخدام قيمة عنوان Ocp-Apim-Trace-Location في الاستجابة لاسترداد التتبع.
  • لتحسين الأمان، يتم الآن تمكين التتبع على مستوى واجهة برمجة تطبيقات فردية عن طريق الحصول على رمز مميز محدود زمنيا باستخدام API Management REST API، وتمرير الرمز المميز في طلب إلى البوابة. للحصول على التفاصيل، راجع لاحقا في هذا البرنامج التعليمي.
  • احرص عند تمكين التتبع، لأنه يمكن أن يعرض معلومات حساسة في بيانات التتبع. تأكد من وجود تدابير أمان مناسبة لحماية بيانات التتبع.

إشعار

حاليا، تتبع طلبات واجهة برمجة التطبيقات غير مدعوم في مستويات الإصدار 2 الأساسي والقياسي v2.

إشعار

تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.

نهج السياسة

<trace source="arbitrary string literal" severity="verbose | information | error">
    <message>String literal or expressions</message>
    <metadata name="string literal or expressions" value="string literal or expressions"/>
</trace>

سمات

السمة ‏‏الوصف مطلوبة افتراضي
المصدر سلسلة حرفية ذات معنى إلى عارض التتبع وتحديد مصدر الرسالة. تعبيرات النهج غير مسموح بها. ‏‏نعم‬ غير متوفر
severity تحديد مستوى خطورة التتبع. القيم المسموح بها هي verbose، وinformation، وerror ( من الأدنى إلى الأعلى). تعبيرات النهج غير مسموح بها. لا verbose

عناصر

Name ‏‏الوصف مطلوب
رسالة سلسلة أو تعبير يتم تسجيله. يتم السماح بتعبيرات النهج. ‏‏نعم‬
بيانات التعريف إضافة خاصية مخصصة إلى بيانات تتبع استخدام التتبع لـ Application Insights. لا

سمات بيانات التعريف

السمة ‏‏الوصف مطلوبة افتراضي
الاسم اسم الخاصية. ‏‏نعم‬ غير متوفر
قيمة قيمة الخاصية. ‏‏نعم‬ غير متوفر

الاستخدام

  • أقسام النهج: الواردة والصادرة والخلفية
  • نطاقات النهج: العمومية، ومساحة العمل، والمنتج، وواجهة برمجة التطبيقات، والتشغيل
  • البوابات: الكلاسيكية، الإصدار 2، الاستهلاك، المستضافة ذاتيا

مثال

<trace source="PetStore API" severity="verbose">
    <message>@((string)context.Variables["clientConnectionID"])</message>
    <metadata name="Operation Name" value="New-Order"/>
</trace>

المحتوى ذو الصلة

لمزيد من المعلومات حول العمل مع النُهج، راجع: