Creazione del profilo di un'applicazione in modalità autonoma
È possibile creare il profilo di un'applicazione in modalità autonoma (ovvero dalla riga comandi),
senza dover installare Test and Performance Tools Platform. Tuttavia,
Agent Controller dovrà essere installato sul computer in cui si trova l'applicazione per cui
creare il profilo.
È possibile creare un profilo di un'applicazione in modalità autonoma richiamando l'agente di
creazione profili Java, ovvero una libreria collegata a una JVM (Java Virtual Machine)
per acquisire e registrare il comportamento dell'applicazione Java. L'output dell'agente sarà in forma di frammenti XML.
Utilizzare l'opzione Java -Xrun per richiamare l'agente di creazione profili Java.
-XrunpiAgent:agent_parm[,agent_parm]*
Ad esempio, per creare il profilo di PerformanceExample.java
utilizzando i filtri definiti nel file myFilters.txt e indirizzando i dati
provenienti dalla sessione di creazione profili al file PEProfilingData, immettere quanto segue in
una riga comandi:
java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml
PerformanceExample
- Nota: per avviare WebSphere
Application Server Versione 6 (WAS) in modalità creazione profili da riga comandi, è necessario procedere come segue:
- Andare a <profile root>/config/cells/<nodename>Cell/nodes/<nodename>/servers/server1
- Modificare l'elemento jvmEntries nel file server.xml. In questo elemento è presente un attributo denominato genericJvmArguments. Accodare
-XrunpiAgent:server=enabled al valore dell'attributo.
- Riavviare WAS.
-
- Aumentando il valore del parametro -XrunpiAgent, è possibile specificare diversi
modi con cui eseguire l'agente di creazione profili. Il parametro agent_parm può avere uno dei seguenti valori:
- server=[standalone | enabled | controlled | application]
- standalone
- L'agente di creazione profili viene eseguito in modalità autonoma, il che significa
che non è possibile interagire con l'agente dal workbench. Le informazioni di configurazione vengono fornite
mediante i file di configurazione e l'agente memorizza i dati di profilo direttamente in un file. Il file di profilo potrà essere importato nel
workbench in un momento successivo.
- L'agente di creazione profili Java viene collegato manualmente all'istanza della JVM e
genera dati di profilo in un file di output. Il file di output predefinito è
trace.trcxml, ma è possibile specificare un nome diverso mediante il parametro
file= filename. Quando questa opzione è selezionata, l'agente di creazione profili Java
produce un elemento traceRoot di inclusione per formare un documento XML completo e valido.
- enabled (valore predefinito).
- L'agente di creazione profili viene eseguito nel background della JVM senza utilizzare alcuna risorsa
fino a quando non viene connesso mediante il workbench e gli viene richiesto di avviare il controllo. I dati vengono quindi inviati attraverso il canale dati
dell'agente e utilizzati dal workbench.
Quando l'agente di creazione profili Java viene caricato, consente all'applicazione di essere eseguita
normalmente, ma non produce dati di profilo fino a quando un client non si collega all'agente e
specifica delle istruzioni. Quando questa opzione è selezionata, l'agente di creazione profili Java
produce solo frammenti XML invece di un documento XML completo.
- controlled
- L'agente di creazione profili impedisce l'inizializzazione della JVM (l'agente è caricato
ma blocca l'esecuzione dell'applicazione) fino a quando non viene collegato dal
workbench e un client non gli fornisce istruzioni per avviare il controllo.
In altre parole, quando l'agente di creazione profili viene avviato in modalità controllata,
bloccherà la JVM fino a quando non gli viene richiesto di avviare il controllo; una volta avviato produrrà
solo frammenti XML invece di un documento XML completo.
- application
- L'agente di creazione profili Java viene caricato, viene eseguito in background, e consente
all'applicazione di essere eseguita normalmente come in modalità enabled.
- Produrrà dati di profilo sono se vengono soddisfatte due condizioni.
L'applicazione dovrà aver richiesto che l'agente di creazione profili avvii la creazione
utilizzando org.eclipse.hyades.collection.profiler.Profiler e
il client di verifica del workbench dovrà essere collegato all'agente di creazione profili Java
e aver avviato il controllo.
- Nota: tutte le creazioni di profili vengono controllati dall'applicazione mediante
la classe org.eclipse.hyades.collection.profiler.Profiler.
- profile=profile file
Questa opzione è applicabile solo quando server=standalone. Questo file specifica le opzioni
con le quali si desidera eseguire il profiler in modalità autonoma. Di solito, le opzioni specificate
in questo file vengono impostate nella finestra delle configurazioni di creazione profili quando l'utente avvia un
processo Java dal workbench; utilizzare questo file equivale a specificare
le opzioni quando si esegue la modalità autonoma.
Il file può essere caricato in uno dei seguenti due modi:
Vedere Opzioni di filtro di profili autonomi per un elenco di opzioni valide per il file del profilo.
- filters=filename
Utilizzato solo se viene specificato server=standalone.
Indica il nome del file che contiene le definizioni dei filtri delle classi iniziali da utilizzare
durante la sessione di creazione profili. Il nome file predefinito è filters.txt nella directory corrente. Per informazioni sul formato del file, fare riferimento al paragrafo successivo.
- file=filename
Utilizzato solo se viene specificato server=standalone.
Indica il nome del file in cui verranno scritti i dati di profilo. Il file predefinito è trace.trcxml nella directory corrente.
- help
Consente di visualizzare un elenco di opzioni dell'agente disponibili in STDOUT.
Formato del file filtro di classi
Il file filtro dovrebbe specificare tre campi, package/class, method, and mode nel
seguente formato:
package/class method mode
dove:
- package/class
- Questo campo viene utilizzato per specificare un modello per il nome del pacchetto o della classe.
Il modello dovrebbe essere specificato come una stringa che non contiene spazi. La stringa può contenere
un singolo asterisco (*) all'inizio o alla fine: ad esempio,
*.mypackage o org.mycompany.*. L'asterisco corrisponde a zero o più caratteri, rendendo il modello un prefisso o un suffisso generico. È anche possibile specificare un solo asterisco per rappresentare tutte le stringhe.
- metodo
- Questo campo viene utilizzato per specificare un modello per il nome del metodo.
Il modello dovrebbe essere specificato come una stringa che non contiene spazi
e con le stesse regole di specificazione del campo class.
- mode
- Questo campo specifica se il pacchetto o la classe che corrisponde al modello deve essere
inclusa o esclusa dalla creazione profili. Il valore di mode è INCLUDE o EXCLUDE.
I modelli dei filtri vengono elaborati nell'ordine in cui vengono specificati fino a quando non viene
rilevata la prima corrispondenza. Se il nome della classe non corrisponde a nessuno dei modelli
filtro selezionati, per impostazione predefinita la classe verrà inclusa (INCLUDE).
Controllo agente di creazione profili Java
Quando l'agente di creazione profili Java viene avviato con il parametro server=enabled
o server=controlled, la comunicazione con l'agente viene effettuata attraverso il
workbench del client mediante Agent Controller installato sul computer host.
Note
- Se non viene indicato alcun file di definizione filtri nella riga comandi,
l'agente di creazione profili Java tenterà di leggere i filtri dal file
filters.txt nella directory corrente. Se il file filters.txt non esiste,
durante la sessione di creazione profili, non verrà utilizzato alcun filtro. Se il file
viene denominato filters.txt e situato nella directory corrente, non sarà necessario specificare
alcun parametro nella riga comandi affinché i filtri vengano utilizzati dall'agente di creazione profili.
- Se non viene specificato alcun file di output per i dati di profilo, i dati verranno salvati nel file
trace.trcxml
- Non è necessario specificare alcuna estensione per il file di output. Verrà utilizzata automaticamente
l'estensione .trcxml
- Non è necessario specificare alcuna estensione per l'applicazione Java. Può essere utilizzato un file
.class.
Argomenti correlati
Panoramica sullo strumento Creazione profili
Risorse di creazione profili
Attività correlate
Creazione del profilo di un'applicazione in modalità autonoma su AS/400
Avvio o collegamento di un processo Java
Utilizzo della vista Controllo di creazione profili
(C) Copyright IBM Corporation 2000, 2006. Tutti i diritti riservati.