Command Line Export Executable

     


  The command line export executable can be used to export views from a saved snapshot. For more information please consult the overview.
  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 a .jps extension
        [global options] is a list of options in the format -option=value
        "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:
      -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.
      -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:
  * 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.
      -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.

  * 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.
      -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.
      -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.
      -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.

  * 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.
      -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.
      -filteredclasses=separately|addtocalling
          Selects if filtered classes should be shown separately or be added to
          the calling class. The default value is to show filtered classes
          separately.
      -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.
      -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.

  * 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.
      -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.
      -hotspottype=method|methodnofiltered|jdbc|jms|jndi|url
          Selects the hot spot type for the export. The default value is
          "method".
      -expandbacktraces=true|false
          Expand backtraces in HTML or XML format. The default value is "false".

  * 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".

  * 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.

  Examples of using the export executable are:
  jpexport test.jps TelemetryHeap heap.html

  jpexport test.jps RecordedObjects -aggregation=package -expandpackages=true objects.html

  jpexport test.jps -ignoreerrors=true -outputdir=/tmp/export
           RecordedObjects objects.csv
           AllocationTree -class=java.lang.String allocations.xml