Profilkészítés alkalmazásról önálló módban
Profil készítése alkalmazáson önálló módban (azaz a parancssorból), telepített Teszt- és
teljesítményvezérlési eszközök platform nélkül.
Azonban az ügynökvezérlőnek telepítve kell lennie a profilkészítésre
szánt alkalmazás tárolását végző gépen.
Egy alkalmazás önálló módban profilkészítése a Java profilkészítési ügynök
meghívásával tehető meg, ami a Java alkalmazás viselkedésének befogására és
rögzítésére használt, Java virtuális géphez (JVM) csatlakoztatott függvénytár.
Az ügynök kimenete XML töredék formátumú.
A Java profilkészítési ügynök meghívásához a -Xrun Java
paraméter használható:
-XrunpiAgent:agent_parm[,agent_parm]*
Például a TeljesitmenyPelda.java sajatSzurok.txt fájlban megadott szűrők
használatával profilkészítéséhez és az adatok profilkészítési munkamenetből a
TPProfilAdatok nevű fájlba irányításához az alábbi parancs használható:
java -XrunpiAgent:server=standalone,filters=sajatSzurok.txt,file=TPProfilAdatok.trcxml
TeljesitmenyPelda
- Megjegyzés: Ha el szeretné indítani a WebSphere
Application Server 6. változatát (WAS) profilozási módban a parancssorból, akkor
tegye a következőket:
- Lépjen a következőre: <profile root>/config/cells/<nodename>Cell/nodes/<nodename>/servers/server1
- A server.xml fájlban szerkessze a jvmEntries elemet. Az elemben található egy genericJvmArguments attribútum. Az attribútum
értékéhez fűzze hozzá: -XrunpiAgent:server=enabled.
- Indítsa újra a WAS kiszolgálót.
-
- A parancsot a -XrunpiAgent paraméterrel kiegészítve a
profilkészítési ügynök futásának számos különböző módja adható meg. Az
agent_parm paraméter az alábbi értékek egyikét veheti fel:
- server=[standalone | enabled | controlled | application]
- standalone
- A profilkészítési ügynök megjelenítés nélküli módban fut, ami azt
jelenti, hogy a munkaterületről nem lehetséges az együttműködés vele. A
konfigurációs információkat a konfigurációs fájlok és a profilkészítési ügynök
által közvetlenül egy fájlban tárolt profilkészítési adatok biztosítják. A
profilkészítési fájl később is importálható a munkaterületbe.
- A Java profilkészítési ügynök saját kezűleg csatlakozik a JVM
példányhoz és profilkészítési adatokat állít elő egy kimeneti fájlba. Az
alapértelmezett kimeneti fájl neve trace.trcxml, de a file= fájlnév
paraméter használatával megadható más név is. Ezen beállítás kiválasztása
esetén a Java profilkészítési ügynök egy mellékelt traceRoot elemet állít elő
egy teljes és érvényes XML dokumentum formázásához.
- enabled (engedélyezett - ez az alapértelmezés)
- A profilkészítési ügynök a JVM hátterében erőforrások pazarlása nélkül
fut a munkaterület által csatlakoztatásig és a megfigyelés indítási kéréséig.
Az adatok ekkor átmennek az ügynök adatcsatornáján és a munkaterület által
felhasználásra kerülnek.
A betöltött Java profilkészítési ügynök lehetővé teszi az alkalmazás szokásos
futását, azonban csak azután állít elő profilkészítési adatokat, ha egy ügyfél
egy ügynökhöz csatlakozott és utasításokat ad neki. Ezen beállítás kiválasztása
esetén a Java profilkészítési ügynök teljes XML dokumentum helyett csak XML
töredékeket állít elő.
- controlled (vezérelt)
- A profilkészítési ügynök megakadályozza a Java virtuális gép
inicializálását (az ügynök betöltésre kerül, de letiltja az alkalmazás
futását), amíg a munkaterület nem csatlakozik hozzá és nem kap utasításokat a
megfigyelés indítására egy ügyféltől.
A profilkészítési ügynök vezérelt módban indításakor a JVM felfüggesztésére
jelenik meg a megfigyelés indításának kéréséig és teljes XML dokumentum helyett
csak XML töredékeket állít elő.
- application (alkalmazás)
- A Java profilkészítési ügynök betöltésre kerül, a háttérben fut és
lehetővé teszi az alkalmazás szokásos futását, ahogy az engedélyezett módban.
- Csak két feltétel kielégítése esetén állít elő profilkészítési
adatokat.
Az első, hogy az alkalmazáshoz kérésnek kell érkeznie arról, hogy a
profilkészítési ügynök elkezdje a profilkészítést az
org.eclipse.hyades.collection.profiler.Profiler használatával. A
második, hogy a munkaterület tesztügyfelének csatalkoznia kell a Java
profilkészítési ügynökhöz és a megfigyelésnek futnia kell.
- Megjegyzés: Az alkalmazás által irányított összes
profilkészítés az org.eclipse.hyades.collection.profiler.Profiler
osztályt használja.
- profile=profilkészítési fájl
Ezen beállítás csak server=standalone esetén használható. Ezen fájl
azon beállításokat határozza meg, amelyekkel önálló mód esetén a profilkészítő
futtatásra kerül. Az ezen fájlban található beállítások általában a
profilkészítési konfiguráció ablakban a munkaterületről Java folyamat
felhasználói indítása esetén kerülnek megadásra. Ezen fájl használata
egyenértékű a beállítások önálló módban futáskor megadásával.
Ezen fájl az alábbi két mód egyikén kerülhet betöltésre.
A profilkészítési fájl érvényes beállításainak listája az
Önálló profilkészítési szűrőbeállítások
témakörben található.
- filters=fájlnév
Csak server=standalone esetén használt.
A profilkészítési munkamenet közben használni kívánt kezdeti osztály
szűrőmeghatározásokat tartalmazó fájl nevét határozza meg. Az
alapértelmezett fájlnév a filters.txt az aktuális könyvtárban. A fájl
formátumával kapcsolatos információk alább láthatók.
- file=fájlnév
Csak server=standalone esetén használt.
Azon fájl nevét határozza meg, amelybe a profilkészítési adatok beírásra
kerülnek. Az alapértelmezés a trace.trcxml az aktuális könyvtárban.
- help
A rendelkezésre álló ügynökbeállítások felsorolása a szabványos kimenetre.
Az osztály szűrőfájl formátuma
A szűrőfájlnak három mezőt meg kell adni - csomag/osztály,
metódus és mód - az alábbi formátumban:
csomag/osztály metódus mód
ahol
- csomag/osztály
- A mező egy csomag- vagy osztálynévhez ad meg egy mintát.
A mintát karaktersorozatként kell megadni beágyazott üres karakterek nélkül. A karaktersorozat
az elején vagy a végén tartalmazhat egy csillagot (*), például
*.mypackage vagy org.mycompany.*. A * nulla
vagy több karakterrel eredményez egyezést, így a minta általános előtagú vagy
utótagú mintává tehető. Csak a * megadása az összes karaktersorozatot
képviseli.
- metódus
- A mező a metódusnévhez ad meg egy mintát.
A mintát karaktersorozatként kell megadni beágyazott üres karakterek nélkül és ugyanazzal a
specifikációs szabályokkal, mint az osztály mezőt.
- mód
- A mező megadja, hogy a mintának megfelelő csomagot vagy osztályt
a profilkészítés tartalmazza-e. Az mód értéke INCLUDE (beemelés) vagy
EXCLUDE (kizárás) lehet.
A szűrőminták a megadás sorrendjében kerülnek feldolgozásra az első
egyezésig. Ha az osztály neve egy megadott szűrőmintával sem eredményez
egyezést, akkor alapértelmezésben az osztály beemelésre kerül (INCLUDE).
Java profilkészítési ügynök vezérlése
A Java profilkészítési ügynök server=enabled vagy
server=controlled paraméterrel indításakor az ügynökkel
kommunikáció az ügyfél munkaterület használatával a hoszt gépen lévő
ügynökvezérlő által történik meg.
Megjegyzések
- Ha nem kerül megadásra a szűrő meghatározás fájl neve a parancssorban,
akkor a Java profilkészítési ügynök az aktuális könyvtárban a filters.txt
fájlból próbálja kiolvasni a szűrőket. Ha nem létezik filters.txt fájl, akkor
nem kerül felhasználásra szűrő a profilkészítési munkamenet alatt. Ha a
szűrőfájl az aktuális könyvtárban filters.txt fájlként jelenik meg, akkor nincs
szükség a szűrőparaméterek megadására a parancssorban ahhoz, hogy
felhasználásra kerüljenek a profilkészítési ügynök által.
- Ha nincs megadva kimeneti fájl a profilkészítési adatok számára, akkor azok
a trace.trcxml fájlba kerülnek elmentésre.
- A kimeneti fájl kiterjesztését nem szükséges megadni. Automatikusan .trcxml
lesz a kiterjesztés.
- A Java alkalmazás kiterjesztését nem szükséges megadni. Ez egy .class fájl
lehet.
Kapcsolódó fogalmak
A profilkészítő eszköz bemutatása
Profilkészítési erőforrások
Kapcsolódó feladatok
Profilkészítés alkalmazásról önálló módban
AS/400 rendszeren
Java alkalmazás indítása vagy hozzácsatlakozás
Profilkészítés-figyelő nézet használata
(C) Copyright IBM Corporation 2000, 2006. Minden jog fenntartva.