Chat now with support
Chat with Support

Foglight for Java EE Technologies 5.9.10 - Installation Guide

Installing and Configuring Foglight for Java EE Technologies Integrating with JBoss Integrating with Apache Tomcat Integrating with WebLogic Domain Startup Scripts Integrating with WebSphere Integrating with WebSphere Liberty Integrating with Oracle AS Creating a Generic Installation for Manual Java EE Agent Integration Managing Java EE Agent Installations, Integrations, and Configurations Managing Java EE Agent Configurations Managing Java EE Installation Java EE Integration Configuration FAQ and Troubleshooting Manually Integrating Application Server Appendix A: Java EE Application Methods AppendixB: Managing Permissions for the Java EE Integration Agent

Changing custom component callbacks settings

Use the Custom Component Callbacks setting to specify the classes or interfaces that the custom components use to call customer written code. The default instrumentation settings include some custom component callbacks for Apache Struts and Spring.
* 
NOTE: This setting is only valid for Full Detail and Component Detail Instrumentation Levels. Changing its value has no effect if the instrumentation level is Basic Detail or No Detail. For information about instrumentation levels, see Changing the instrumentation level for Request Metric data collection .
For more information, see Appendix: Java EE Application Methods.
Figure 2. Default custom component callback settings
To add custom component callbacks:
* 
TIP: To review how to access the instrumentation settings editor, see Editing agent instrumentation configurations .
1
On the General tab of the Edit dialog box, click Edit beside CustomComponentCallbacks.
2
In the Settings Editor, you can add, remove, or change the order of callbacks.
Click Add to add a single class at a time.
Click Add multiple to open a text box where you can type several classes.
3
After you have added as many classes as you want, click OK.
4
In the Edit dialog box, click Save.
5
Restart your application server.
Manual configuration — CustomComponentCallbacks
If you manually edit the instrumentation.config file, use the following syntax to specify custom component callback instrumentation.
CustomComponentCallbacks = ClassList (
# Apache Struts 1.x
include "org.apache.struts.action.Action",
include "org.apache.struts.action.ActionForm",
include "org.apache.struts.action.ExceptionHandler",
);

Customizing Long Running Methods

Use the LongRunningUserMethods setting to customize the collection of performance data from methods that run over a long period of time. By default, the Java EE agent waits for a method to finish running before treating the collected data as complete. However, for methods such as the run() method of a background thread or other methods that run over a long period of time, it may be preferable to treat the data as complete at specific points in the code. This makes the data available in small pieces as the method runs instead of as one large piece when the long running method completes. Changing any of these settings can have performance implications.
The Java EE agent pauses at waypoint methods (LongRunningUserMethodWaypoints) to treat the data as complete before continuing. For best performance, use a minimal set of waypoint methods.
* 
NOTE: This setting is only valid for Full Detail and Component Detail Instrumentation Levels. Changing its value has no effect if the instrumentation level is Basic Detail or No Detail. For information about instrumentation levels, see Changing the instrumentation level for Request Metric data collection .
To add long running user methods:
* 
TIP: To review how to access the instrumentation settings editor, see Editing agent instrumentation configurations .
1
Click the Long Running Methods tab of the Edit dialog box.
2
To add long running methods, click Edit beside LongRunningUserMethods.
3
In the Settings Editor, you can add, remove, or change the order of long running methods.
Click Add to add a single method at a time.
Click Add multiple to open a text box where you can type several methods.
For example, to measure each execution through a loop in a long running run() method, add the method: com.globex.plan.DominateWorldThread.run.
4
After you have added as many methods as you want, click OK.
5
Next, add one or more waypoints.
If you do not want to add any waypoints, in the Edit dialog box, click Save. Restart your application servers.
To add long running user method waypoints:
1
On the Long Running Methods tab of the Edit dialog box, click Edit beside LongRunningUserMethodWaypoints.
2
In the Settings Editor, you can add, remove, or change the order of long running method waypoints.
Click Add to add a single waypoint at a time.
For example, add the waypoint com.globex.plan.DominateWorldThread.executeProjectArcturus to the com.globex.plan.DominateWorldThread.run method from the previous procedure.
Each time the method executeProjectArcturus() is called from run() it is considered a single request.
3
After you have added as many methods as you want, click OK.
4
In the Edit dialog box, click Save.
5
Restart your application server.
Manual configuration — LongRunningUserMethods
If you manually edit the instrumentation.config file, use the following syntax to specify long running user methods and waypoints instrumentation.
LongRunningUserMethods = MethodList(
include "com.globex.plan.DominateWorldThread.run"
);
LongRunningUserMethodWaypoints = MethodList(
include "com.globex.plan.DominateWorldThread.executeProjectArcturus"
);
In this case, the method "com.globex.plan.DominateWorldThread.run" treats the data as complete each time the method executeProjectArcturus() is called from run(). The Java EE agent pauses at waypoint methods to treat the data as complete before continuing. A minimal set of waypoint methods allows for the best possible performance.

