كيفية القيام بما يلي: Instrument a .NET Service and Collect Detailed Timing Data by Using the Profiler Command Line

يصف هذا pic إلى كيف إلى استخدام Visual Studio Premiumإنشاء تشكيل جانبي سطر الأوامر إلى ols إلى ols إلى آلة .NET Frameworkالخدمة وجمع بيانات المفصلة التوقيت.

ملاحظة

لا يمكنك تعريف خدمة مع الأسلوب آلات إذا كان لا يمكن إعادة تشغيل الخدمة بعد بدء تشغيل جهاز الكمبيوتر، مثل خدمة تبدأ فقط عند بدء تشغيل النظام التشغيل.

أدوات سطر الأوامر "أدوات ملفات التعريف" الموجودة في الدليل فرعي لأدوات\فريق Tools\الأداء Visual Studioالدليل التثبيت. تشغيل أجهزة كمبيوتر 64 بت، كل من 64 بت و تتوفر إصدارات 32 بت من الأدوات. إلى استخدم أدوات سطر الأوامر محلل ملفات التعريف، يجب عليك إضافة مسار الأدوات إلى متغير بيئة PATH من نافذة تعجيل الأوامر أو إضافته إلى الأمر نفسه. لمزيد من المعلومات، راجع تحديد مسار لإنشاء ملفات تعريف أدوات سطر الأوامر أدوات.

لتجميع بيانات مُفصل التوقيت من .NET Frameworkخدمة باستخدام أسلوب آلات، استخدم الأداة VSInstr.exe من لتوليد الآلية الإصدار مكوّن. ثم استبدال الإصدار الخدمة غير instrumented مع الإصدار الآلية، مع التأكد من أن الخدمة تم تكوينه يبدأ يدوياً. استخدام الأداة VSPerfCLREnv.cmd لتهيئة متغيرات بيئة profiling العمومي، ثم إعادة يبدأ الكمبيوتر مضيف. يمكنك ثم يبدأ محلل ملفات التعريف.

عند الخدمة هو بدء توقيت البيانات هو التي تم تجميعها تلقائياً إلى ملف بيانات. يمكنك إيقاف مؤقتاً و سيرة ذاتية جمع بيانات أثناء جلسة عمل profiling.

إلى إنهاء جلسة عمل profiling، يمكنك يوقف التشغيل الخدمة وثم صراحة إيقاف محلل ملفات التعريف. في معظم الحالات، نوصي بمسح متغيرات بيئة profiling في إنهاء جلسة عمل.

بدء تشغيل تطبيق مع محلل ملفات التعريف

إلى يبدأ إنشاء تشكيل جانبي لخدمة.NET Framework

1. افتح نافذة موجه الأوامر.

2. استخدام VSInstrأداة لإنشاء الآلية الإصدار من الملف الثنائي الخدمة.

3. قم باستبدال الملف الثنائي الأصلي بالإصدار الآلية. في Windows إدارة التحكم بالخدمة، تأكد أن الخدمة بدء التشغيل اكتب هو تعيينها إلى يدوي.

4. يهيّئ .NET Frameworkإنشاء ملفات تعريف متغيرات بيئة. اكتب:

   VSPerfClrEnv /globaltraceon

5. أعد تشغيل الكمبيوتر.

6. افتح نافذة موجه الأوامر.

