1. Sookmyung Women’s Univ. PSLAB
AdaptJ
Sookmyung Women’s Univ.
PSLAB

2. 1. 목차 1. Overview 2. Collecting Trace Data using the AdaptJ Agent
2.1 Recording a Trace
3. Analyzing Trace Data using AdaptJ Trace Analyzer
3.1 Overview
3.2 The Command-Line Interface
3.3 Dependencies

3. 1. OverView(1) two primary purposes: two main goals
To facilitate the collection of dynamic data concerning the execution of a Java program
To provide a framework for implementing analyses of this collected data quickly and easily
two main goals
The AdaptJ Agent :to collect event trace data
The AdaptJ Trace Analyzer : to read and analyze the traces generated by the agent
fa cil i tate [f síl tèit] vt. 1 <일을> 용이하게 하다; 쉽게 하다; 촉진[조장]하다

4. 2. Collecting Trace Data using the AdaptJ Agent
Java Virtual Machine via the Java Virtual Machine Profiler Interface (JVMPI).
to record various types of events
Sun’s hprof profiler
Another program which uses the JVMPI is Sun’s hprof profiler
The AdaptJ Agent is designed
to record events
The agent accepts a number of command line parameters
via [vái , ví ] 【L 「길」의 뜻에서】 prep. 1 ···을 거쳐, ···을 경유하여(by way of)

5. The AdaptJ agent should then respond with the following message:
AdaptJ Agent Options
===================
file=<output_file> Specifies the name of the output file.
Defaults to "AdaptJ.dat"
events=<event_char>+ Specifies the events to be recorded
counters=<event_char>+ Specifies the events to be counted
Usage "help=events" to get a list of event chars
split=<size> Specifies the threshold at which a new file is to be started
gc=<size> Specifies at which interval to force garbage collection
<size> is a number, optionally followed by one of ’k’, ’m’
or ’g’, which stand for ’kilobytes’, ’megabytes’ and
’gigabytes’, respectively. THIS FEATURE IS CURRENTLY BROKEN.
pipe Output data to a named piped instead of a regular file
quiet Turns off agent messages
opt Attempts to reduce the size of the trace file by using
compression techniques
cp=<path1>+ Specifies the classpath to use for resolving classes
cp+=<path1>+ Specifies the classpath to use for resolving classes.
The value of the environment variable CLASSPATH is append to
the specified list
help[=events] Prints this help message. If ’events’ is specified, a list
of event chars is output

6. AdaptJ should display the following message: AdaptJ Event Mappings
====================
JVMPI_EVENT_ARENA_DELETE A
JVMPI_EVENT_ARENA_NEW a
JVMPI_EVENT_CLASS_LOAD c
JVMPI_EVENT_CLASS_LOAD_HOOK k
JVMPI_EVENT_CLASS_UNLOAD C
JVMPI_EVENT_COMPILED_METHOD_LOAD l
Example
want to record the Class Load events and the Method Entry Events.
These correspond to ’c’ and ’b’, respectively. Therefore, we would type the following to invoke the agent:
$ java -XrunAdaptJ:events=cb AdaptJTest

7. 3. 1 Overview Event Operation Pack : grouping of operation
Events are read from the trace, they are successively passed to a sequence of chained operations.
Operation
modify the contents of an event
Replace completely a different event
Stop the processing chain
-> act as a filter for the subsequent operations in the chain
Pack : grouping of operation
Help organize the various operations
Facilitate their configuration
Contain other pack or operation

8. 3. 2 The Command-line interface
Usage and Option
Usage : java adaptj.Main [option] <trace file>
Option
-q, --quiet : set the quiet mode (m,w,e,0,1,2,3)
-v, --verbose : enables verbose mode
-- version : print the version and exits
--no-gui : disables the graphical progress indicator
-x, --all-off : turns off all operations
-f, --file : read arguments from a file
-r, --refresh-rate :set the amount of time between GUI update
--pipe : forces to read input as if from a pipe
--show-hierarchy : displays the package/operation hierarchy
-t, --time : prints time statistics
--showver : prints the version and continues
-p : set of option for a pack/operation
-cp, --classpath : manipulates the classpath use by AdaptJ
-h, --help : prints help and exits

9. 3. 3 Dependencies
AdaptJ requires every operation to explicitly state two kinds of dependencies
Event dependencies
Which event the operation absolutely requires in order to be able to perform its task
Which event it would like to receive if they are available
Operation dependencies
Which operations in the AdaptJ toolkit provide service for a given application