ILoadTestPlugin-Schnittstelle
Aktualisiert: November 2007
Definiert eine Schnittstelle, die so implementiert ist, dass die beim Ausführen des Auslastungstests und der darin enthaltenen Tests auftretenden Ereignisse von einer vom Benutzer erstellten Klasse behandelt werden können.
Namespace: Microsoft.VisualStudio.TestTools.LoadTesting
Assembly: Microsoft.VisualStudio.QualityTools.LoadTestFramework (in Microsoft.VisualStudio.QualityTools.LoadTestFramework.dll)
Syntax
Public Interface ILoadTestPlugin
Dim instance As ILoadTestPlugin
public interface ILoadTestPlugin
public interface class ILoadTestPlugin
public interface ILoadTestPlugin
Hinweise
Dies kann mit einer durch den Benutzer erstellten Klasse implementiert werden, um den vom Benutzer erstellten Code in das Auslastungstest-Laufzeitmodul auf dem Agent einzubinden. Das entsprechende Plug-In wird im Auslastungstest-Editor angegeben.
Sie können ein Auslastungstest-Plug-In erstellen, um bei der Ausführung eines Auslastungstests Code zu verschiedenen Zeiten auszuführen, z. B. nach Überschreitung eines Schwellenwerts, vor dem Start und nach Abschluss eines Auslastungstests, vor dem Start und nach Abschluss einer Testiteration, bei Abbruch eines Auslastungstests oder wenn sich die Auslastung im Test geändert hat. Folgende Ereignisse können durch die Implementierung von ILoadTestPlugin behandelt werden: LoadTestStarting, LoadTestFinished, LoadTestWarmupComplete, TestStarting, TestFinished, TestSelected, ThresholdExceeded, HeartBeat() und LoadTestAborted.
Die Implementierung eines Auslastungstest-Plug-Ins kann zum Erweitern oder Ändern des Verhaltens eines Auslastungstests bei der Ausführung verwendet werden. Die folgende Liste enthält einige Verwendungsmöglichkeiten für ein Auslastungstest-Plug-In:
Starten eines externen Prozesses, z. B. eines Überwachungstools, kurz vor dem Starten des Auslastungstests und Beenden des Prozesses bei Abschluss des Auslastungstests.
Programmgesteuerte Benutzerauslastung während der Ausführung des Auslastungstests, Überschreiben der im Auslastungstest-Editor angegebenen Benutzerauslastung.
Programmgesteuerte Auswahl eines einzelnen innerhalb des Auslastungstests auszuführenden Tests, Überschreiben des Standard-Testauswahlalgorithmus.
Abbrechen des Auslastungstests, wenn der Wert eines Leistungsindikators das Fehlschlagen einer im Auslastungstest definierten Schwellenwertregel verursacht.
Beibehalten einer gemeinsamen Variable für alle Testiterationen eines Auslastungstests. Dazu implementiert das Auslastungstest-Plug-In eine Variable als statische Eigenschaft, auf die die Tests unter Belastung zugreifen. Die Variable wird in der Initialize-Methode des Auslastungstest-Plug-Ins initialisiert. Ein Ereignishandler wird dem LoadTestFinished-Ereignis hinzugefügt, der zu Berichterstellungszwecken für den Zugriff auf den letzten Wert verwendet werden kann.
Hinweise zur Implementierung:
Wird der Auslastungstest auf mehreren Agents ausgeführt, wird die Auslastungstest-Plug-In-Klasse auf allen Agents instanziiert. Wenn das Auslastungstest-Plug-In einen Vorgang nur auf einem Agent ausführen muss, sollte die AgentId-Eigenschaft des LoadTestContext-Objekts überprüft und der Vorgang nur ausgeführt werden, wenn der Wert von AgentId 1 ist.
Beispiele
Ein Beispiel finden Sie unter Gewusst wie: Erstellen eines Auslastungstest-Plug-Ins.