Profilermittlung für Anwendung im Standalone-Modus

Die folgenden Informationen treffen auf Windows zu. Die folgenden Informationen treffen auf AIX zu. Die folgenden Informationen treffen auf Linux Die folgenden Informationen treffen auf Solaris zu. Sie können ein Profil einer Anwendung im Standalone-Modus erstellen (also von der Befehlszeile aus), ohne die Hyades-Tools installiert zu haben. Dazu muss jedoch der Agent Controller auf der Maschine installiert sein, auf der sich Anwendung befindet, für die Sie ein Profil erstellen möchten.

Sie können eine Profilermittlung für eine Anwendung im Standalone-Modus durchführen, indem Sie den Java-Profilermittlungsagenten aufrufen, bei dem es sich um eine Bibliothek handelt, die einer Java-VM zugeordnet ist und das Verhalten Ihrer Java-Anwendung aufzeichnet. Die Ausgabe des Agenten erfolgt in Form von XML-Fragmenten.

Verwenden Sie die Java-Option -Xrun, um den Java Profiling Agent aufzurufen:

    -XrunpiAgent:agent_parm[,agent_parm]*

Wenn Sie beispielsweise ein Profil von PerformanceExample.java erstellen möchten, und dabei Filter aus der Datei myFilters.txt verwenden und die Daten aus der Profilerstellungssitzung in einer Datei mit dem Namen PEProfilingData speichern wollen, geben Sie dazu in einer Befehlszeile den folgenden Befehl ein:
    java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml PerformanceExample

Hinweis: Wenn Sie WebSphere Application Server Version 6 (WAS) im Profilerstellungsmodus von der Befehlszeile starten möchten, müssen Sie die folgenden Schritte ausführen:
  1. Wechseln Sie in <Profilstammverzeichnis>/config/cells/<knotenname>Cell/nodes/<knotenname>/servers/server1
  2. Bearbeiten Sie das Element jvmEntries in der Datei server.xml. In diesem Element befindet sich ein Attribut mit dem Namen genericJvmArguments. Hängen Sie -XrunpiAgent:server=enabled an den Attributwert an.
  3. Starten Sie WAS erneut.
     
 
Wenn Sie den Parameter -XrunpiAgent einsetzen, können Sie eine Reihe verschiedener Ausführungsmodi für den Profilagenten angeben. Der Parameter agent_parm kann einen der folgenden Werte annehmen:

Formatieren der Klassenfilterdatei

Die Filterdatei sollte drei Felder, Paket/Klasse, Methode und Modus im folgenden Format vorgeben:
   Paket/Klasse Methode Modus

Hierbei gilt Folgendes:

Paket/Klasse
Dieses Feld wird verwendet, um ein Muster für einen Paket- oder Klassennamen anzugeben. Das Muster muss als Zeichenfolge ohne eingebettete Leerzeichen angegeben werden. Die Zeichenfolge kann mit einem einzelnen Stern (*) anfangen oder enden, z.B. *.meinpaket oder org.meinunternehmen.*. Der Stern entspricht einer beliebigen Anzahl an Zeichen. Dadurch wird aus dem Muster ein generisches Präfix- oder Suffixmuster. Ein einzelner Stern kann auch stellvertretend für alle Zeichenfolgen angegeben werden.
Methode
Dieses Feld wird verwendet, um ein Muster für den Methodennamen anzugeben. Das Muster muss als Zeichenfolge ohne eingebettete Leerzeichen nach den gleichen Spezifikationsregeln wie für das Feld Klasse angegeben werden.
Modus
Dieses Feld gibt an, ob ein Paket bzw. eine Klasse, die dem Muster entspricht, bei der Profilermittlung ein- oder ausgeschlossen werden soll. Die gültigen Werte für den Modus sind INCLUDE und EXCLUDE.

Filtermuster werden in der Reihenfolge verarbeitet, in der sie angegeben werden, bis der erste Mustervergleich erfolgreich ist. Stimmt der Klassenname mit keinem der angegebenen Filtermuster überein, wird die Klasse in der Standardeinstellung eingeschlossen (INCLUDE).

Steuerung von Java Profiling Agent

Wenn der Java Profiling Agent mit einem der Parameter server=enabled oder server=controlled gestartet wird, findet die Kommunikation mit dem Agenten über die Client-Workbench durch den Agent Controller auf der Hostmaschine statt.

Hinweise

Zugehörige Konzepte
Übersicht über Profilermittlungstool
Profilermittlungsressourcen

Zugehörige Tasks
Profilermittlung für Anwendung im Standalone-Modus auf AS/400
Einen Java-Prozess starten oder anhängen
Sicht 'Profilermittlungsüberwachung' verwenden