Fetch Statistics

The OpenJPA Fetch Statistics Tool (FST) monitors persistent field access and helps determine which fields in an application are not used. This tool is a development / test time tool that can help a developer properly tune an application.

Note

• Currently, FST only works with runtime enhancement (javaagent or in JEE container hook).

• The persistent fields which satisfy all the following conditions will be tracked :
  • The field is fetched eagerly.
  • The field is not a primary key.
  • The field is not defined as a version field.

Download

The latest OpenJPA FST jar file can be download from the SNAPSHOT Repository or can be built from the source code in svn by using Maven 2.2.1 and Java SE 6.

Configuration

• JSE - Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar file to the classpath prior to lanuching the JVM.
• Websphere Application Server
• OSGi – ?? – Probably need another module that creates a proper bundle.

Statistics Collecting and Monitoring

• When this tool is configured, it will be active for all persistence units in the JVM. Statistics will be dumped via the openjpa.Runtime channel with the INFO level every 10 minutes, or when the JVM terminates.

Configuration removal

• Stop the JVM and reverse the steps completed to configure the tool.