Sovelluksen profilointi erillisessä tilassa
Voit profiloida sovelluksen erillisessä tilassa (toisin sanoen komentoriviltä) asentamatta TPTP-ympäristöä (Test and Performance Tools Platform).Agentin ohjaimen on tosin oltava asennettuna koneeseen, jossa profiloitava sovellus sijaitsee.
Voit profiloida sovelluksen erillisessä tilassa kutsumalla Java-profilointiagenttia. Java-profilointiagentti on kirjasto, joka muodostaa liitännän Java-näennäiskoneeseen (JVM), jotta Java-profilointiagentti voi tutkia ja tallentaa Java-sovelluksen toimintaa. Agentin tulosteet ovat XML-fragmentteja.
Voit kutsua Java-profilointiagenttia Java-valinnalla -Xrun:
-XrunpiAgent:agent_parm[,agent_parm]*
Voit esimerkiksi profiloida tiedoston PerformanceExample.java tiedostossa myFilters.txt määritettyjen suodattimien avulla ja ohjata profilointi-istunnon tiedot tiedostoon PEProfilingData kirjoittamalla seuraavan komennon komentoriville:
java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml
PerformanceExample
- Huomautus: Jos haluat aloittaa WebSphere
Application Server (WAS) 6 -ohjelman profilointitilassa komentorivikomennolla,
toimi seuraavasti:
- Siirry hakemistoon <profiilin juuri>/config/cells/<solmun_nimi>Cell/nodes/<solmun_nimi>/servers/server1
- Muokkaa server.xml-tiedoston jvmEntries-elementtiä. Etsi elementistä genericJvmArguments-määrite. Liitä
tämän määritteen arvoon osa -XrunpiAgent:server=enabled.
- Aloita WAS-ohjelma uudelleen.
-
- Lisäämällä parametrin -XrunpiAgent voit määrittää useita eri
tiloja, joissa profilointiagentti ajetaan. Parametrin
agent_parm arvona voi olla jokin seuraavista:
- server=[standalone | enabled | controlled | application]
- standalone
- Profilointiagentteja ajetaan näyttöpäätteettömässä tilassa. Agenttien ajoon ei voi vaikuttaa työympäristöstä. Kokoonpanotiedot saadaan kokoonpanotiedostoista ja profilointitiedot on tallennettu tiedostoon samaan paikkaan profilointiagentin kanssa. Profilointitiedosto voidaan näin ollen tuoda työympäristöön myöhemmin.
- Java-profilointiagentti muodostaa liitännän manuaalisesti JVM-ilmentymään ja
luo profilointitiedot tulostiedostoon. Oletustulostiedoston nimi on
called trace.trcxml, mutta voit määrittää toisen tiedoston nimen
parametrin file= tiedoston_nimi avulla. Kun tämä valinta on valittuna, Java-profilointiagentti
tuottaa traceRoot-lopetuselementin, jotta XML-asiakirjasta tulee kelvollinen.
- enabled (Tämä on oletusarvo.)
- Profilointiagentti on ajossa JVM-koneen taustalla, eikä se kuluta resursseja, ennen kuin työympäristö muodostaa agenttiin yhteyden ja pyytää valvonnan aloitusta. Tiedot siirretään agentin tietokanavan kautta, ja työympäristö käyttää tietoja.
Java-profilointiagentti on siis ladattu ja sallii sovelluksen olla ajossa normaalisti, mutta agentti ei tuota profilointitietoja, ennen kuin työasema muodostaa liitännän agenttiin ja antaa ohjeet. Kun tämä valinta on valittuna, Java-profilointiagentti tuottaa vain XML-fragmentteja kokonaisen XML-asiakirjan sijasta.
- controlled
- Profilointiagentti estää JVM-konetta toteuttamasta alustustoimia (agentti on ladattu, mutta se estää sovelluksen ajon), kunnes siihen on muodostettu liitäntä työympäristöstä, ja työasema on antanut sille ohjeet aloittaa valvonnan.
Kun profilointiagentti on aloitettu ohjatussa (controlled) tilassa, se pysäyttää JVM-koneen, kunnes agenttia pyydetään aloittamaan valvonta, jolloin agentti tuottaa vain XML-fragmentteja kokonaisen XML-asiakirjan sijasta.
- application
- Java-profilointiagentti on ladattu, se on ajossa taustalla ja sallii sovelluksen olla ajossa normaalisti käyttöönottotilassa (enabled).
- Agentti tuottaa profilointitietoja vain silloin, kun seuraavat kaksi ehtoa ovat täyttyneet.
Ensiksi sovelluksen on pyydettävä, että profilointiagentti aloittaa profiloinnin luokanorg.eclipse.hyades.collection.profiler.Profiler avulla, ja toiseksi työympäristön testityöaseman on muodostettava liitäntä Java-profilointiagenttiin ja aloitettava valvonta.
- Huomautus: Sovellus ohjaa kaikkea profilointia luokan org.eclipse.hyades.collection.profiler.Profiler avulla.
- profile=profilointitiedosto
Tämä valinta on käytössä vain, kun valinta server=standalone on määritetty. Tämä tiedosto määrittää valinnat, jotka ovat käytössä,
kun profilointitoiminto on ajossa erillisessä tilassa. Tässä tiedostossa määritetyt valinnat
määritetään yleensä profiloinnin määritysikkunassa, kun käyttäjä aloittaa Java-prosessin työympäristöstä. Tämän tiedoston käyttö vastaa valintojen määritystä, kun sovellusta ajetaan erillisessä tilassa.
Tiedoston voi ladata kahdella tavalla.
Luettelo profilointitiedoston kelvollisista valinnoista on kohdassa Erillisen profilointisuodattimen valinnat.
- filters=tiedoston_nimi
Valintaa käytetään vain, kun valinta server=standalone on määritetty.
Tämä määrittää sen tiedoston nimen, joka sisältää alkuperäiset luokkasuodattimen määritykset, joita käytetään profilointi-istunnon aikana. Tiedoston oletusnimi on filters.txt nykyisessä hakemistossa. Seuraavassa on tietoja tiedostomuodosta.
- file=tiedoston_nimi
Valintaa käytetään vain, kun valinta server=standalone on määritetty.
Tämä määrittää sen tiedoston nimen, johon profilointitiedot kirjoitetaan. Oletusnimi on
trace.trcxml nykyisessä hakemistossa.
- help
Lisää STDOUT-tulosteeseen käytettävissä olevat agenttivalinnat.
Luokkasuodatintiedoston muoto
Suodatintiedoston tulee määrittää kolme kenttää package/class, method ja mode seuraavassa muodossa:
package/class method mode
jossa:
- package/class
- Tämä kenttä määrittää paketin tai luokan nimen mallin.
Malli tulee määrittää merkkijonona, johon ei sisälly tyhjämerkkejä. Merkkijonossa voi olla yksi tähtimerkki (*) joko merkkijonon alussa tai lopussa, esimerkiksi *.mypackage tai org.mycompany.*. Tähtimerkki (*) vastaa nollaa tai useampaa merkkiä, mikä tekee mallista yleisen etuliitteen tai loppuliitteen mallin. Pelkkä tähtimerkki (*) edustaa koko merkkijonoa.
- method
- Tämä kenttä määrittää metodin nimen mallin.
Malli tulee määrittää merkkijonona, johon ei sisälly tyhjämerkkejä,
sekä samojen määrityssääntöjen avulla kuin class-kenttä.
- mode
- Tämä kenttä määrittää, sisällytetäänkö mallia vastaava paketti tai luokka profilointiin vai jätetäänkö se pois. Tilan arvo on joko INCLUDE tai EXCLUDE.
Suodatinmalleja käsitellään niiden määritysjärjestyksessä, kunnes ensimmäinen vastine löytyy.Jos luokan nimi ei vastaa mitään määritetyistä suodatinmalleista, oletusarvona on luokan sisällytys (INCLUDE-tila).
Java-profilointiagentin ohjaus
Kun Java-profilointiagentti aloitetaan parametrilla server=enabled
tai parametrilla server=controlled, yhteydet agenttiin hoidetaan työaseman työympäristössä pääkoneessa olevan agentin ohjaimen avulla.
Huomautukset
- Jos et määritä suodattimen määritystiedoston nimeä komentoriville, Java-profilointiagentti yrittää lukea suodattimet nykyisen hakemiston filters.txt-tiedostosta. Jos tiedostoa filters.txt ei ole, profilointi-istunnon aikana ei käytetä suodattimia. Jos annan suodatintiedoston nimeksi
filters.txt ja sijoitat tiedoston nykyiseen hakemistoon, suodatinparametria ei tarvitse määrittää komentorivillä, jotta profilointiagentti käyttäisi suodattimia.
- Jos et määritä tulostiedostoa profilointitiedoille, ne tallennetaan trace.trcxml-tiedostoon.
- Tulostiedostolle ei tarvitse määrittää tunnistetta. Tulostiedoston tunnisteeksi liitetään
automaattisesti tunniste .trcxml
- Java-sovellukselle ei tarvitse määrittää tunnistetta. Sovellus voi olla
.class-tiedosto.
Aiheeseen liittyviä käsitteitä
Profilointityökalun yleiskuvaus
Profilointiresurssit
Aiheeseen liittyviä tehtäviä
Sovelluksen profilointi erillisessä tilassa AS/400-järjestelmässä
Java-prosessin aloitus tai liittäminen
Profiloinnin valvontaohjelma -näkymän käyttö
(C) Copyright IBM Corporation 2000, 2006. All rights reserved.