Jak: nástroj.Služba NET a shromažďovat podrobné časových dat pomocí nástroje příkazového řádku
Toto téma popisuje použití nástrojů příkazového řádku balíku Visual Studio Premium Profiling Tools k instrumentaci služby .NET Framework a sběru detailních dat o časování.
[!POZNÁMKA]
Metodou instrumentace nelze profilovat službu, není-li možné ji po spuštění počítače restartovat (například služba spouštěna pouze spolu s operačním systémem).
Nástroje příkazového řádku balíku Profiling Tools jsou umístěny v podadresáři \Team Tools\Performance Tools instalačního adresáře aplikace Visual Studio.Na 64bitových počítačích jsou k dispozici 64bitové i 32bitové verze nástrojů.Chcete-li využívat nástroje příkazového řádku profileru, je nezbytné přidat cestu k nástrojům do proměnné prostředí PATH v okně příkazového řádku nebo do příkazu samého.Další informace naleznete v tématu Zadání cesty k profilování nástroje příkazového řádku nástroje.
Přidání dat interakce vrstvy profilování spuštění vyžaduje zvláštní postupy s příkazovým řádkem, profilování nástroje.Viz téma Přidání dat interakce vrstev z příkazového řádku.
Pro shromáždění podrobných časových údajů ze služby .NET Framework, pomocí metody instrumentace, je používán nástroj VSInstr.exe, který generuje instrumentovanou verzi komponenty.Jakmile je neinstrumentovaná verze služby nahrazena instrumentovanou verzí, je nutné se ujistit, že je služba nastavena na manuální spuštění.Nástroj VSPerfCLREnv.cmd se používá pro inicializování globálních proměnných profilování a poté restartujte hostitelský počítač. Poté je spuštěn profiler.
Jakmile je služba spuštěna, data o časování jsou automaticky shromažďována do datového souboru.Během relace profilování lze sběr dat pozastavovat a obnovovat.
Chcete-li relaci profilování ukončit, ukončete službu a explicitně vypněte profiler.Ve většině případů doporučujeme na konci relace vyčistit proměnné prostředí profilování.
Spuštění aplikace profilerem
Spuštění profilování služby .NET Framework
Otevřete okno příkazového řádku.
Vygenerujte instrumentovanou verzi binárního souboru služby pomocí nástroje VSInstr.
Nahraďte původní binární soubor instrumentovanou verzí.Ve Správci nastavení služeb systému Windows se ujistěte, že Typ spuštění služby je nastaven na Ručně.
Inicializujte proměnné prostředí pro profilování .NET Framework.Zadejte:
VSPerfClrEnv /globaltraceon
Restartujte počítač.
Otevřete okno příkazového řádku.
Spusťte profiler.Zadejte:
**VSPerfCmd /start:trace /output:**OutputFile[Options]
Možnost /start:trace inicializuje profiler.
Spolu s možností /start je vyžadována možnost /output**:**OutputFile.Parametr OutputFile určuje název a umístění souboru dat profilování (.vsp).
S možností /start:trace lze použít kteroukoli z následujících možností.
[!POZNÁMKA]
Pro profilovací služby jsou obvykle vyžadovány možnosti /user a /crosssession.
Možnost
Description
/user:[Domain\]UserName
Určuje doménu a uživatelské jméno účtu vlastnícího profilovaný proces.Tato možnost je vyžadována pouze pokud je proces spuštěn pod jiným než přihlášeným uživatelem.Vlastník procesu je vypsán ve sloupci Uživatelské jméno na záložce Procesy ve Správci úloh systému Windows.
Umožňuje profilování procesů v jiných relacích.Tato možnost je vyžadována, pokud je aplikace spuštěna v jiné relaci.ID relace je uvedeno ve sloupci ID relace na kartě Procesy ve Správci úloh systému Windows.Možnost /CS lze zadat jako zkratka pro možnost /crosssession.
/waitstart[:Interval]
Určuje počet sekund, po které se má čekat na inicializaci profileru, než je vrácena chyba.Není-li zadán parametr Interval, čeká profiler neomezeně dlouho.Ve výchozím nastavení možnost /start okamžitě dokončuje svou činnost.
Chcete-li spustit profiler s pozastaveným sběrem dat, přidejte do příkazového řádku /start možnost /globaloff.Obnovu profilování provedete možností /globalon.
/counter:Config
Shromažďuje informace z čítače výkonu procesoru zadaného v souboru Config.Informace o čítači jsou vloženy do dat shromážděných při každé události profilování.
/wincounter:WinCounterPath
Určuje čítač výkonu systému Windows, který má být shromážděn během profilování.
/automark:Interval
Používejte pouze spolu s možností /wincounter.Určuje počet milisekund mezi událostmi sběru čítače výkonu systému Windows.Výchozí hodnota je 500 ms.
/events:Config
Určuje událost ETW, která má být shromážděna během profilování.Události ETW jsou shromážděny v samostatném souboru (.etl).
Spusťte službu pomocí Správce nastavení služeb systému Windows.
Řízení sběru dat
Jakmile je služba spuštěna, je možné použít možnosti VSPerfCmd.exe, pro spuštění a zastavení zápisu dat do datového souboru profilování.Řízení sběru dat umožňuje shromažďovat data určité části programu, například spouštění či ukončování služby.
Spuštění a zastavení sběru dat
Následující páry možnosti nástroje VSPerfCmd spouští a zastavují sběr dat.Každou možnost zadejte na samostatný příkazový řádek.Sběr dat lze zapnout a vypnout několikrát.
Možnost
Description
Spustí (/globalon) nebo zastaví (/globaloff) sběr dat pro všechny procesy.
/processon:PID/processoff:PID
Spustí (/processon) nebo zastaví (/processoff) sběr dat pro proces určený pomocí ID procesu (PID).
/threadon:TID/threadoff:TID
Spustí (/threadon) nebo zastaví (/threadoff) sběr dat pro vlákno určené pomocí ID vlákna (TID).
Lze také použít možnost VSPerfCmd.exe/mark a vložit tak do datového souboru profilovací značku.Příkaz /mark přidá identifikátor, časové razítko a volitelný uživatelem definovaný textový řetězec.Značky lze použít k filtrování dat v sestavách a zobrazení dat profileru.
Ukončení relace profilování.
K ukončení relace profilování, zastavte službu, která je spuštěna součást instrumentovaného a poté zavolejte VSPerfCmd/shutdown možnost vypnout okna profilování a profilování datový soubor zavřete.Příkaz VSPerfClrEnv /globaloff vymaže proměnné prostředí profilování.
Pro aplikování nového nastavení prostředí je nutné restartovat počítač.
Ukončení relace profilování
Ukončete službu ve Správci řízení služeb.
Ukončete profiler.Zadejte:
VSPerfCmd /shutdown
Po dokončení veškerého profilování vyčistěte proměnné prostředí profilování.Zadejte:
VSPerfClrEnv /globaloff
Nahraďte instrumentovaný modul jeho původní verzí.V případě potřeby znovu nastavte Typ spouštění služby.
Restartujte počítač.
Viz také
Koncepty
Příkazového řádku vytváření profilů služby