openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] OpenJPA > Fetching Statistics
Date Tue, 10 Jul 2012 16:17:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2042/9/5/_/styles/combined.css?spaceKey=openjpa&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/openjpa/Fetching+Statistics">Fetching
Statistics</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~helenxu">Helen
Xu</a>
    </h4>
        <br/>
                         <h4>Changes (19)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h1.
Fetching Statistics <br> <br></td></tr>
            <tr><td class="diff-unchanged" >Open JPA Fetch Statistics Tool monitors
persistent field access and determines which fields are never used. This tool <br>can
be used to help tune an application.  <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Note:
Open JPA Fetching Statistics Tool works with the runtime enhancement. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
Download <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Usage
instructions:  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">The
latest OpenJPA Tools JAR file can be download from the [SNAPSHOT Repository|https://repository.apache.org/content/repositories/snapshots/org/apache/openjpa/tools/openjpa-tools]
or can be built from the source code in [svn|https://svn.apache.org/repos/asf/openjpa/tools/trunk]
by using Maven 2.2.1 and Java SE 6. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
Usage <br> <br>bq. This description assumes your application is running the on
same machine as JConsole and application JVM matches the JConsole JVM. <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">1.]</span>
<span class="diff-added-words"style="background-color: #dfd;">#</span> Configuration
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">*</span>
Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar file to the classpath prior
to lanuching the JVM. <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">2.]</span>
<span class="diff-added-words"style="background-color: #dfd;">#</span> Statistics
Collecting and Monitoring <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">*</span>
When this tool is configured, it will be active for all persistence units in the JVM. Statistics
will be dumped via the <br></td></tr>
            <tr><td class="diff-changed-lines" >openjpa.Runtime channel with the
INFO level every 10 minutes, or when the JVM terminates. Any <span class="diff-added-words"style="background-color:
#dfd;">EAGER</span> field that is logged <br></td></tr>
            <tr><td class="diff-unchanged" >  has not been accessed by an application.
<br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">3.]</span>
<span class="diff-added-words"style="background-color: #dfd;">#</span> Configuration
removal <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">*</span>
Stop the JVM. <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">*</span>
Remove openjpa-fetch-statistics-version-SNAPSHOT.jar from the classpath. <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">
<br>Performance Consideration <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">#
If all goes well, at this point you should see a tab labeled DataCache-\[pu_name\]-\[n\] <br>
 !screen.jpg|thumbnail,border=1! <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
Performance Consideration <br> <br></td></tr>
            <tr><td class="diff-unchanged" >There will be a large performance
impact when running this tooling. It is not supported, nor recommended for production <br>use.
This tool should not be used on a production machine. <br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <h1><a name="FetchingStatistics-FetchingStatistics"></a>Fetching
Statistics</h1>

<p>Open JPA Fetch Statistics Tool monitors persistent field access and determines which
fields are never used. This tool<br/>
can be used to help tune an application. </p>

<h3><a name="FetchingStatistics-Download"></a>Download</h3>

<p>The latest OpenJPA Tools JAR file can be download from the <a href="https://repository.apache.org/content/repositories/snapshots/org/apache/openjpa/tools/openjpa-tools"
class="external-link" rel="nofollow">SNAPSHOT Repository</a> or can be built from
the source code in <a href="https://svn.apache.org/repos/asf/openjpa/tools/trunk" class="external-link"
rel="nofollow">svn</a> by using Maven 2.2.1 and Java SE 6.</p>

<h3><a name="FetchingStatistics-Usage"></a>Usage</h3>

<blockquote><p>This description assumes your application is running the on same
machine as JConsole and application JVM matches the JConsole JVM.</p></blockquote>

<ol>
	<li>Configuration<br/>
  Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar file to the classpath prior
to lanuching the JVM.</li>
	<li>Statistics Collecting and Monitoring<br/>
  When this tool is configured, it will be active for all persistence units in the JVM. Statistics
will be dumped via the <br/>
  openjpa.Runtime channel with the INFO level every 10 minutes, or when the JVM terminates.
Any EAGER field that is logged <br/>
  has not been accessed by an application.</li>
	<li>Configuration removal<br/>
  Stop the JVM.<br/>
  Remove openjpa-fetch-statistics-version-SNAPSHOT.jar from the classpath.</li>
	<li>If all goes well, at this point you should see a tab labeled DataCache-[pu_name]-[n]<br/>
  <span class="error">Unable to render embedded object: File (screen.jpg) not found.</span></li>
</ol>


<h3><a name="FetchingStatistics-PerformanceConsideration"></a>Performance
Consideration</h3>

<p>There will be a large performance impact when running this tooling. It is not supported,
nor recommended for production<br/>
use. This tool should not be used on a production machine.</p>
    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/openjpa/Fetching+Statistics">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=29131113&revisedVersion=2&originalVersion=1">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/openjpa/Fetching+Statistics?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message