مشاركة عبر

تتبع تدفق تطبيق الخدمات السحابية (الكلاسيكي) باستخدام Azure Diagnostics

  • مقالة

هام

تم الآن إهمال Cloud Services (كلاسيكي) للعملاء الجدد وسيتم استبعادها في 31 أغسطس 2024 لجميع العملاء. ينبغي أن تستخدم عمليات النشر الجديدة نموذج النشر الجديد القائم على Azure Resource Manager ‏‏Azure Cloud Services (الدعم الموسع) .

التتبع هو طريقة لمراقبة تنفيذ تطبيقك أثناء تشغيله. يمكنك استخدام الفئات System.Diagnostics.Trace وSystem.Diagnostics.Debug وSystem.Diagnostics.TraceSource لتسجيل معلومات حول الأخطاء وتنفيذ التطبيق في السجلات أو الملفات النصية أو الأجهزة الأخرى للتحليل لاحقًا. لمزيد من المعلومات حول التتبع، راجع تتبع وتجهيز التطبيقات.

استخدام عبارات التتبع ومفاتيح تبديل التتبع

نفذ التتبع في تطبيق الخدمات السحابية الخاص بك عن طريق إضافة DiagnosticMonitorTraceListener إلى تكوين التطبيق وإجراء استدعاءات إلى System.Diagnostics.Trace أو System.Diagnostics.Debug في التعليمات البرمجية لتطبيقك. استخدم ملف التكوين app.config لأدوار العاملين وweb.config لأدوار الويب. عند إنشاء خدمة مُستضافة جديدة باستخدام قالب Visual Studio، يُضاف Azure Diagnostics تلقائيًا إلى المشروع ويُضاف DiagnosticMonitorTraceListener إلى ملف التكوين المناسب للأدوار التي تضيفها.

للحصول على معلومات حول وضع عبارات التتبع راجع كيفية: إضافة عبارات التتبع إلى التعليمة البرمجية للتطبيق.

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

تكوين مستمع التتبع في تطبيق Azure

يتطلب التتبع والتصحيح وTraceSource، إعداد "مستمعين" لجمع وتسجيل الرسائل المُرسلة. يُنفذ المستمعون جمع رسائل التتبع وتخزينها وتوجيهها. ينفذون توجيه إخراج التتبع إلى هدف مناسب، مثل سجل أو نافذة أو ملف نصي. يستخدم Azure Diagnostics الفئة DiagnosticMonitorTraceListener.

قبل إكمال الإجراء التالي، يجب تكوين مراقبة Azure Diagnostics. للقيام بذلك، راجع تمكين Diagnostics في Microsoft Azure.

لاحظ أنه إذا كنت تستخدم القوالب الموفرة من قِبل Visual Studio، فسيُضاف تكوين المستمع تلقائيًا.

إضافة مستمع التتبع

  1. افتح ملف web.config أو app.config لدورك.

  2. أضف التعليمات البرمجية التالية إلى الملف. غيِّر سمة الإصدار لاستخدام رقم إصدار التجميع المستخدم كمرجع. لا يتغير إصدار التجميع بالضرورة مع كل إصدار من إصدارات Azure SDK ما لم تكن هناك تحديثات له.

    <system.diagnostics>
    <trace>
        <listeners>
            <add type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener,
              Microsoft.WindowsAzure.Diagnostics,
              Version=2.8.0.0,
              Culture=neutral,
              PublicKeyToken=31bf3856ad364e35"
              name="AzureDiagnostics">
                <filter type="" />
            </add>
        </listeners>
    </trace>
</system.diagnostics>

    هام

    تأكد من وجود مرجع مشروع إلى التجميع Microsoft.WindowsAzure.Diagnostics. حدّث رقم الإصدار في xml أعلاه لمطابقة إصدار التجميع Microsoft.WindowsAzure.Diagnostics المرجعي.

  3. احفظ ملف التكوين.

لمزيد من المعلومات حول المستمعين، راجع تتبع المستمعين.

بعد إكمال الخطوات لإضافة مستمع، يمكنك إضافة عبارات التتبع إلى التعليمات البرمجية الخاصة بك.

لإضافة عبارة تتبع إلى التعليمات البرمجية

  1. افتح الملف المصدر لتطبيقك. على سبيل المثال، ملف <RoleName>.cs لدور العامل أو دور الويب.
  2. أضف التالي باستخدام التوجيه إذا لم يكن قد أُضيف بالفعل:
        using System.Diagnostics;
  3. أضف عبارات التتبع حيث تريد تسجيل معلومات حول حالة تطبيقك. يمكنك استخدام مجموعة متنوعة من الأساليب لتنسيق إخراج عبارة التتبع. لمزيد من المعلومات، راجع كيفية: إضافة عبارات التتبع إلى التعليمات البرمجية للتطبيق.
  4. احفظ الملف المصدر.