Profilér et program i enkeltstående tilstand

Følgende oplysninger gælder for Windows. Følgende oplysninger gælder for AIX. Følgende oplysninger gælder for Linux. Følgende oplysninger gælder for Solaris. Du kan profilere et program i enkeltstående tilstand (dvs. fra kommandolinjen) uden at have installeret platformen for test- og ydeevneværktøjer (Test and Performance Tools Platform). Men du skal have Agent Controller installeret på den maskine, hvor programmet, der skal profileres, er placeret.

Du kan profilere et program i enkeltstående tilstand ved at starte Java-profileringsagenten, som er et bibliotek, der opretter tilknytning til en JVM (Java Virtual Machine) for at fastholde og registrere funktionsmåden af dit Java-program. Outputtet fra agenten er XML-fragmenter.

Brug Java-indstillingen -Xrun til at starte Java-profileringsagenten:

    -XrunpiAgent:agent_parm[,agent_parm]*

Hvis du f.eks. vil profilere PerformanceExample.java vha. filtre, der er defineret i filen mineFiltre.txt, og vil omdirigere dataene fra profileringssessionen til en fil med navnet PEProfilingData, skal du skrive følgende på en kommandolinje:
    java -XrunpiAgent:server=standalone,filters=mineFiltre.txt,file=PEProfilingData.trcxml PerformanceExample

Bemærk: Udfør følgende trin, hvis du vil starte WebSphere Application Server Version 6 (WAS) i profileringstilstand fra kommandolinjen:
  1. Skift til <profilrod>/config/cells/<nodenavn>Cell/nodes/<nodenavn>/servers/server1
  2. Redigér elementet jvmEntries element i filen server.xml. I elementet findes en attribut ved navn genericJvmArguments. Tilføj -XrunpiAgent:server=enabled til attributværdien.
  3. Start WAS igen.
     
 
Ved at forbedre parameteren -XrunpiAgent kan du angive flere forskellige tilstande, som profileringsagenten skal køre i. Parameteren agent_parm kan have en af følgende værdier:

Format af klassefilterfil

Filterfilen skal angive tre felter, package/class, method og mode i følgende format:
   package/class method mode

hvor:

package/class
Dette felt bruges til at angive et mønster for en pakke eller et klassenavn. Mønsteret skal angives som en streng uden indsatte blanktegn. Strengen kan indeholde en enkelt stjerne (*), enten i starten af strengen eller efter strengen, f.eks. *.minpakke eller org.mitfirma.*. * matcher nul eller flere tegn, så mønsteret bliver et generisk præfiks- eller suffiksmønster. En enkelt * kan også angives for at repræsentere alle strenge.
method
Dette felt bruges til at angive et mønster for metodenavnet. Mønsteret skal angives som en streng uden indsatte blanktegn og med samme specifikationsregler som class-feltet.
mode
Dette felt angiver, om den pakke eller klasse, der matcher mønsteret, skal inkluderes eller udelades fra profilering. Værdien for mode er enten INCLUDE eller EXCLUDE.

Filtermønstre behandles i den rækkefølge, de er angivet i, indtil den første mønstermatch findes. Hvis klassenavnet ikke matcher nogen af de angivne filtermønstre, bliver klassen som standard inkluderet (INCLUDE).

Styring af Java-profileringsagent

Når Java-profileringsagenten startes med parameteren server=enabled eller server=controlled, udføres kommunikation med agenten fra klientarbejdsbænken vha. Agent Controller på værtsmaskinen.

Bemærkninger

Relaterede begreber
Oversigt over profileringsværktøjet
Profileringsressourcer

Relaterede opgaver
Profilér et program i enkeltstående tilstand på AS/400
Start eller tilknyt til Java-proces
Brug af oversigten Profileringsovervågning