Chat now with support
Chat with Support

Foglight for Java EE Technologies 5.9.13 - 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 Integrating with Spring Boot for Embedded Tomcat 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

Requests settings

The Requests instrumentation settings for a Java EE agent determine how the agent splits requests based on methods. Changing any of these settings can have performance implications. Review the provided information before changing any settings.

Setting the Maximum Request Fragment cache size

In the period between requests, the Java EE agent caches the data structures used to collect the data for request fragments. The MaxRequestFragmentCacheSize setting determines the maximum number of request fragments that are stored in the cache. The default value is 50. Set the value to zero (0) to disable the cache.

1
Click the Requests tab of the Edit dialog box.
2
Type a value in the MaxRequestFragmentCacheSize box.
3
Click Save.

If you manually edit the instrumentation.config file, use the following syntax to specify the maximum request fragment cache size.

MaxRequestFragmentCacheSize = 50;

Setting the Request Recursion Limit

The RecursionLimit configuration setting adjusts the number of recursive calls for which the Java EE agent collects detailed performance information. Beyond this number, the Java EE agent collects and aggregates timing information for the entire recursive sequence.

If you need to see more detail for each method call in a recursive sequence, you can increase this value. Set the value to zero (0) to see only the first method call, but none of the recursive calls. The default value is 5.

1
Click the Requests tab of the Edit dialog box.
2
Type a value in the RecursionLimit box.
3
Click Save.

If you manually edit the instrumentation.config file, use the following syntax to specify the recursion limit.

RecursionLimit = 5;

Setting the Request Remote Invocation Limit

The RemoteInvocationLimit determines the maximum number of calls that the Java EE agent follows from a single method to a remote system. Beyond this number, the Java EE agent only collects and aggregates overall performance information for the remote system invocations. This is done for two reasons:

The default value is 10. If this limit is exceeded, the Java EE agent logs a WARN message that identifies the method where the remote invocations are taking place.

If you are receiving WARN log messages and you require more detail on the remote invocations, you can increase this setting.

Decrease this value if you are receiving the WARN log messages, but the Nexus is exhibiting symptoms of excessive memory use.

1
Click the Requests tab of the Edit dialog box.
2
Type a value in the RemoteInvocationLimit box.
3
Click Save.

If you manually edit the instrumentation.config file, use the following syntax to specify the remote invocation limit.

RemoteInvocationLimit = 50;

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating