 |
The export executable is named jpexport.exe on Windows and jpexport
on Unix-based operating systems and is located in the bin directory of
a JProfiler installation. If you execute it with the -help option, you will
get help on the available view names and view options:
Usage: jpexport "snapshot file" [global options]
"view name" [options] "output file"
"view name" [options] "output file" ...
where "snapshot file" is a snapshot file with one of the extensions:
.jps, .hprof, .hpz, .phd
"view name" is one of the view names listed below
[options] is a list of options in the format -option=value
"output file" is the output file for the export
Global options:
-obfuscator=none|proguard|yguard
Deobfuscate for the selected obfuscator. Defaults to "none", for other
values the mappingFile option has to be specified.
-mappingfile=[file]
The mapping file for the selected obfuscator.
-outputdir=[output directory]
Base directory to be used when the output file for a view is a
relative file.
-ignoreerrors=true|false
Ignore errors that occur when options for a view cannot be set and
continue with the next view. The default value is "false", i.e. the
export is terminated, when the first error occurs.
-csvseparator=[separator character]
The field separator character for the CSV exports. Defaults to ','.
-session=[session id]
An alternate session from which the view settings should be taken. The
session id can be found in the application settings next to the
session name. By default, the view settings are taken from the session
that is embedded inside the snapshot file.
Available view names and options:
* TelemetryHeap
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* TelemetryObjects
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* TelemetryThroughput
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* TelemetryGC
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* TelemetryClasses
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* TelemetryThreads
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* TelemetryCPU
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* Bookmarks
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
* AllObjects
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals
Sets the view filter mode. The default value is contains.
-viewfilteroptions=casesensitive
Boolean options for the view filter. By default, no options are set.
-aggregation=class|package|component
Selects the aggregation level for the export. The default value is
classes.
-expandpackages=true|false
Expand package nodes in the package aggregation level to show
contained classes. The default value is "false". Has no effect for
other aggregation levels and with csv output format.
* RecordedObjects
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals
Sets the view filter mode. The default value is contains.
-viewfilteroptions=casesensitive
Boolean options for the view filter. By default, no options are set.
-aggregation=class|package|component
Selects the aggregation level for the export. The default value is
classes.
-expandpackages=true|false
Expand package nodes in the package aggregation level to show
contained classes. The default value is "false". Has no effect for
other aggregation levels and with csv output format.
-liveness=live|gc|all
Selects the liveness mode for the export, i.e. whether to display live
objects, garbage collected objects or both. The default value is live
objects.
* AllocationTree
options:
-format=html|xml
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals
Sets the view filter mode. The default value is contains.
-viewfilteroptions=casesensitive
Boolean options for the view filter. By default, no options are set.
-aggregation=method|class|package|component
Selects the aggregation level for the export. The default value is
methods.
-viewmode=tree|treemap
Selects the view mode for the export. The default value is "tree".
-width=[number of pixels]
Minimum width of the tree map in pixels. The default value is 800.
Only relevant if "viewmode" is set to "tree".
-height=[number of pixels]
Minimum height of the tree map in pixels. The default value is 600.
Only relevant if "viewmode" is set to "tree".
-class=[fully qualified class name]
Specifies the class for which the allocation data should be
calculated. If empty, allocations of all classes will be shown. Cannot
be used together with the package option.
-package=[fully qualified package name]
Specifies the package for which the allocation data should be
calculated. If empty, allocations of all packages will be shown.
Cannot be used together with the class option.
-liveness=live|gc|all
Selects the liveness mode for the export, i.e. whether to display live
objects, garbage collected objects or both. The default value is live
objects.
* AllocationHotSpots
options:
-format=html|csv|xml
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals
Sets the view filter mode. The default value is contains.
-viewfilteroptions=casesensitive
Boolean options for the view filter. By default, no options are set.
-aggregation=method|class|package|component
Selects the aggregation level for the export. The default value is
methods.
-class=[fully qualified class name]
Specifies the class for which the allocation data should be
calculated. If empty, allocations of all classes will be shown. Cannot
be used together with the package option.
-package=[fully qualified package name]
Specifies the package for which the allocation data should be
calculated. If empty, allocations of all packages will be shown.
Cannot be used together with the class option.
-liveness=live|gc|all
Selects the liveness mode for the export, i.e. whether to display live
objects, garbage collected objects or both. The default value is live
objects.
-unprofiledclasses=separately|addtocalling
Selects if unprofiled classes should be shown separately or be added
to the calling class. The default value is to show unprofiled classes
separately.
-valuesummation=self|total
Determines how the times for hot spots are calculated. Defaults to
"self".
-expandbacktraces=true|false
Expand backtraces in HTML or XML format. The default value is "false".
* ClassTracker
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* CallTree
options:
-format=html|xml
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals
Sets the view filter mode. The default value is contains.
-viewfilteroptions=casesensitive
Boolean options for the view filter. By default, no options are set.
-aggregation=method|class|package|component
Selects the aggregation level for the export. The default value is
methods.
-viewmode=tree|treemap
Selects the view mode for the export. The default value is "tree".
-width=[number of pixels]
Minimum width of the tree map in pixels. The default value is 800.
Only relevant if "viewmode" is set to "tree".
-height=[number of pixels]
Minimum height of the tree map in pixels. The default value is 600.
Only relevant if "viewmode" is set to "tree".
-threadgroup=[name of thread group]
Selects the thread group for the export. If you specify thread as well
, the thread will only be searched in this thread group, otherwise the
entire thread group will be shown.
-thread=[name of thread]
Selects the thread for the export. By default, the call tree is merged
for all threads.
-threadstatus=all|running|waiting|blocking|netio
Selects the thread status for the export. The default value is the
runnable state.
* HotSpots
options:
-format=html|csv|xml
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals
Sets the view filter mode. The default value is contains.
-viewfilteroptions=casesensitive
Boolean options for the view filter. By default, no options are set.
-aggregation=method|class|package|component
Selects the aggregation level for the export. The default value is
methods.
-threadgroup=[name of thread group]
Selects the thread group for the export. If you specify thread as well
, the thread will only be searched in this thread group, otherwise the
entire thread group will be shown.
-thread=[name of thread]
Selects the thread for the export. By default, the call tree is merged
for all threads.
-threadstatus=all|running|waiting|blocking|netio
Selects the thread status for the export. The default value is the
runnable state.
-expandbacktraces=true|false
Expand backtraces in HTML or XML format. The default value is "false".
-unprofiledclasses=separately|addtocalling
Selects if unprofiled classes should be shown separately or be added
to the calling class. The default value is to show unprofiled classes
separately.
-valuesummation=self|total
Determines how the times for hot spots are calculated. Defaults to
"self".
* MethodStatistics
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-threadstatus=all|running|waiting|blocking|netio
Selects the thread status for the export. The default value is the
runnable state.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals
Sets the view filter mode. The default value is contains.
-viewfilteroptions=casesensitive
Boolean options for the view filter. By default, no options are set.
* Complexity
options:
-format=html|csv|properties
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-fit=best|constant|linear|quadratic|cubic|exponential|logarithmic|n_log_n
The fit that should be exported. The default value is "best". No curve
fitting data is exported to CSV.
-method=[method name]
The method name for which the complexity graph should be exported. If
not given, the first method will be exported. Otherwise, the first
method name that starts with the given text will be exported.
-width=[number of pixels]
Minimum width of the graph in pixels. The default value is 800.
-height=[number of pixels]
Minimum height of the graph in pixels. The default value is 600.
* ThreadHistory
options:
-format=html
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* ThreadMonitor
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
* CurrentMonitorUsage
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
* MonitorUsageHistory
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
* MonitorUsageStatistics
options:
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-type=monitors|threads|classes
Selects the entity for which the monitor statistics should be
calculated. The default value is "monitors".
* ProbeTimeLine
options:
-probeid=[id]
The internal ID of the probe that should be exported. Run "jpexport
--listProbes" to list all available built-in probes and for an
explanation of custom probe names.
-format=html
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* ProbeControlObjects
options:
-probeid=[id]
The internal ID of the probe that should be exported. Run "jpexport
--listProbes" to list all available built-in probes and for an
explanation of custom probe names.
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
* ProbeCallTree
options:
-probeid=[id]
The internal ID of the probe that should be exported. Run "jpexport
--listProbes" to list all available built-in probes and for an
explanation of custom probe names.
-format=html|xml
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals|wildcard|regex
Sets the view filter mode. The default value is contains.
-viewfilteroptions=exclude,casesensitive
Boolean options for the view filter. By default, no options are set.
-aggregation=method|class|package|component
Selects the aggregation level for the export. The default value is
methods.
-viewmode=tree|treemap
Selects the view mode for the export. The default value is "tree".
-width=[number of pixels]
Minimum width of the tree map in pixels. The default value is 800.
Only relevant if "viewmode" is set to "tree".
-height=[number of pixels]
Minimum height of the tree map in pixels. The default value is 600.
Only relevant if "viewmode" is set to "tree".
-threadgroup=[name of thread group]
Selects the thread group for the export. If you specify thread as well
, the thread will only be searched in this thread group, otherwise the
entire thread group will be shown.
-thread=[name of thread]
Selects the thread for the export. By default, the call tree is merged
for all threads.
-threadstatus=all|running|waiting|blocking|netio
Selects the thread status for the export. The default value is the
runnable state.
* ProbeHotSpots
options:
-probeid=[id]
The internal ID of the probe that should be exported. Run "jpexport
--listProbes" to list all available built-in probes and for an
explanation of custom probe names.
-format=html|csv|xml
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-viewfilters=[comma-separated list]
Sets view filters for the export. If you set view filters, only the
specified packages and their sub-packages will be displayed by the
exported view.
-viewfiltermode=startswith|endswith|contains|equals|wildcard|regex
Sets the view filter mode. The default value is contains.
-viewfilteroptions=exclude,casesensitive
Boolean options for the view filter. By default, no options are set.
-aggregation=method|class|package|component
Selects the aggregation level for the export. The default value is
methods.
-threadgroup=[name of thread group]
Selects the thread group for the export. If you specify thread as well
, the thread will only be searched in this thread group, otherwise the
entire thread group will be shown.
-thread=[name of thread]
Selects the thread for the export. By default, the call tree is merged
for all threads.
-threadstatus=all|running|waiting|blocking|netio
Selects the thread status for the export. The default value is the
runnable state.
-expandbacktraces=true|false
Expand backtraces in HTML or XML format. The default value is "false".
* ProbeTelemetry
options:
-probeid=[id]
The internal ID of the probe that should be exported. Run "jpexport
--listProbes" to list all available built-in probes and for an
explanation of custom probe names.
-telemetrygroup
Sets the one-based index of the telemetry group that should be
exported. This refers to the the entries that you see in the drop-down
list above the probe telemetry view. The default value is "1".
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
* ProbeEvents
options:
-probeid=[id]
The internal ID of the probe that should be exported. Run "jpexport
--listProbes" to list all available built-in probes and for an
explanation of custom probe names.
-format=html|csv|xml
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
* ProbeTracker
options:
-probeid=[id]
The internal ID of the probe that should be exported. Run "jpexport
--listProbes" to list all available built-in probes and for an
explanation of custom probe names.
-format=html|csv
Determines the output format of the exported file. If not present, the
export format will be determined from the extension of the output
file.
-minwidth=[number of pixels]
Minimum width of the graph window in pixels. The default value is 800.
-minheight=[number of pixels]
Minimum height of the graph window in pixels. The default value is
600.
-index=[number]
Sets the zero-based index of the drop-down list that contains the
tracked elements. The default value is 0.
|