Attachment #65139 for bug #166578

Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.




	the JVMPI-based Profiler. Instead of relying on VM-generated events for 
	monitoring application behavior (such as method entry and exit events, 
	object allocations and so on) it uses Byte Code Instrumentation (BCI) to 
	inject small pieces of code which track the application execution. This 
	technique allows for efficient monitoring of specific parts of the 
	application, without imposing a noticeable overhead on other parts of the 
	application that are not being monitored. This approach is easy to use 
	and scales well for large applications. </p>
	<h3>Execution Profile of an Application</h3>
	<p>The Java profiler can be used to profile any Eclipse Plugins, Eclipse RCP 

	(see <a href="#Profile_Drop_Down_Menu_">Figure</a>). This opens the profile 
	launch configuration window. </p>
	<blockquote>
		<p><b><a name="Profile_Drop_Down_Menu_">Profile Drop Down Menu</a></b><br>
		<p><img src="../images/img_prof_dr_dn.png" border="0"><br>
		</p>
		<b><a name="Profile_Drop_Down_Menu_">Profile Drop Down Menu</a></b></p>
	</blockquote>
	<p>&nbsp;<br>
	Perform the following steps:
	<ul>
		<li>Create a new launch item of type &quot;Java Application&quot;. 
		</li>
		<li>Select the &quot;Monitor&quot; tab from the profile launch configuration, as shown in
		<a href="#The_Profile_Launch_Configuration_">Figure</a>. <br>
		<br>
		<p><b><a name="The_Profile_Launch_Configuration_">The Profile Launch 
		Configuration</a></b><br>
		<img src="../images/img_prof_launch.png" border="0"><br>
		<br>
		</p>
		Configuration</a></b><br>
		&nbsp; </li>
	</ul>
	<h3>Object allocation analysis</h3>
	<p>To perform an Object Allocation analysis or Memory analysis (Heap), perform the following steps:
	your application, select &quot;Profile&quot; from the Profile drop down menu (see
	<a href="#img_prof_launch">Figure</a>). </p>
	<p>&nbsp;<br>
	Perform the following steps:
	<ul>
		<li>Profile your application by selecting &quot;Profile&quot; from the Profile drop down menu (see
	<a href="#Profile_Drop_Down_Menu_">Figure</a>). </li>
		<li>Select the &quot;Monitor&quot; tab from the profile launch configuration, as shown in
		<a href="#The_Profile_Launch_Configuration_">Figure</a>. 
		</li>
		<li>Click on Edit options to set any desired filter. 
		</li>

		Figure</a>). 
		</li>
		<li>If you would like to track the source of your object allocation, 
		click on Edit options and check the Track object allocation sites check 
		box.<br>
		<br>
		<p><b><a name="Select_Memory_Analysis">Select Memory Analysis</a></b><br>
		<img src="../images/img_mem_prof.png" border="0"><br>
		<br>
		</p>
		&nbsp; </li>
	</ul>
	
	Analysis</a></b><br>
	&nbsp; </p>
	<h3>Thread Profile of an Eclipse Application</h3>
	<p>To perform a thread profile of your application, select &quot;Profile&quot; from 
	the Profile drop down menu (see <a href="#Profile_Drop_Down_Menu_">Figure</a>).
	</p>
	<p>Perform the following steps:
	<ul>
		<li>Select the &quot;Monitor&quot; tab from the profile launch configuration, as shown in
		<a href="#The_Profile_Launch_Configuration_">Figure</a>. 
		</li>
		<li>Select &quot;Thread Analysis&quot; (see <a href="#Select_Thread_Analysis_">
		Figure</a>).
		<p><br><b><a name="Select_Thread_Analysis">Select Thread Analysis</a></b><br>
		<img src="../images/img_thrd_prof.png" border="0"><br>
		<br>
		</p>
		&nbsp; </li>
	</ul>
	<p>&nbsp;</p>
	<p>&nbsp;</p>

Return to bug 166578

Lines 82-91 Link Here

(-)org.eclipse.tptp.platform.doc.user/tasks/tefilter.htm (-22 / +25 lines)
82	the JVMPI-based Profiler. Instead of relying on VM-generated events for	82	the JVMPI-based Profiler. Instead of relying on VM-generated events for
83	monitoring application behavior (such as method entry and exit events,	83	monitoring application behavior (such as method entry and exit events,
84	object allocations and so on) it uses Byte Code Instrumentation (BCI) to	84	object allocations and so on) it uses Byte Code Instrumentation (BCI) to
85	inject small pieces of code which tracks the application execution. This	85	inject small pieces of code which track the application execution. This
86	technique allows for efficient monitoring of specific parts of the	86	technique allows for efficient monitoring of specific parts of the
87	application, without imposing a noticeable overhead on other parts of the	87	application, without imposing a noticeable overhead on other parts of the
88	application that are not being monitored. This approach is easy to use and	88	application that are not being monitored. This approach is easy to use
89	and scales well for large applications. </p>	89	and scales well for large applications. </p>
90	<h3>Execution Profile of an Application</h3>	90	<h3>Execution Profile of an Application</h3>
91	<p>The Java profiler can be used to profile any Eclipse Plugins, Eclipse RCP	91	<p>The Java profiler can be used to profile any Eclipse Plugins, Eclipse RCP
Lines 94-126 Link Here
94	(see <a href="#Profile_Drop_Down_Menu_">Figure</a>). This opens the profile	94	(see <a href="#Profile_Drop_Down_Menu_">Figure</a>). This opens the profile
95	launch configuration window. </p>	95	launch configuration window. </p>
96	<blockquote>	96	<blockquote>
		97	<p><b><a name="Profile_Drop_Down_Menu_">Profile Drop Down Menu</a></b><br>
