Configura il profiler Java YourKit

Come si configura il profiler Java YourKit per l'utilizzo con CQ3.x o CQ4.x?

Soluzione

Installa YourKit

Abilita il profiling

È possibile abilitare il profiling direttamente in un server IDE o anche J2EE. Tuttavia, è preferibile abilitare il profiling manuale per essere indipendente dai server IDE o J2EE. La procedura varia a seconda del sistema operativo.

Controlla l'agente del profiler

Per verificare che Java possa caricare l'agente del profiler, puoi richiamare il seguente comando che stampa una descrizione dei parametri dell'agente:

• Java 5 o 6
  • java -agentlib:yjpagent=help

• Java 1.3 o 1.4
  • java -Xrunyjpagent:help

Integra la libreria dell'agente nell'applicazione

Per eseguire il profiling di un'applicazione Java, è necessario fornire allo strumento YourKit un'interfaccia all'applicazione Java. Integra la libreria dell'agente YourKit nella JVM dove è in esecuzione l'applicazione target di cui desideri eseguire il profiling. In primo luogo, abilita il profiling fornendo il percorso della libreria dell'agente del sistema operativo rispettivo su cui è in esecuzione la JVM (vedi Abilitazione del profiling). Includi l'impostazione delle variabili d'ambiente nello script iniziale dell'applicazione.

Per esempio, in uno script di avvio CQ in Linux, procedi come segue:

#--------------------------------------------------------------------- # enables the YourKit Java Profiler #--------------------------------------------------------------------- YJP_HOME="/home/honwai/yjp-6.0.16/bin/linux-x86-32" export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$YJP_HOME

Questa impostazione mette a disposizione della JVM la libreria dell'agente. Ora si tratta di comunicare alla JVM di integrare effettivamente questa libreria, che differisce a seconda della versione di JVM in uso:

Ora puoi iniziare la tua applicazione e il profiling vero e proprio. La libreria dell'agente stampa alcune informazioni sull'output standard (nel caso di CQ è server(logs/startup.log):

[YourKit Java Profiler 6.0.16] Usando JVMPI (Linux; 32 bit JVM)

[YourKit Java Profiler 6.0.16] *** SUGGERIMENTO ***: Usa Java 5 (or più recenti) se possibile!

[YourKit Java Profiler 6.0.16] L'agente del profiler è in ascolto sulla porta 10001...

Suggerimento: In CQ 4.2, lo script serverctl è diventato più avanzato, permettendo di fornire varie opzioni all'avvio. Include l'opzione per avviare la JVM con la libreria dell'agente YourKit. L'impostazione delle variabili env sopra descritte è ancora obbligatoria, ma l'impostazione dell'opzione aggiuntiva JVM non lo è:

linuxbox:/opt/day/cq-4.2/server# ./start --profile

Per ottenere un elenco completo delle opzioni disponibili, digita ./serverctl e otterrai un elenco di tutte le opzioni disponibili.

Connessione all'applicazione con il profiler YourKit

Quando si avvia un'applicazione con il profiler abilitato, la libreria agente sceglie una porta libera disponibile sul sistema. Non è necessario conoscere la porta. Lo strumento YourKit può connettersi automaticamente a un'applicazione in esecuzione di cui hai eseguito il profiling, sia localmente che da remoto. Se trova più di un'applicazione, ti viene richiesto di selezionarne una.

È anche possibile specificare una porta dedicata se le impostazioni di sicurezza locali (ad esempio, un firewall) non consentono di scegliere porte arbitrarie. Vedi la seguente tabella per un elenco completo delle opzioni che possono essere passate alla libreria dell'agente.

Opzioni della libreria dell'agente

Separa le varie opzioni con delle virgole. Attenzione, Java richiede : after -Xrunyjpagent but = after -agentlib:yjpagent.

Esempi (Java 5 o successivi):

java -agentlib:yjpagent FooClass java -agentlib:yjpagent=onexit=memory,dir=c:\MySnapshots FooClass java -agentlib:yjpagent=usedmem=70 FooClass

Esempi (Java 1.3/1.4):

java -Xrunyjpagent FooClass java -Xrunyjpagent:onexit=memory,dir=c:\MySnapshots FooClass java -Xrunyjpagent:usedmem=70 FooClass

Documentazione

Una volta installato il profiler YourKit, un'ampia documentazione HTML è presente nella directory di installazione, in <!YourKit Java Profiler Home>/docs/help/index.html. Spiega in dettaglio come integrare la libreria dell'agente sull'applicazione target oggetto del profiling. Fornisce anche molte opzioni utili che possono essere passate all'agente. Ad esempio:

• genera un heap-dump una volta che l'applicazione esce
• genera un heap-dump una volta che una certa soglia è stata raggiunta

Queste opzioni si trovano in <!YourKit Java Profiler Home>/docs/help/agent.html.

L'attuale versione 7.0 non viene fornita con la documentazione, puoi trovarla sul nostro server di installazione:

• \\setup\install\profiling\yjp-6.0\docs\help\index.html