Exemplarische Vorgehensweise: Verwenden von Profiler-APIs

Artikel
07/20/2011

Die exemplarische Vorgehensweise verwendet eine C#-Anwendung, um die Verwendung der APIs der Visual Studio-Profilerstellungstools zu veranschaulichen. Sie verwenden die Profiler-APIs zum Beschränken der Datenmenge, die während der instrumentierten Profilerstellung erfasst wird.

Die Schritte in dieser exemplarischen Vorgehensweise gelten allgemein für eine C/C++-Anwendung. Für jede Sprache muss die Buildumgebung entsprechend konfiguriert werden.

Normalerweise analysieren Sie zuerst die Anwendungsleistung mithilfe der Sampling-Profilerstellung. Wenn die Sampling-Profilerstellung keine Informationen zur genauen Bestimmung eines Leistungsengpasses liefert, können anhand der instrumentierten Profilerstellung detailliertere Informationen abgerufen werden. Die instrumentierte Profilerstellung ist sehr hilfreich beim Untersuchen der Threadinteraktion.

Eine größere Detailstufe bedeutet jedoch, dass mehr Daten erfasst werden. Sie werden vielleicht feststellen, dass bei der instrumentierten Profilerstellung große Datendateien erzeugt werden. Außerdem wirkt sich die Instrumentierung auch stärker auf die Anwendungsleistung aus. Weitere Informationen finden Sie unter Grundlagen zu Instrumentationsdatenwerten in Profilerstellungstools und unter Grundlagen zu Samplingdatenwerten in Profilerstellungstools.

Mit dem Visual Studio-Profiler können Sie die Datenerfassung einschränken. Diese exemplarische Vorgehensweise ist ein Beispiel dafür, wie die Datenerfassung mit den Profiler-APIs eingeschränkt wird. Der Visual Studio-Profiler stellt eine API bereit, mit der die Datenerfassung aus einer Anwendung heraus gesteuert wird.

Bei systemeigenem Code befinden sich die Visual Studio-Profiler-APIs in VSPerf.dll. Die Headerdatei VSPerf.h und die Importbibliothek VSPerf.lib befinden sich im Verzeichnis Microsoft Visual Studio 9\Team Tools\Performance Tools.

Bei verwaltetem Code befinden sich die Profiler-APIs in Microsoft.VisualStudio.Profiler.dll. Diese DLL befindet sich im Verzeichnis Microsoft Visual Studio 9\Team Tools\Performance Tool. Weitere Informationen hierzu finden Sie unter Microsoft.VisualStudio.Profiler.

Vorbereitungsmaßnahmen

In dieser exemplarischen Vorgehensweise wird davon ausgegangen, dass die ausgewählte Entwicklungsumgebung für die Unterstützung von Debuggen und Sampling konfiguriert ist. Die folgenden Themen enthalten eine Übersicht über diese Voraussetzungen:

Gewusst wie: Auswählen von Sammlungsmethoden

Gewusst wie: Verweisen auf Windows-Symbolinformationen

Wenn der Profiler gestartet wird, werden standardmäßig Daten auf globaler Ebene erfasst. Durch den folgenden Code am Anfang des Programms wird die globale Profilerstellung deaktiviert.

        DataCollection.StopProfile(
        ProfileLevel.Global,
        DataCollection.CurrentId);

Sie können die Datenerfassung in der Befehlszeile deaktivieren, ohne einen API-Aufruf auszuführen. Bei den folgenden Schritten wird vorausgesetzt, dass die Befehlszeilen-Buildumgebung für die Ausführung sowohl von Profilerstellungs- als auch von Entwicklungstools konfiguriert ist. Dies schließt die für VSInstr und VSPerfCmd erforderlichen Einstellungen ein. Siehe Profilerstellungstools für die Befehlszeile.

Beschränken der Datenerfassung mit Profiler-APIs

So erstellen Sie den Code für die Profilerstellung

Erstellen Sie je nach Ihren Anforderungen ein neues C#-Projekt in Visual Studio, oder verwenden Sie ein Befehlszeilenbuild.

Tipp