97	<p><img src="../images/img_prof_dr_dn.png" border="0"><br>	98	<p><img src="../images/img_prof_dr_dn.png" border="0"><br>
98	<br>	99	</p>
99	<b><a name="Profile_Drop_Down_Menu_">Profile Drop Down Menu</a></b></p>
100	</blockquote>	100	</blockquote>
101	<p> <br>	101	<p> <br>
102	Perform the following steps:	102	Perform the following steps:
103	<ul>	103	<ul>
104	<li>Create a new launch item of type "Java Application".	104	<li>Create a new launch item of type "Java Application".
105	</li>	105	</li>
106	<li>Select the "Monitor" tab as shown in	106	<li>Select the "Monitor" tab from the profile launch configuration, as shown in
107	<a href="#The_Profile_Launch_Configuration_">Figure</a>. <br>	107	<a href="#The_Profile_Launch_Configuration_">Figure</a>. <br>
108	<br>	108	<br>
		109	<p><b><a name="The_Profile_Launch_Configuration_">The Profile Launch
		110	Configuration</a></b><br>
109	<img src="../images/img_prof_launch.png" border="0"><br>	111	<img src="../images/img_prof_launch.png" border="0"><br>
110	<br>	112	<br>
111	<b><a name="The_Profile_Launch_Configuration_">The Profile Launch	113	</p>
112	Configuration</a></b><br>
113	</li>	114	</li>
114	</ul>	115	</ul>
115	<h3>Object allocation analysis</h3>	116	<h3>Object allocation analysis</h3>
116	<p>To perform a Object Allocation analysis or Memory analysis (Heap) profile	117	<p>To perform an Object Allocation analysis or Memory analysis (Heap), perform the following steps:
117	your application, select "Profile" from the Profile drop down menu (see
118	<a href="#img_prof_launch">Figure</a>). </p>
119	<p> <br>
120	Perform the following steps:
121	<ul>	118	<ul>
122	<li>Select the "Monitor" tab as shown in	119	<li>Profile your application by selecting "Profile" from the Profile drop down menu (see
123	<a href="#Profile_Drop_Down_Menu_">Figure</a>.	120	<a href="#Profile_Drop_Down_Menu_">Figure</a>). </li>
		121	<li>Select the "Monitor" tab from the profile launch configuration, as shown in
		122	<a href="#The_Profile_Launch_Configuration_">Figure</a>.
124	</li>	123	</li>
125	<li>Click on Edit options to set any desired filter.	124	<li>Click on Edit options to set any desired filter.
126	</li>	125	</li>
Lines 128-155 Link Here
128	Figure</a>).	127	Figure</a>).
129	</li>	128	</li>
130	<li>If you would like to track the source of your object allocation,	129	<li>If you would like to track the source of your object allocation,
131	click on Edit options and check the object allocation tracking check	130	click on Edit options and check the Track object allocation sites check
132	box.<br>	131	box.<br>
133	<br>	132	<br>
		133	<p><b><a name="Select_Memory_Analysis">Select Memory Analysis</a></b><br>
134	<img src="../images/img_mem_prof.png" border="0"><br>	134	<img src="../images/img_mem_prof.png" border="0"><br>
		135	<br>
		136	</p>
135	</li>	137	</li>
136	</ul>	138	</ul>
137	<p><b>                <a name="Select_Memory_Analysis">Select Memory	139
138	Analysis</a></b><br>
139	</p>
140	<h3>Thread Profile of an Eclipse Application</h3>	140	<h3>Thread Profile of an Eclipse Application</h3>
141	<p>To perform a thread profile of your application, select "Profile" from	141	<p>To perform a thread profile of your application, select "Profile" from
142	the Profile drop down menu (see <a href="#Profile_Drop_Down_Menu_">Figure</a>).	142	the Profile drop down menu (see <a href="#Profile_Drop_Down_Menu_">Figure</a>).
143	</p>	143	</p>
144	<p>Perform the following steps:	144	<p>Perform the following steps:
145	<ul>	145	<ul>
146	<li>Select the "Monitor" tab as shown in	146	<li>Select the "Monitor" tab from the profile launch configuration, as shown in
147	<a href="#Profile_Drop_Down_Menu_">Figure</a>.	147	<a href="#The_Profile_Launch_Configuration_">Figure</a>.
148	</li>	148	</li>
149	<li>Select "Thread Analysis" (see <a href="#Select_Thread_Analysis_">	149	<li>Select "Thread Analysis" (see <a href="#Select_Thread_Analysis_">
150	Figure</a>).<br>	150	Figure</a>).
		151	<p><br><b><a name="Select_Thread_Analysis">Select Thread Analysis</a></b><br>
		152	<img src="../images/img_thrd_prof.png" border="0"><br>
151	<br>	153	<br>
152	<img src="../images/img_thrd_prof.png" border="0"> </li>	154	</p>
		155	</li>
153	</ul>	156	</ul>
154	<p> </p>	157	<p> </p>
155	<p> </p>	158	<p> </p>