Gewusst wie: Instrumentieren eines .NET-Diensts und Sammeln ausführlicher Zeitsteuerungsdaten über die Profiler-Befehlszeile
In diesem Thema wird beschrieben, wie Sie mit den Befehlszeilentools der Visual Studio Premium-Profilerstellungstools einen .NET Framework-Dienst instrumentieren und ausführliche Zeitsteuerungsdaten sammeln können.
Tipp
Mit der Instrumentationsmethode kann kein Profil für einen Dienst erstellt werden, wenn der Dienst nach dem Start des Computers nicht neu gestartet werden kann, z. B. ein Dienst, der nur gleichzeitig mit dem Betriebssystem gestartet wird.
Die Befehlszeilentools der Profilerstellungstools befinden sich im Unterverzeichnis "\Team Tools\Performance Tools" des Visual Studio-Installationsverzeichnisses. Auf 64-Bit-Computern sind 64-Bit- und 32-Bit-Versionen der Tools verfügbar. Um die Profiler-Befehlszeilentools zu verwenden, müssen Sie den Toolpfad der PATH-Umgebungsvariable des Eingabeaufforderungsfensters oder dem Befehl selbst hinzufügen. Weitere Informationen hierzu finden Sie unter Angeben des Pfads zu den Profilerstellungstools für die Befehlszeile.
Um ausführliche Zeitsteuerungsdaten mit der Instrumentationsmethode aus einem .NET Framework-Dienst zu erfassen, generieren Sie mit dem Tool VSInstr.exe eine instrumentierte Version der Komponente. Sie ersetzen dann die nicht instrumentierte Version des Diensts durch die instrumentierte Version und stellen dabei sicher, dass der Dienst für den manuellen Start konfiguriert ist. Verwenden Sie das VSPerfCLREnv.cmd-Tool, um die globalen Umgebungsvariablen für die Profilerstellung zu initialisieren und dann den Hostcomputer neu zu starten. Starten Sie anschließend den Profiler.
Wenn der Dienst gestartet wird, werden die Zeitsteuerungsdaten automatisch in einer Datendatei erfasst. Sie können die Datensammlung während der Profilerstellungssitzung anhalten und fortsetzen.
Um eine Profilerstellungssitzung zu beenden, deaktivieren Sie den Dienst und fahren danach den Profiler selbst herunter. In den meisten Fällen empfiehlt es sich, die Umgebungsvariablen für die Profilerstellung am Ende einer Sitzung zu entfernen.
Starten der Anwendung mit dem Profiler
So starten Sie die Profilerstellung für einen .NET Framework-Dienst
Öffnen Sie ein Eingabeaufforderungsfenster.
Generieren Sie mit dem VSInstr-Tool eine instrumentierte Version der Binärdatei des Diensts.
Ersetzen Sie die ursprüngliche Binärdatei durch die instrumentierte Version. Stellen Sie im Windows Dienststeuerungs-Manager sicher, dass der Starttyp auf Manuell eingestellt ist.
Initialisieren Sie die .NET Framework-Umgebungsvariablen für die Profilerstellung. Geben Sie Folgendes ein:
VSPerfClrEnv /globaltraceon
Starten Sie den Computer neu.
Öffnen Sie ein Eingabeaufforderungsfenster.
Starten Sie den Profiler. Geben Sie Folgendes ein:
**VSPerfCmd /start:trace /output:**OutputFile[Options]
Mit der Option /start:trace wird der Profiler initialisiert.
Die /output**:**OutputFile-Option ist bei /start erforderlich. Das OutputFile-Objekt gibt den Namen und den Speicherort der Profilerstellungs-Datendatei (.vsp) an.
Sie können jede der folgenden Optionen zusammen mit der /start:trace-Option verwenden.
Tipp
Die /user-Option und die /crosssession-Option sind normalerweise für Profilerstellungsdienste erforderlich.
Option
Beschreibung
/user:[Domain\]UserName
Gibt die Domäne und den Benutzernamen des Kontos an, das Besitzer des profilierten Prozesses ist. Diese Option ist nur erforderlich, wenn der Prozess als Benutzer ausgeführt wird, der nicht der angemeldete Benutzer ist. Der Prozessbesitzer ist auf der Registerkarte "Prozesse" in der Spalte "Benutzername" des Windows Task-Managers aufgeführt.
Aktiviert die Profilerstellung für Prozesse in anderen Sitzungen. Diese Option ist erforderlich, wenn die Anwendung in einer anderen Sitzung ausgeführt wird. Die Sitzungs-ID ist auf der Registerkarte "Prozesse" in der Spalte "Sitzungs-ID" des Windows Task-Managers aufgeführt. /CS kann als Abkürzung für /crosssession angegeben werden.
/waitstart[:Interval]
Gibt die Anzahl der Sekunden an, die auf die Initialisierung des Profilers gewartet werden soll, bevor ein Fehler zurückgegeben wird. Wenn Interval nicht angegeben wird, wartet der Profiler unendlich lange. Standardmäßig wird /start sofort beendet.
Um den Profiler mit angehaltener Datensammlung zu starten, fügen Sie der Befehlszeile /start die /globaloff-Option hinzu. Mit /globalon setzen Sie die Profilerstellung fort.
/counter:Config
Sammelt Informationen aus dem in Config angegebenen Prozessorleistungsindikator. Informationen zu Leistungsindikatoren werden den Daten hinzugefügt, die bei jedem Profilerstellungsereignis gesammelt werden.
/wincounter:WinCounterPath
Gibt einen Windows-Leistungsindikator an, dessen Daten während der Profilerstellung gesammelt werden sollen.
/automark:Interval
Diese Option kann nur in Kombination mit /wincounter verwendet werden. Gibt die Anzahl von Millisekunden zwischen Ereignissen bei der Datensammlung mit Windows-Leistungsindikatoren an. Der Standardwert ist 500 ms.
/events:Config
Gibt ein ETW-Ereignis (Ereignisablaufverfolgung für Windows) an, dessen Daten während der Profilerstellung gesammelt werden sollen. ETW-Ereignisse werden in einer separaten Datei (.etl) gesammelt.
Starten Sie den Dienst über den Windows Dienststeuerungs-Manager.
Steuern der Datenauflistung
Wenn der Dienst ausgeführt wird, können Sie die VSPerfCmd.exe-Optionen verwenden, um das Schreiben der Daten in die Profilerdatendatei zu starten und zu beenden. Durch das Steuern der Datensammlung können Sie Daten zu einem bestimmten Teil der Programmausführung sammeln, z. B. zum Starten oder Schließen des Diensts.
So starten und beenden Sie die Datensammlung
Die folgenden Paare von VSPerfCmd-Optionen starten und beenden die Datensammlung. Geben Sie jede Option in einer eigenen Befehlszeile an. Sie können die Datensammlung mehrmals aktivieren und deaktivieren.
Option
Beschreibung
Startet (/globalon) oder beendet (/globaloff) die Datensammlung für alle Prozesse.
/processon:PID /processoff:PID
Startet (/processon) oder beendet (/processoff) die Datensammlung für den mit der Prozess-ID (PID) angegebenen Prozess.
/threadon:TID /threadoff:TID
Startet (/threadon) oder beendet (/threadoff) die Datensammlung für den mit der Thread-ID (TID) angegebenen Thread.
Sie können auch die /mark-Option von VSPerfCmd.exe verwenden, um eine Profilmarkierung in die Datendatei einzufügen. Der /mark-Befehl fügt einen Bezeichner, einen Zeitstempel und eine optionale benutzerdefinierte Textzeichenfolge hinzu. Mit Markierungen können die Daten in Profilerberichten und Datenansichten gefiltert werden.
Beenden der Profilerstellungssitzung
Um eine Profilerstellungssitzung zu beenden, beenden Sie den Dienst, der die instrumentierte Komponente ausführt, und rufen Sie dann die VSPerfCmd /shutdown-Option auf, um den Profiler zu deaktivieren und die Profilerstellungs-Datendatei zu schließen. Mit dem VSPerfClrEnv /globaloff-Befehl werden die Umgebungsvariablen für die Profilerstellung gelöscht.
Sie müssen den Computer neu starten, damit die neuen Umgebungseinstellungen übernommen werden.
So beenden Sie eine Profilerstellungssitzung
Beendet den Dienst aus dem Dienststeuerungs-Manager.
Schließen Sie den Profiler. Geben Sie Folgendes ein:
VSPerfCmd /shutdown
Wenn Sie alle Profilerstellungsaufgaben abgeschlossen haben, entfernen Sie die Umgebungsvariablen für die Profilerstellung. Geben Sie Folgendes ein:
VSPerfClrEnv /globaloff
Ersetzen Sie das instrumentierte Modul durch das Original. Konfigurieren Sie bei Bedarf den Starttyp des Diensts neu.
Starten Sie den Computer neu.
Siehe auch
Konzepte
Profilerstellung für Dienste über die Befehlszeile