Der Build muss auf die Microsoft.VisualStudio.Profiler.dll-Bibliothek verweisen, die sich im Verzeichnis Microsoft Visual Studio <Version> Professional Edition 9\Team Tools\Performance Tools befindet.

Kopieren und fügen Sie den folgenden Code in das Projekt ein:

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.VisualStudio.Profiler;

namespace ConsoleApplication2
{
    class Program
    {
        public class A
        {
         private int _x;

         public A(int x)
         {
          _x = x;
         }

         public int DoNotProfileThis()
         {
          return _x * _x;
         }

         public int OnlyProfileThis()
         {
          return _x + _x;
         }

         public static void Main()
         {
        DataCollection.StopProfile(
        ProfileLevel.Global,
        DataCollection.CurrentId);
          A a;
          a = new A(2);
          int x;    
          Console.WriteLine("2 square is {0}", a.DoNotProfileThis());
          DataCollection.StartProfile(
              ProfileLevel.Global,
              DataCollection.CurrentId);
          x = a.OnlyProfileThis();
          DataCollection.StopProfile(
              ProfileLevel.Global, 
              DataCollection.CurrentId);
          Console.WriteLine("2 doubled is {0}", x);
         }
        }

    }
}

So erfassen und zeigen Sie Daten in der Visual Studio-IDE an

Öffnen Sie die Visual Studio-IDE. Zeigen Sie im Menü Analyse auf Profiler, und klicken Sie dann auf Neue Leistungssitzung.
Fügen Sie die kompilierte Binärdatei der Liste Ziele im Fenster Leistungs-Explorer hinzu. Klicken Sie mit der rechten Maustaste auf Ziele, und klicken Sie dann auf Zielbinärdatei hinzufügen. Suchen Sie die Binärdatei im Dialogfeld Zielbinärdatei hinzufügen, und klicken Sie dann auf Öffnen.
Wählen Sie aus der Liste Methode auf der Symbolleiste Leistungs-Explorer Instrumentation aus.
Klicken Sie auf Mit Profilerstellung starten.

Der Profiler instrumentiert die Binärdatei, führt sie aus und erstellt eine Leistungsberichtsdatei. Die Leistungsberichtsdatei wird im Knoten Berichte des Leistungs-Explorers angezeigt.
Öffnen Sie die resultierende Leistungsberichtsdatei.

Wenn der Profiler gestartet wird, werden standardmäßig Daten auf globaler Ebene erfasst. Durch den folgenden Code am Anfang des Programms wird die globale Profilerstellung deaktiviert.

        DataCollection.StopProfile(
        ProfileLevel.Global,
        DataCollection.CurrentId);

So erfassen und zeigen Sie Daten in der Befehlszeile an

Kompilieren Sie eine Debugversion des oben in dieser exemplarischen Vorgehensweise unter "So erstellen Sie den Code für die Profilerstellung" erstellten Beispielcodes.
Zur Profilerstellung für eine verwaltete Anwendung geben Sie den folgenden Befehl ein, um die entsprechenden Umgebungsvariablen festzulegen:

VsPefCLREnv /traceon
Geben Sie den folgenden Befehl ein: VSInstr <Dateiname>.exe
Geben Sie den folgenden Befehl ein: VSPerfCmd /start:trace /output:<Dateiname>.vsp
Geben Sie den folgenden Befehl ein: VSPerfCmd /globaloff
Führen Sie das Programm aus.
Geben Sie den folgenden Befehl ein: VSPerfCmd /shutdown
Geben Sie den folgenden Befehl ein: VSPerfReport /calltrace:<Dateiname>.vsp

Eine CSV-Datei wird mit den resultierenden Leistungsdaten im aktuellen Verzeichnis erstellt.

Siehe auch

Freigeben über

Exemplarische Vorgehensweise: Verwenden von Profiler-APIs

Vorbereitungsmaßnahmen

Beschränken der Datenerfassung mit Profiler-APIs

So erstellen Sie den Code für die Profilerstellung

So erfassen und zeigen Sie Daten in der Visual Studio-IDE an

So erfassen und zeigen Sie Daten in der Befehlszeile an

Siehe auch

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen