JSnapshot provides two launch modes:
- Run with JSnapshot
- Debug with JSnapshot
Each launch mode offers a set launch types. Each type of launch configuration defines a group of tabs that collect and display information about the configuration. Each of these groups of launch configuration contains JSnapshot launch configuration tab.
JSnapshot launch configuration tab has two pages:
1. General page
The General page allows you to provide configuration for JSnapshot agent.
| Output Folder | Provide folder where you want snapshot files to be saved for this launch configuration. By default workspace plug-in metadata folder is selected.
Translates into output_folder command line option. |
| Output Size | Specify snapshot file size limit (in megabytes). JSnapshot agent will stop saving exception snapshots if size of snapshot file exceeds given size.
Translates into output_size command line option. |
| Port Number | Specify port number to be used by agent. Translates into port command line option. |
| Start recording when application starts | Select this option to start recording exception snapshots when application starts. Otherwise exception recording will be paused when application starts.
Translates into record command line option. |
| Maximum Object Depth | Specify maximum depth of object structure to save.
Translates into max_object_depth command line option. |
| Maximum Stack Frames | Specify maximum number of stack frames to save.
Translates into max_stack_frames command line option. |
| Group Similar Exceptions | Select this option to enable similar exception grouping. Exceptions are similar if they were thrown from the same location, were caught at the same location and have the same java class. Grouping means that only the first similar exception image is saved. For all other similar exceptions it saves their message and timestamp only.
Translates into group_similar_exceptions command line option. |
| Similar Stack Frames | Specifies number of stack frames for exception similarity criteria. Similar exceptions must have specified number of equal top stack frames. Otherwise exceptions are not similar.
Translates into group_similar_stack_frames command line option. |
| Maximum Time Interval | Specifies maximum time interval in seconds for exception similarity criteria. Time interval between similar exceptions must be less than specified one. Otherwise exceptions are not similar.
Translates into group_similar_threshold_seconds command line option. |
2. Filters page
The Filters page allows you to configure exception filtering for JSnapshot agent.
| Filter exceptions caught in in java.* classes. | Select this option to filter out exceptions that are caught in class defined in java.* packages.
Translates into filter_java command line option. |
| Filter exceptions caught in in sun.* classes. | Select this option to filter out exceptions that are caught in class defined in sun.* packages.
Translates into filter_sun command line option. |
| Exception filter table | Add exception filters to filter out exceptions which properties matches specified POSIX regular expression.
Translates into filter_catch, filter_throw, filter_exception_class and filter_exception_message command line options. |
Use Export Options... button to export options to the file and use them with JSnapshot agent in the headless mode.
Use Import Options... button to import options from the file.
JSnapshot launch configuration tab shows the size of all snapshot files saved for current launch configuration in the workspace plug-in metadata folder. You can delete saved snapshot files selectivly using Delete Snapshots... button.