7. يبدأ محلل ملفات التعريف. اكتب:

   **VSPerfCmd /start:trace /output:**OutputFile[Options]

   • /يبدأ:trace خيار تهيئة محلل ملفات التعريف.

   • خيار /إخراج**:**OutputFileهو المطلوبة مع /start. OutputFileتعيين اسم وموقع بيانات profiling (.vsp) ملف.

   يمكنك استخدام أي من الخيارات التالية مع /start:traceخيار.

   ملاحظة

   /userو /crosssessionخيارات مطلوبة عادة لخدمات profiling.

   الخيار	الوصف
   /user:[Domain\]UserName	تعيين اسم مستخدم والمجال للحساب الذي يملك profiled في عملية. Th هو خيار هو إلا إذا طلب العملية هو التي تعمل كمستخدم غير مستخدم قام بتسجيل الدخول. مالك العملية مسرود في العمود "اسم مستخدم" في تبويب معالجات من Windows مدير المهام.
   /crosssession	تمكين التشكيل الجانبي للعمليات في جلسات عمل غير ذلك. Th هو خيار هو مطلوباً إذا كان تطبيق هو تشغيل في جلسة عمل أخرى. المعرف جلسة عمل هو lهوted في عمود "المعرف جلسة عمل" على تبويب معالجات إدارة مهام Windows. /CSيمكن أن يتم تعيين كـ اختصار ل/crosssession.
   /waitstart[:Interval]	تعين عدد الثواني إلى انتظر محلل ملفات التعريف إلى تهيئة قبل أن تقوم بإرجاع خطأ. إذا Intervalهو لم يكن محدداً، محلل ملفات التعريف ينتظرها أجل غير مسمى. بواسطة افتراضي، /startإرجاع مباشرة.
   /globaloff	إلى يبدأ محلل ملفات التعريف بتجميع بيانات بشكل مؤقت، قم بإضافة /globaloffخيار إلى /startسطر الأوامر. استخدام /globalonإلى استئناف إنشاء تشكيل جانبي.
   &‎/counter&‎:Config	جمع معلومات من أداء المعالج العداد المحدد في التكوين. معلومات العداد هو تمت الإضافة إلى بيانات المجمعة في كل حدث profiling.
   /wincounter:WinCounterPath	قم بتعيين العداد أداء Windows إلى يتم تجميعها أثناء إنشاء تشكيل جانبي.
   /automark:Interval	استخدم مع /wincounterفقط. تعين عدد المللي ثانية بين أحداث مجموعة عدادات أداء Windows. الافتراضي هو 500 مللي ثانية.
   /أحداث:Config	تحديد حدث أحداث تتبع ل Windows (ETW) إلى أن يتم تجميعها أثناء إنشاء تشكيل جانبي. يتم تجميع الأحداث ETW في ملف منفصل (.etl).

8. يبدأ الخدمة من Windows مدير التحكم بالخدمة.

التحكم في بيانات مجموعة

عند الخدمة هو تشغيل، يمكنك استخدام VSPerfCmd.exeخيارات لتشغيل وإيقاف تشغيلها في كتابة البيانات إلى ملف بيانات محلل ملفات التعريف. يتيح لك التحكم في تجميع بيانات إلى جمع بيانات لجزء محدد من تنفيذ برنامج، مثل البدء أو إيقاف تشغيل الخدمة.

إلى يبدأ ثم قم بإيقاف تجميع بيانات

• أزواج التالية VSPerfCmdخيارات يبدأ وإيقاف تجميع بيانات. قم بتحديد كل خيار تشغيل منفصل الأمر خط. يمكن تشغيل مجموعة بيانات و إيقاف تشغيل عدة مرة/مرات.

  الخيار	الوصف
  /globalon/globaloff	بدء تشغيل ( /globalon) أو توقف ( /globaloff) بيانات مجموعة لكافة معالجات.
  /processon:PID /processoff:PID	بدء تشغيل ( /processon) أو توقف ( /processoff) جمع بيانات عملية المحدد بواسطة المعرف عملية ( PID).
  /threadon:TID /threadoff:TID	بدء تشغيل ( /threadon) أو توقف ( /threadoff) جمع بيانات لمؤشر الترابط المحدد بواسطة "المعرف مؤشر ترابط" ( TID).

• You can also use the VSPerfCmd.exe /mark option to insert a profiling mark into the data file. /markcomm و تضيف معرفاً طابع زمني، و على سلسلة نص اختياري لمعرفة من قبل مستخدم. يمكن استخدام علامات إلى تصفية بيانات في طرق عرض بيانات والتقارير محلل ملفات التعريف.

الإنهاء جلسة عمل Profiling

To end a profiling session, stop the service that is running the instrumented component, and then call the VSPerfCmd /shutdown option to turn the profiler off and close the profiling data file. VSPerfClrEnv /globaloffالأمر مسح بيئة profiling متغيرات.

يجب إعادة التشغيل لإعدادات بيئة جديدة إلى ليتم تطبيقها.

لإنهاء جلسة عمل profiling

1. قم بإيقاف خدمة إدارة التحكم بمن الخدمة.

2. قم بإيقاف تشغيل محلل ملفات التعريف. اكتب:

   VSPerfCmd /shutdown

3. عند مكتمل الجميع ملفات التعريف، مسح متغيرات بيئة profiling. اكتب:

   VSPerfClrEnv /globaloff

4. قم باستبدال وحدة نمطية الآلية مع الأصلي. إذا لزم الأمر، قم بإعادة تكوين "نوع بدء التشغيل" للخدمة.

5. أعد تشغيل الكمبيوتر.

راجع أيضًا:

المبادئ

Command-Line Profiling of Services

موارد أخرى

بيانات أسلوب الأدوات محلل ملفات التعريف طرق العرض