يمكن تمكين تتبع التطبيق بأكمله في ملف Web.config الموجود في الدليل الجذر للتطبيق. افتراضيًا، لا يمكن عرض التتبعات على مستوى التطبيق إلا على كمبيوتر خادم الويب المحلي. يجب عليك
تعيين localOnly إلى false في ملف Web.config بحيث تكون معلومات التتبع على مستوى التطبيق مرئية من الكمبيوتر البعيد.
لتعطيل التتبع عن بعد، قم بتعيين الخاصية localOnly إلى true في ملف Web.config. يوضح المثال التالي تكوين تتبع التطبيق الذي يجمع
معلومات التتبع لما يصل إلى 40 طلبًا ويسمح للمتصفحات الموجودة على أجهزة أخرى غير الخادم الأصلي بعرض عارض التتبع.
<التكوين>
<system.web>
<trace Enabled="true" requestLimit="40" localOnly="false"/>
</system.web>
</التكوين>
عند تمكين التتبع لأحد التطبيقات، يقوم ASP.NET بتجميع معلومات التتبع لكل طلب إلى التطبيق حتى يتم الوصول إلى الحد الأقصى لعدد الطلبات التي تحددها. العدد الافتراضي للطلبات هو 10. عندما يصل عارض التتبع
إلى حد الطلب الخاص به، يتوقف التطبيق عن تخزين طلبات التتبع.
ملاحظة عند تمكين التتبع لتطبيق بأكمله في ملف Web.config، يتم جمع معلومات التتبع ومعالجتها لكل صفحة في التطبيق. لتعطيل التتبع لصفحة معينة في تطبيقك،
قم بتعيين خاصية التتبع على false في توجيه @Page الخاص بالصفحة. يتم تخزين أية عبارات TraceContext.Write أو TraceContext.Warn التي تقوم بتضمينها في رمز الصفحة
ويتم
إرجاعها فقط إلى Trace Viewer.
إذا كنت تريد إلحاق معلومات التتبع بنهاية الصفحة المقترنة بها، فقم بتعيين خاصية pageOutput إلى true في قسم تكوين التتبع في ملف Web.config. إذا كنت تريد عرض معلومات التتبع في
عارض التتبع فقط، فقم بتعيين هذه الخاصية إلى false. إذا قمت بتمكين التتبع على مستوى التطبيق ولكنك لا تريد عرض معلومات التتبع لصفحات معينة من التطبيق الخاص بك، فاستخدم التوجيه @Page لتعيين
خاصية التتبع إلى false للصفحات التي لا تريد عرض معلومات التتبع لها.
فيما يلي كافة الخصائص التي يمكن استخدامها لتعديل سلوك التتبع على مستوى التطبيق.
وصف العقار
مُمكّن صحيحًا إذا تم تمكين التتبع على مستوى التطبيق، وإلا؛ القيمة الافتراضية خاطئة.
pageOutput صحيح إذا تم عرض معلومات التتبع على كل من صفحة التطبيق والأداة المساعدة للتتبع .axd؛ القيمة الافتراضية خاطئة.
ملاحظة: لا تتأثر الصفحات التي تم تمكين التتبع بها بهذا الإعداد.
requestLimit عدد طلبات التتبع المخزنة على الخادم. القيمة الافتراضية هي 10.
يشير TraceMode إلى ما إذا كانت معلومات التتبع يتم عرضها بالترتيب الذي تمت معالجتها به (SortByTime) أو بالترتيب الأبجدي حسب الفئات المعرفة من قبل المستخدم (SortByCategory). القيمة الافتراضية هي
SortByTime.
localOnly صحيح إذا كان عارض التتبع (Trace.axd) متاحًا فقط على خادم الويب المضيف؛ وإلا فسيكون خطأ. القيمة الافتراضية صحيحة.
تمكين التتبع على مستوى التطبيق
إذا لم تكن قد قمت بذلك بالفعل، فقم بإنشاء ملف نصي، وقم بتسميته Web.config، واحفظه في الدليل الجذر للتطبيق الخاص بك.
بين علامتي الفتح والإغلاق لعنصر <configuration>، أضف علامتي الفتح والإغلاق لعنصر <system.web>.
بين علامات عنصر <system.web>، أضف عنصر <trace> (وهو ذاتي الإغلاق).
في عنصر <trace>، أعلن عن السمة الممكنة واضبطها على true.
قم بتعريف الخصائص الاختيارية الأخرى لتعديل سلوك التتبع الخاص بالتطبيق الخاص بك ليناسب احتياجاتك.
على سبيل المثال، يقوم تكوين تتبع التطبيق التالي بجمع معلومات التتبع لما يصل إلى 40 طلبًا ويسمح للمتصفحات الموجودة على أجهزة أخرى غير الخادم الأصلي بعرض عارض التتبع.
<التكوين>
<system.web>
<trace Enabled="true" requestLimit="40" localOnly="false"/>
</system.web>
</التكوين>
لاحظ أن نظام تكوين ASP.NET حساس لحالة الأحرف. تكون جميع أقسام التكوين المكونة من كلمة واحدة بأحرف صغيرة، بينما يجب أن تكون الأقسام أو السمات المتسلسلة المكونة من كلمتين بحالة الجمل. على سبيل المثال،
requestLimit هو اسم خاصية صالح، لكن requestlimit يؤدي إلى خطأ محلل.
عرض معلومات التتبع باستخدام Trace Viewer بمجرد تمكين التتبع على مستوى التطبيق، عند طلب كل صفحة في التطبيق، سيتم تنفيذ أي بيانات تتبع تحتوي عليها. يمكن عرض هذه البيانات ومعلومات التتبع الأخرى في عارض
التتبع
عن طريق طلب Trace.axd في الدليل الجذر للتطبيق .ملاحظة: عند تمكين التتبع على مستوى التطبيق، يمكنك عرض عبارات التتبع والمعلومات
الأخرى
في أي صفحة من التطبيق عن طريق تعيين خاصية pageOutput إلى true في ملف Web.config .
يتيح لك عارض التتبع تحديد طلبات محددة من بين الصفحات التي تم طلبها من التطبيق. تُظهر لقطة الشاشة أدناه عارض التتبع الذي يحتوي على 7 طلبات
لتطبيقه
بعد تمكين التتبع .عارض التتبع
في حالة وصول طلبات متعددة لتطبيق ممكّن للتتبع، يقوم عارض التتبع بإدراجها بالترتيب الذي تمت معالجته به. تتضمن المعلومات الموجودة في صفحة بدء عارض التتبع: وقت الطلب،
والملف المطلوب، ورمز حالة الطلب، وفعل HTTP المرتبط بالطلب، ورابط عرض التفاصيل الذي يسمح لك بعرض معلومات أكثر تفصيلاً حول الطلب. لن يتجاوز عدد الطلبات المعروضة
إعداد requestLimit الذي تحدده في ملف Web.config.
لعرض تفاصيل التتبع لطلب معين،
انتقل إلى عارض التتبع المرتبط بالتطبيق الخاص بك.
على سبيل المثال، إذا كان عنوان URL لتطبيقك هو http://localhost/myapplication ، فانتقل إلى http://localhost/myapplication/trace.axd لعرض إحصائيات
تتبع
التطبيق .حدد رابط عرض التفاصيل للطلب الذي تريد البحث فيه.
عند تحديد عرض التفاصيل، سترى نفس المعلومات ملحقة بصفحة ممكّنة للتتبع.
في بعض الحالات، قد ترغب في إزالة كافة الطلبات المخزنة في عارض التتبع. ربما تريد تتبع التغييرات التي تم إجراؤها على الملفات في تطبيقك، أو ربما تريد فقط رؤية
معلومات حول ملف آخر غير الملف المرتبط بالطلب المعروض حاليًا.
يستهدفطلب Clear from Trace Viewer
عارض التتبع المرتبط بالتطبيق.
حدد رابط Clear Current Trace لإزالة كافة الطلبات المخزنة في تطبيق Trace Viewer.
ملاحظة يقوم عارض التتبع بتتبع الطلبات التي تم إجراؤها بعد مسح السجل فقط. لا يمكن عرض الطلبات المقدمة بعد الوصول إلى حد الطلب وقبل مسح السجل.