Creazione del profilo di un'applicazione in modalità autonoma
È possibile creare il profilo di un'applicazione in modalità autonoma (ovvero dalla riga comandi)
senza che gli strumenti Hyades siano installati. Tuttavia,
Agent Controller dovrà essere installato sul computer in cui si trova l'applicazione per cui
creare il profilo.
È possibile creare il profilo di un'applicazione in modalità autonoma, richiamando
l'agente di creazione profili Java, ovvero una libreria collegata a una JVM (Java virtual machine)
che registra il comportamento dell'applicazione Java. Il formato dell'output dell'agente
saranno 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
- 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 di Agent Controller 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.
- 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 disponibili.
Formato del file filtro di classi
Di seguito è riportato il formato del file:
pattern mode
dove:
- pattern
- Stringa non contenente spazi. La stringa può contenere un singolo asterisco
(*) all'inizio o alla fine. 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.
- mode
- Indica se la classe che corrisponde al modello dovrà essere inclusa o esclusa dalla creazione
del profilo. 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 l'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 dello strumento Creazione profili
Creazione profili di risorse
Vista Controllo creazione profili
Vista Log
Attività correlate
Avvio o collegamento di un processo Java
Utilizzo degli agenti
Apertura più prospettive Creazione profili e log
(C) Copyright IBM Corporation 2000, 2003. Tutti i diritti riservati.