Named Methods settings

The Named Methods instrumentation settings determine how the agent tracks specific methods. Changing any of these settings can have performance implications. Review the provided information before changing any settings.
•
Changing Named Methods settings
•
Changing the Maximum Number of Methods Tracked

Changing Named Methods settings

The NamedMethods setting for a Java EE agent is used to track specific methods. Specify the names of methods by forming a regular expression that matches the name or pattern. The method signature can be specified but it must be specified using the internal JVM format, as in the "DominateWorld" example below. For more information, see http://docs.oracle.com/javase/specs/#7035.
The JVM format for constructors may not be as expected. For example, for the constructor: com.quest.controller.AuthenticateAdmin.AuthenticateAdmin(), the correct signature to specify would be: com.quest.controller.AuthenticateAdmin.<init>().
* 
NOTE: This setting is only valid for Full Detail and Component Detail Instrumentation Levels. Changing this value has no effect if the Instrumentation Level is set to Basic Detail or No Detail. For more information about setting instrumentation levels, see “Configuring instrumented simple method settings .
To add named methods:
* 
TIP: To review how to access the instrumentation settings editor, see Editing agent instrumentation configurations .
1
Click the Named Methods tab of the Edit dialog box.
2
To add named methods, click Edit beside NamedMethods.
3
In the Settings Editor that opens, you can add, remove, or change the order of named methods.
Click Add named method to define a named method.
4
In the dialog box that opens, type the method name in the Specify a name box.
5
Click OK.
6
Add one or more methods to the named method list.
Click Add to add a single method at a time.
Click Add multiple to open a text box where you can type several methods.
7
After you have added as many named methods as you want, click OK.
The Edit dialog box refreshes and displays the list of methods you added.
8
In the Edit dialog box, click Save.
9
Restart your application servers.
Next, specify the maximum number of named methods to track, as described in Changing the Maximum Number of Methods Tracked .
Manual configuration — NamedMethods
If you manually edit the instrumentation.config file, use the following syntax to specify named method instrumentation.
NamedMethods = {};
For example:
NamedMethods = {
"TakeOver": MethodList(
include /com\.globex\.takeover\..*/
),
"DominateWorld": MethodList(
include "com.globex.plan.DominateWorldServlet.doGet(Ljavax/servlet/http/HttpServletRequest;Ljavax/servlet/http/HttpServletResponse;)V",
include "com.globex.plan.DominateWorldHelper.dominate(Ljava/lang/String;Z[B)I",
),
"Globex": MethodList(
include "com.globex.pocket.Sugar",
include "com.globex.cypresscreek.HammockHut.sit",
exclude /(\.|^)globex\./
)
};
For more information about how to monitor specific methods, see the Monitoring Methods topic, in the Foglight for Application Servers User Guide.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating